HUMAN-INTENT.md

مسئله

بیایید صادق باشیم: دیگر نمی‌خواهیم کد بخوانیم. نمی‌خواهیم هر کاری را که عامل‌ها می‌کنند وارسی کنیم، و نمی‌خواهیم هر جزئیات فنی پروژه را در ذهن نگه داریم.

اما اگر کسی عامل‌ها را کنترل نکند، هر پروژه‌ای را به آشوبی غیرقابل نگهداری تبدیل می‌کنند که نه انسان از پس آن برمی‌آید و نه عامل. فقط مسئلهٔ زمان است.

ایده

HUMAN-INTENT.md یک فایل در ریشهٔ مخزن شماست. نیت شما در آن ثبت می‌شود: معماری پروژه، قواعد توسعه و تصمیم‌های محصول.

این مستندات کد نیست؛ قانونی است که کد باید از آن پیروی کند.

قوانین

• شما آن را می‌نویسید — و فقط شما

  عامل‌ها هرگز این فایل را ویرایش نمی‌کنند. هر سطر آن تصمیمی است که یک انسان گرفته است.

• دستورهای آن برای عامل قانون است

  آنچه در HUMAN-INTENT.md نوشته شده بر همه چیز مقدم است. اگر کد با فایل در تضاد باشد، کد اشتباه است.

• معماری، قواعد و محصول را تعیین می‌کند

  نیت، نه دستورالعمل. عامل همهٔ الگوها را از قبل می‌شناسد؛ کار شما این است که تعیین کنید چه چیزی باید برقرار باشد — و چرا.

چرا جواب می‌دهد

همگام شدن با عامل‌ها ممکن نیست: کد بیش از آن تولید می‌شود که کسی بخواهد بخواند. کنترل هر سطر بی‌فایده است؛ اما کنترل نیت ممکن است.

HUMAN-INTENT.md کنترل را یک سطح بالاتر می‌برد: به‌جای هزاران سطر کد، تنها یک فایل حاوی تصمیم‌های خود را می‌پایید. تا وقتی این فایل قانون است، پروژه بر اساس نیت شما پیش می‌رود — حتی اگر هیچ‌کس کد را نخواند.

چگونه شروع کنیم

1. HUMAN-INTENT.md را در ریشهٔ مخزن خود بسازید.
2. تصمیم‌هایی را که قبلاً گرفته‌اید بنویسید: معماری، قواعد توسعه، محصول.
3. به عامل خود بگویید این فایل را بخواند و آن را قانون بداند — از AGENTS.md یا CLAUDE.md به آن ارجاع دهید.
4. هر تصمیم تازه را به فایل اضافه کنید. هرگز اجازه ندهید عاملی در آن بنویسد.
5. این فایل را بازبینی کنید، نه کد را.