اصول
چگونه میسازیم.
عاملهای هوش مصنوعی میتوانند کد را بهسرعت تولید کنند، اما سرعتِ بدون انضباط فقط باگها را سریعتر منتشر میکند. اینها کفهای غیرقابلمذاکرهای هستند که هر پروژه را به آنها پایبند میکنیم — همان کفهایی که مهارتهای متنباز ما رمزگذاری میکنند تا عاملها بهطور پیشفرض از آنها پیروی کنند.
استانداردها بر حسّوحال
یک اصل تنها زمانی بهحساب میآید که یک ماشین بتواند آن را بررسی کند. هر کف در زیر به یک دروازهٔ مشخص در ابزارهای ما نگاشته میشود — یک آزمون، یک قاعدهٔ بازبینی، یک محصولِ الزامی — تا «انجامشده» اثبات شود نه ادعا. این همان چیزی است که مهارتهای مهندسی ما در پروژه نصب میکنند، و پژوهش ما پیوسته آن را تیزتر میکند.
کفهای غیرقابلمذاکره
امنیت سمت سرور تصمیمگیری میشود
احراز هویت و اجازهدهی سمت سرور اعمال میشوند، هرگز در سمت کلاینت. اسرار هرگز به بستهٔ مرورگر نمیرسند. بررسی در رابط کاربری تجربهٔ کاربری است — تصمیم واقعی جایی رخ میدهد که درخواست فرود میآید، در برابر یک هویت تأییدشده.
آزمونها رفتار را اثبات میکنند
یک آزمون آنچه را نرمافزار انجام میدهد تأیید میکند — محتوا، حالت، تعامل، مسیرهای خطا و خالی — نه صرفاً اینکه رندر شد. پوششی که هنگام شکستنِ رفتار شکست نمیخورد پوشش نیست. دروازههای کیفیت یک ادغام را همانطور مسدود میکنند که یک بیلد شکسته میکند.
هر تغییر رد ممیزی بهجا میگذارد
هیچ کاری انجامشده نیست تا ثبت شود: چه چیزی تغییر کرد، چرا، چه تصمیمی گرفته شد و چه رد شد. آرشیو بخشی از تحویل است نه کاغذبازیِ پس از آن — تا استدلال پس از جلسهای که آن را تولید کرده باقی بماند.
هویت اول میآید
هر پروژه با IAM مستحکم آغاز میشود: هویت یک ایمیل نیست، دسترسی رابطهمحور و بهطور پیشفرض چنداجارهای است، و بدونرمز هدف است. اجازهدهی از روز اول ریزدانه است، نه چیزی که پس از یک نفوذ چسبانده شود.
بهطور پیشفرض باز
ابزارهای ما متنباز و یافتههای ما عمومیاند. اگر چیزی مهم باشد، میتوانید آن را بخوانید، اجرا کنید، فورک کنید و بر آن بسازید. قابلیت بازتولید هدف است — نتیجهای که نتوانید بازتولید کنید یک نظر است.
تحویل بده، انباشته نکن
با ساختن و تحویلدادن پژوهش میکنیم؛ آزمایشگاه و محصولات یکدیگر را تغذیه میکنند. هدف تبدیل راه درست به راه آسان است — ابزارهایی که استاندارد را نصب میکنند، آن را بهروز نگه میدارند، و از سر راه توسعهدهنده کنار میروند.
کفها را در کد ببینید.
اصول بالا بهشکل مهارتهای مهندسی قابلنصب برای Claude Code رمزگذاری شدهاند — و منبع همه روی GitHub است.