HUMAN-INTENT.md

المشكلة

لنكن صادقين: لم نعد نريد قراءة الكود. لا نريد التحقق من كل ما يفعله الوكلاء، ولا حفظ كل تفصيلة تقنية في المشروع.

لكن إن لم يتحكم أحد في الوكلاء، فسيحوّلون أي مشروع إلى فوضى يستحيل صيانتها، لا يستطيع إنسان ولا وكيل فكّ خيوطها. إنها مسألة وقت فحسب.

الفكرة

HUMAN-INTENT.md ملف واحد في جذر المستودع. يحمل قصدك: بنية المشروع، وقواعد التطوير، وقرارات المنتج.

إنه ليس توثيقًا للكود، بل القانون الذي يجب أن يخضع له الكود.

القواعد

• تكتبه أنت — وأنت وحدك

  لا يحرر الوكلاء هذا الملف أبدًا. كل سطر فيه قرار اتخذه إنسان.

• تعليماته قانون للوكيل

  ما ينص عليه HUMAN-INTENT.md يعلو على كل شيء آخر. إذا خالف الكود الملف، فالخطأ في الكود.

• يحدد البنية والقواعد والمنتج

  القصد، لا الوصفات. الوكيل يعرف كل الأنماط مسبقًا؛ مهمتك أن تثبّت ما يجب أن يكون صحيحًا — ولماذا.

لماذا ينجح هذا

لا يمكن مجاراة الوكلاء: الكود يتزايد أكثر مما يرغب أحد في قراءته. السيطرة على كل سطر ميؤوس منها، أما السيطرة على القصد فممكنة.

يرفع HUMAN-INTENT.md السيطرة مستوى أعلى: تراقب ملفًا واحدًا يحوي قراراتك بدل آلاف الأسطر من الكود. وما دام الملف قانونًا، يتطور المشروع وفق قصدك — حتى لو لم يقرأ أحد الكود.

كيف تبدأ

1. أنشئ HUMAN-INTENT.md في جذر المستودع.
2. دوّن القرارات التي اتخذتها بالفعل: البنية، وقواعد التطوير، والمنتج.
3. اطلب من وكيلك قراءة الملف واعتباره قانونًا — وأشر إليه من AGENTS.md أو CLAUDE.md.
4. كلما اتخذت قرارًا جديدًا، أضفه إلى الملف. لا تسمح أبدًا لوكيل بالكتابة فيه.
5. راجع هذا الملف، لا الكود.