@tera-system/core 0.2.15 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/MANIFEST.json +5 -5
  2. package/README.md +3 -3
  3. package/RELEASES.md +318 -308
  4. package/agents/application-blueprint.md +4 -4
  5. package/agents/domain-expert-agent.md +3 -3
  6. package/agents/domain-research-agent.md +4 -4
  7. package/agents/engineering-agent-typescript.md +1 -1
  8. package/agents/production-erp-expert.md +2 -2
  9. package/agents/red-team-agent.md +1 -1
  10. package/agents/tera-client-engagement.md +1 -1
  11. package/agents/tera-system-evolution.md +2 -1
  12. package/agents/tera.md +1 -0
  13. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
  14. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
  15. package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
  16. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
  17. package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
  18. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
  19. package/core/tera-system/TeraCapabilityMap.md +327 -0
  20. package/core/tera-system/TeraHelperAgents.md +13 -10
  21. package/core/tera-system/TeraPolicyMap.md +2 -1
  22. package/core/tera-system/TeraPreExecutionGate.md +1 -1
  23. package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
  24. package/core/tera-system/TeraSubAgents.md +312 -868
  25. package/core/tera-system/TeraTokenPolicy.md +1 -1
  26. package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
  27. package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
  28. package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
  29. package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
  30. package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
  31. package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
  32. package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
  33. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
  34. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
  35. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
  36. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
  37. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
  38. package/package.json +1 -1
@@ -1,165 +1,165 @@
1
- # TeraSubAgents.md
2
-
3
- # سجل العملاء الفرعيين لمنظومة Tera Agent
4
-
5
- ## 1. هدف الملف
6
-
7
- هذا الملف يعرّف العملاء الفرعيين الذين يستطيع **Tera Agent** استخدامها في إدارة المشاريع البرمجية.
8
-
9
- الملف يعمل كـ **سجل مركزي / Registry**، وليس كبديل عن ملفات مستقلة لكل عميل فرعي.
10
-
11
- يوضح الملف:
12
-
13
- - من هم العملاء الفرعيون المتاحون.
14
- - متى يستخدم Tera Agent كل عميل.
15
- - ماذا يقرأ كل عميل.
16
- - ماذا ينتج كل عميل.
17
- - ما حدوده.
18
- - ما الملفات التي يساهم فيها.
19
- - كيف يسلّم النتيجة إلى Tera Agent.
20
-
21
- القاعدة الأساسية:
22
-
23
- > **مالك التفعيل حسب المرحلة (SCP-2026-07-28-118):**
24
- > - **Phases 1–4 (Preparation):** مُهندس (ApplicationBlueprintAgent) هو المالك الوحيد للقرار. العملاء الفرعيون للتحضير منفذون متخصصون.
25
- > - **Phases 5–7 (Execution):** TeraAgent هو المالك الوحيد للقرار. العملاء الفرعيون للتنفيذ منفذون متخصصون.
26
-
27
- تمييز التفويض:
28
-
29
- | المرحلة | نوع التفويض | نوع المهمة |
30
- |---|---|---|
31
- | Phase 4 | Preparation Delegation | `TASK-PREP-*` لإنشاء أو مراجعة ملفات التحضير فقط |
32
- | Phase 6 | Implementation Delegation | `TASK-COD-*` لتنفيذ كود التطبيق فقط |
33
-
34
- لا يجوز لأي عميل فرعي أن يتعامل مع تفويض Phase 4 كتنفيذ للتطبيق، ولا يجوز لعميل Phase 6 أن يفتح نطاق تحضيري أو ينشئ عملاء آخرين.
35
-
36
- ---
37
-
38
- ## 2. علاقة هذا الملف بباقي ملفات تيرا
39
-
40
- | الملف | الوظيفة |
41
- |---|---|
42
- | `.opencode/agents/tera.md` | يعرّف شخصية تيرا ودوره وطريقة إدارته للمشروع |
43
- | `Tera_Project_Preparation_Files.md` | يعرّف ملفات المشروع الممكن إنشاؤها |
44
- | `TERA_PROJECT_DECISION.md` | قرار تيرا الأولي للمشروع — المرحلة 2 من 7 |
45
- | `TeraSubAgents.md` | يعرّف العملاء الفرعيين الذين يستطيع تيرا استخدامها |
46
- | `AGENT_ACTIVATION_MATRIX.md` | يحدد متى يُفعّل كل عميل بناءً على Trigger واضح |
47
- | `AGENT_PERMISSION_MODEL.md` | يحدد مستويات الصلاحيات لكل عميل ويصنّف صلاحيته الافتراضية |
48
- | `TOOLING_AND_MCP_POLICY.md` | يحدد سياسة استخدام الأدوات و MCPs المسموحة والمؤجلة |
49
- | `TeraTokenPolicy.md` | يحدد سياسة السياق والتوكنز التي يجب أن يلتزم بها كل عميل |
50
- | `TeraPreExecutionGate.md` | يحدد بوابة المراجعة الإلزامية قبل تفويض أي مهمة تنفيذية |
51
- | `project-control/PROJECT_STATE.md` | الذاكرة المختصرة التي يقرأها العملاء عند الحاجة بدل إعادة قراءة كل الملفات |
52
-
53
- ---
54
-
55
- ## 3. قواعد تشغيل العملاء الفرعيين
56
-
57
- ### 3.1 تيرا هو صاحب القرار
58
-
59
- - لا يوجد عميل فرعي يعتمد نتيجة نهائية بنفسه.
60
- - لا يوجد عميل فرعي يغيّر النطاق.
61
- - لا يوجد عميل فرعي يضيف موديولات أو مزايا من تلقاء نفسه.
62
- - لا يوجد عميل فرعي يقرر إنشاء ملف جديد دون موافقة تيرا.
63
- - كل مخرج يعود إلى Tera Agent للمراجعة والاعتماد.
64
- - العميل الفرعي يسلم النتيجة فقط، ولا يملك صلاحية قبول المهمة أو إغلاقها أو تجاوز مراجعة ما بعد التنفيذ.
65
-
66
- ### 3.2 لا يوجد تواصل مباشر بين العملاء الفرعيين
67
-
68
- المسار الصحيح دائمًا:
69
-
70
- ```text
71
- Tera Agent → Sub-Agent → Tera Agent → Sub-Agent آخر عند الحاجة
72
- ```
73
-
74
- ### 3.2.1 لا يملك العميل الفرعي إدارة عملاء آخرين
75
-
76
- القاعدة العامة:
77
-
78
- ```text
79
- Sub-agents must not create, activate, modify, or delegate to other sub-agents unless Tera explicitly assigns that as part of a system-level task.
80
- ```
81
-
82
- هذا يعني:
83
-
84
- - العميل الفرعي لا ينشئ Agent جديدًا من تلقاء نفسه.
85
- - لا يفعّل Agent داخل `.opencode/agents/`.
86
- - لا يعدّل تعريف Agent آخر.
87
- - لا يوزع العمل على Agent آخر مباشرة.
88
- - إذا ظهرت حاجة إلى تخصص إضافي أو مراجعة مستقلة، يرفع ذلك إلى Tera، وTera وحده يقرر.
89
-
90
- **الاستثناءات — TCEA + ApplicationBlueprintAgent ↔ DomainResearchAgent + DomainExpertAgent + ProductionERPExpert:**
91
-
92
- ```text
93
- TCEA (مستشار) و ApplicationBlueprintAgent (مهندس) يملكان صلاحية استدعاء
94
- DomainResearchAgent و DomainExpertAgent و ProductionERPExpert مباشرة — دون المرور بـ Tera Agent —
95
- لاستخدام متخصص لمعلومات المجال.
96
-
97
- TCEA ← Consulting Mode (أثناء Discovery)
98
- مهندس ← Software Mode (أثناء Blueprinting)
99
- ```
100
-
101
- **عند الاستدعاء من TCEA (مستشار):**
102
-
103
- ```text
104
- TCEA (مستشار) يملك صلاحية استدعاء DomainResearchAgent و DomainExpertAgent و ProductionERPExpert مباشرة —
105
- دون المرور بـ Tera Agent — للاستفادة من بحث وتحليل متخصص بمجال العميل
106
- أثناء Discovery أو عند اقتراح Value-Added Proposals.
107
-
108
- الشروط:
109
- 1. DomainResearchAgent: بحث ويب موجه → ينتج Domain Research Report
110
- 2. DomainExpertAgent: تحليل المعرفة → ينتج Domain Intelligence Report
111
- 3. ProductionERPExpert: تحليل إنتاج/تصنيع ERP متخصص → ينتج Production ERP Analysis / Discovery Questions / Blueprint Review عند وجود Production trigger
112
- 4. المخرجات تحمل وسم [Research Hint] أو Source Discipline labels — لا تدخل النطاق دون تأكيد Majed
113
- 5. TCEA لا يدير أي من العملاء — يستدعيهم ويستلم النتيجة فقط
114
- 6. كل استدعاء يُسجل في CLIENT_DECISION_LOG.md
115
- 7. لا يجوز لـ TCEA استدعاء أي عميل فرعي آخر
116
- ```
117
-
118
- **عند الاستدعاء من ApplicationBlueprintAgent (مهندس):**
119
-
120
- ```text
121
- مهندس (ApplicationBlueprintAgent) يملك صلاحية استدعاء DomainResearchAgent و DomainExpertAgent و ProductionERPExpert
122
- مباشرة — دون المرور بـ Tera Agent — لتعميق فهم المجال أثناء إنتاج APPLICATION_BLUEPRINT.md.
123
-
124
- الشروط:
125
- 1. الوضع: Software Mode تلقائياً
126
- 2. DomainResearchAgent: بحث ويب موجه → Domain Research Report
127
- 3. DomainExpertAgent: تحليل وتحويل → Domain Intelligence Report (بتصنيف MVP)
128
- 4. ProductionERPExpert: مراجعة وتحليل Production ERP عند وجود تصنيع/إنتاج → Manufacturing Blueprint Review / Open Questions / Risks
129
- 5. المخرجات تحمل وسم [Research Hint] أو Source Discipline labels — لا تدخل blueprint دون تأكيد Majed
130
- 6. الكتابة في project-preparation/ فقط
131
- 7. مهندس لا يدير أي من العملاء — يستدعيهم ويستلم النتيجة فقط
132
- 8. كل استدعاء يُسجل في BLUEPRINT_DECISION_CANDIDATES.md أو BLUEPRINT_OPEN_QUESTIONS.md
133
- 9. لا يجوز لمهندس استدعاء أي عميل فرعي آخر
134
- ```
135
-
136
- **استثناء Auditor — Tera + Monitor:**
137
-
138
- ```text
139
- Auditor (مُدقق) هو عميل جودة فرعي، وليس عميلاً رئيسياً مستقلاً في التشغيل الطبيعي.
140
-
141
- المستدعون المصرح لهم في v1:
142
- 1. TeraAgent — بعد مهام التنفيذ وفق قرار Auditor Review Decision.
143
- 2. Monitor — فقط عندما يطلب Majed من Monitor تحدي أو التحقق من عمل Tera بجودة مستقلة.
144
-
145
- الشروط:
146
- 1. التفويض يجب أن يكون مرتبطاً بمهمة/دفعة محددة.
147
- 2. المراجعة Diff-first وليست فحصاً مفتوحاً للمشروع كله.
148
- 3. Auditor يكتب فقط تقارير Markdown داخل `project-control/audit-reports/` إذا كان ذلك ضمن Allowed Write Targets.
149
- 4. Auditor لا يطلب من EngineeringAgent أو أي عميل آخر تنفيذ إصلاحات مباشرة.
150
- 5. findings لا تصبح أوامر تنفيذ إلا بعد تحويلها إلى Tasks/Issues بواسطة Tera أو Monitor أو Majed.
151
- 6. لا يجوز لأي عميل رئيسي آخر استدعاء Auditor دون SCP لاحق.
152
- ```
153
-
154
- ### 3.2.2 Model Capability Gate لا يستبدل العملاء المختصين
155
-
156
- `Model Capability Gate` is a Tera-side assessment only.
157
-
1
+ # TeraSubAgents.md
2
+
3
+ # سجل العملاء الفرعيين لمنظومة Tera Agent
4
+
5
+ ## 1. هدف الملف
6
+
7
+ هذا الملف يعرّف العملاء الفرعيين الذين يستطيع **Tera Agent** استخدامها في إدارة المشاريع البرمجية.
8
+
9
+ الملف يعمل كـ **سجل مركزي / Registry**، وليس كبديل عن ملفات مستقلة لكل عميل فرعي.
10
+
11
+ يوضح الملف:
12
+
13
+ - من هم العملاء الفرعيون المتاحون.
14
+ - متى يستخدم Tera Agent كل عميل.
15
+ - ماذا يقرأ كل عميل.
16
+ - ماذا ينتج كل عميل.
17
+ - ما حدوده.
18
+ - ما الملفات التي يساهم فيها.
19
+ - كيف يسلّم النتيجة إلى Tera Agent.
20
+
21
+ القاعدة الأساسية:
22
+
23
+ > **مالك التفعيل حسب المرحلة (SCP-2026-07-28-118):**
24
+ > - **Phases 1–4 (Preparation):** مُهندس (ApplicationBlueprintAgent) هو المالك الوحيد للقرار. العملاء الفرعيون للتحضير منفذون متخصصون.
25
+ > - **Phases 5–7 (Execution):** TeraAgent هو المالك الوحيد للقرار. العملاء الفرعيون للتنفيذ منفذون متخصصون.
26
+
27
+ تمييز التفويض:
28
+
29
+ | المرحلة | نوع التفويض | نوع المهمة |
30
+ |---|---|---|
31
+ | Phase 4 | Preparation Delegation | `TASK-PREP-*` لإنشاء أو مراجعة ملفات التحضير فقط |
32
+ | Phase 6 | Implementation Delegation | `TASK-COD-*` لتنفيذ كود التطبيق فقط |
33
+
34
+ لا يجوز لأي عميل فرعي أن يتعامل مع تفويض Phase 4 كتنفيذ للتطبيق، ولا يجوز لعميل Phase 6 أن يفتح نطاق تحضيري أو ينشئ عملاء آخرين.
35
+
36
+ ---
37
+
38
+ ## 2. علاقة هذا الملف بباقي ملفات تيرا
39
+
40
+ | الملف | الوظيفة |
41
+ |---|---|
42
+ | `.opencode/agents/tera.md` | يعرّف شخصية تيرا ودوره وطريقة إدارته للمشروع |
43
+ | `Tera_Project_Preparation_Files.md` | يعرّف ملفات المشروع الممكن إنشاؤها |
44
+ | `TERA_PROJECT_DECISION.md` | قرار تيرا الأولي للمشروع — المرحلة 2 من 7 |
45
+ | `TeraSubAgents.md` | يعرّف العملاء الفرعيين الذين يستطيع تيرا استخدامها |
46
+ | `AGENT_ACTIVATION_MATRIX.md` | يحدد متى يُفعّل كل عميل بناءً على Trigger واضح |
47
+ | `AGENT_PERMISSION_MODEL.md` | يحدد مستويات الصلاحيات لكل عميل ويصنّف صلاحيته الافتراضية |
48
+ | `TOOLING_AND_MCP_POLICY.md` | يحدد سياسة استخدام الأدوات و MCPs المسموحة والمؤجلة |
49
+ | `TeraTokenPolicy.md` | يحدد سياسة السياق والتوكنز التي يجب أن يلتزم بها كل عميل |
50
+ | `TeraPreExecutionGate.md` | يحدد بوابة المراجعة الإلزامية قبل تفويض أي مهمة تنفيذية |
51
+ | `project-control/PROJECT_STATE.md` | الذاكرة المختصرة التي يقرأها العملاء عند الحاجة بدل إعادة قراءة كل الملفات |
52
+
53
+ ---
54
+
55
+ ## 3. قواعد تشغيل العملاء الفرعيين
56
+
57
+ ### 3.1 تيرا هو صاحب القرار
58
+
59
+ - لا يوجد عميل فرعي يعتمد نتيجة نهائية بنفسه.
60
+ - لا يوجد عميل فرعي يغيّر النطاق.
61
+ - لا يوجد عميل فرعي يضيف موديولات أو مزايا من تلقاء نفسه.
62
+ - لا يوجد عميل فرعي يقرر إنشاء ملف جديد دون موافقة تيرا.
63
+ - كل مخرج يعود إلى Tera Agent للمراجعة والاعتماد.
64
+ - العميل الفرعي يسلم النتيجة فقط، ولا يملك صلاحية قبول المهمة أو إغلاقها أو تجاوز مراجعة ما بعد التنفيذ.
65
+
66
+ ### 3.2 لا يوجد تواصل مباشر بين العملاء الفرعيين
67
+
68
+ المسار الصحيح دائمًا:
69
+
70
+ ```text
71
+ Tera Agent → Sub-Agent → Tera Agent → Sub-Agent آخر عند الحاجة
72
+ ```
73
+
74
+ ### 3.2.1 لا يملك العميل الفرعي إدارة عملاء آخرين
75
+
76
+ القاعدة العامة:
77
+
78
+ ```text
79
+ Sub-agents must not create, activate, modify, or delegate to other sub-agents unless Tera explicitly assigns that as part of a system-level task.
80
+ ```
81
+
82
+ هذا يعني:
83
+
84
+ - العميل الفرعي لا ينشئ Agent جديدًا من تلقاء نفسه.
85
+ - لا يفعّل Agent داخل `.opencode/agents/`.
86
+ - لا يعدّل تعريف Agent آخر.
87
+ - لا يوزع العمل على Agent آخر مباشرة.
88
+ - إذا ظهرت حاجة إلى تخصص إضافي أو مراجعة مستقلة، يرفع ذلك إلى Tera، وTera وحده يقرر.
89
+
90
+ **الاستثناءات — TCEA + ApplicationBlueprintAgent ↔ DomainResearchAgent + DomainExpertAgent + ProductionERPExpert:**
91
+
92
+ ```text
93
+ TCEA (مستشار) و ApplicationBlueprintAgent (مهندس) يملكان صلاحية استدعاء
94
+ DomainResearchAgent و DomainExpertAgent و ProductionERPExpert مباشرة — دون المرور بـ Tera Agent —
95
+ لاستخدام متخصص لمعلومات المجال.
96
+
97
+ TCEA ← Consulting Mode (أثناء Discovery)
98
+ مهندس ← Software Mode (أثناء Blueprinting)
99
+ ```
100
+
101
+ **عند الاستدعاء من TCEA (مستشار):**
102
+
103
+ ```text
104
+ TCEA (مستشار) يملك صلاحية استدعاء DomainResearchAgent و DomainExpertAgent و ProductionERPExpert مباشرة —
105
+ دون المرور بـ Tera Agent — للاستفادة من بحث وتحليل متخصص بمجال العميل
106
+ أثناء Discovery أو عند اقتراح Value-Added Proposals.
107
+
108
+ الشروط:
109
+ 1. DomainResearchAgent: بحث ويب موجه → ينتج Domain Research Report
110
+ 2. DomainExpertAgent: تحليل المعرفة → ينتج Domain Intelligence Report
111
+ 3. ProductionERPExpert: تحليل إنتاج/تصنيع ERP متخصص → ينتج Production ERP Analysis / Discovery Questions / Blueprint Review عند وجود Production trigger
112
+ 4. المخرجات تحمل وسم [Research Hint] أو Source Discipline labels — لا تدخل النطاق دون تأكيد Majed
113
+ 5. TCEA لا يدير أي من العملاء — يستدعيهم ويستلم النتيجة فقط
114
+ 6. كل استدعاء يُسجل في CLIENT_DECISION_LOG.md
115
+ 7. لا يجوز لـ TCEA استدعاء أي عميل فرعي آخر
116
+ ```
117
+
118
+ **عند الاستدعاء من ApplicationBlueprintAgent (مهندس):**
119
+
120
+ ```text
121
+ مهندس (ApplicationBlueprintAgent) يملك صلاحية استدعاء DomainResearchAgent و DomainExpertAgent و ProductionERPExpert
122
+ مباشرة — دون المرور بـ Tera Agent — لتعميق فهم المجال أثناء إنتاج APPLICATION_BLUEPRINT.md.
123
+
124
+ الشروط:
125
+ 1. الوضع: Software Mode تلقائياً
126
+ 2. DomainResearchAgent: بحث ويب موجه → Domain Research Report
127
+ 3. DomainExpertAgent: تحليل وتحويل → Domain Intelligence Report (بتصنيف MVP)
128
+ 4. ProductionERPExpert: مراجعة وتحليل Production ERP عند وجود تصنيع/إنتاج → Manufacturing Blueprint Review / Open Questions / Risks
129
+ 5. المخرجات تحمل وسم [Research Hint] أو Source Discipline labels — لا تدخل blueprint دون تأكيد Majed
130
+ 6. الكتابة في project-preparation/ فقط
131
+ 7. مهندس لا يدير أي من العملاء — يستدعيهم ويستلم النتيجة فقط
132
+ 8. كل استدعاء يُسجل في BLUEPRINT_DECISION_CANDIDATES.md أو BLUEPRINT_OPEN_QUESTIONS.md
133
+ 9. لا يجوز لمهندس استدعاء أي عميل فرعي آخر
134
+ ```
135
+
136
+ **استثناء Auditor — Tera + Monitor:**
137
+
138
+ ```text
139
+ Auditor (مُدقق) هو عميل جودة فرعي، وليس عميلاً رئيسياً مستقلاً في التشغيل الطبيعي.
140
+
141
+ المستدعون المصرح لهم في v1:
142
+ 1. TeraAgent — بعد مهام التنفيذ وفق قرار Auditor Review Decision.
143
+ 2. Monitor — فقط عندما يطلب Majed من Monitor تحدي أو التحقق من عمل Tera بجودة مستقلة.
144
+
145
+ الشروط:
146
+ 1. التفويض يجب أن يكون مرتبطاً بمهمة/دفعة محددة.
147
+ 2. المراجعة Diff-first وليست فحصاً مفتوحاً للمشروع كله.
148
+ 3. Auditor يكتب فقط تقارير Markdown داخل `project-control/audit-reports/` إذا كان ذلك ضمن Allowed Write Targets.
149
+ 4. Auditor لا يطلب من EngineeringAgent أو أي عميل آخر تنفيذ إصلاحات مباشرة.
150
+ 5. findings لا تصبح أوامر تنفيذ إلا بعد تحويلها إلى Tasks/Issues بواسطة Tera أو Monitor أو Majed.
151
+ 6. لا يجوز لأي عميل رئيسي آخر استدعاء Auditor دون SCP لاحق.
152
+ ```
153
+
154
+ ### 3.2.2 Model Capability Gate لا يستبدل العملاء المختصين
155
+
156
+ `Model Capability Gate` is a Tera-side assessment only.
157
+
158
158
  It does not replace:
159
159
 
160
- - `SoftwareDesignerAgent`
160
+ - `tera-software-designer`
161
161
  - `SecurityAgent`
162
- - `QAAndAcceptanceAgent`
162
+ - `qa-agent`
163
163
  - `ProjectControlAgent`
164
164
  - `Post-Execution Review Gate`
165
165
 
@@ -181,744 +181,188 @@ It does not replace:
181
181
  - **المخرجات:** `security-reports/` في نفس المستودع خارج مجلد التطبيق.
182
182
  - **التفويض:** لا هجوم بلا `00_AUTHORIZATION.md` مكتمل (نطاق + بيئة + حدود + مؤشرات إيقاف).
183
183
  - **الأدلة:** لا PASS بلا Request/Response فعلي أو Artifact موثق — غياب الثغرة من Scanner ليس نجاحاً.
184
- - **قرار التسليم:** القاضي وحده يصدر قرار بوابة الأمن — بعد Red Team + Observer + Fixes + Retest.
185
-
186
- Its role is to help Tera decide whether the current model is sufficient, sufficient with safeguards, needs escalation, or whether the task should be split first.
187
-
188
- ### 3.3 ملفات المشروع هي مصدر الحقيقة
189
-
190
- لا تعتمد القرارات على المحادثة فقط، بل على الملفات الرسمية مثل:
191
-
192
- ```text
193
- 00_PROJECT_INPUTS.md
194
- PROJECT_RULES.md عند وجوده
195
- TERA_PROJECT_DECISION.md
196
- 01_PROJECT_BRIEF.md
197
- 02_SCOPE_AND_BOUNDARIES.md
198
- 03_MODULES_AND_FEATURES.md
199
- ...
200
- ```
201
-
202
- ### 3.3.1 Technology Profile Rule
203
-
204
- When a task depends on stack-specific execution rules, Tera must provide the active
205
- Technology Profile as part of the official context.
206
-
207
- Sub-agents must not assume one default technology stack.
208
-
209
- Project-specific implementation agents may be generated using the active Technology Profile,
210
- but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutral.
211
-
212
- ### 3.4 مالك واحد لكل ملف
213
-
214
- كل ملف له مالك كتابة أساسي واحد. بقية العملاء يستطيعون القراءة أو تقديم ملاحظات، لكن لا يكتبون مباشرة في ملف لا يملكونه.
215
-
216
- ### 3.5 حوكمة التفعيل والصلاحيات والأدوات
217
-
218
- كل عميل فرعي في هذه المنظومة يخضع لثلاثة ملفات حوكمة:
219
-
220
- | الملف | ماذا يحدد؟ |
221
- |---|---|
222
- | `AGENT_ACTIVATION_MATRIX.md` | متى يُفعّل العميل، وما Trigger التفعيل، ومتى لا يُفعّل |
223
- | `AGENT_PERMISSION_MODEL.md` | ما صلاحية العميل الافتراضية، وهل يمكن رفعها أو خفضها |
224
- | `TOOLING_AND_MCP_POLICY.md` | ما الأدوات و MCPs المسموحة للعميل، وما قواعد استخدامها |
225
-
226
- **لا يتم تفعيل أي عميل دون Trigger واضح.**
227
- **لا يملك أي عميل صلاحية أعلى من المسموح له بها.**
228
- **لا يستخدم أي عميل أداة أو MCP دون سياسة محددة.**
229
-
230
- ### 3.6 قواعد التواصل والتفاعل
231
-
232
- - التواصل المباشر بين العملاء الفرعيين **ممنوع**.
233
- - التفاعل المسموح به هو:
234
- ```text
235
- Sub-Agent → Tera → Official Files → Tera → Sub-Agent
236
- ```
237
- - العميل لا يخاطب عميلًا آخر مباشرة، ولا يفوّضه، ولا يعدّل تعريفه.
238
- - إذا احتاج العميل إلى نتيجة من عميل آخر، يرفع الطلب إلى Tera.
239
- - Tera هو المنسق الوحيد والموزع الوحيد للمهام.
240
- - الاستثناء الوحيد في v1: Monitor يستطيع استدعاء Auditor فقط عندما يطلب Majed ذلك صراحة للتحقق من عمل Tera.
241
- - أي خرق لقاعدة التواصل المباشر يُسجل كـ `Issue` ويُرفع إلى Tera فورًا.
242
-
243
- ---
244
-
245
- ## 4. نموذج تعريف العميل الفرعي
246
-
247
- يُعرّف كل عميل فرعي بهذه الصيغة:
248
-
249
- ```text
250
- اسم العميل:
251
- المعرّف:
252
- الفئة: أساسي / مشروط
253
- الدور:
254
- متى يستدعيه تيرا:
255
- المدخلات المطلوبة:
256
- الملفات التي يقرأها:
257
- المخرجات المطلوبة:
258
- الملفات التي يكتب أو يساهم فيها:
259
- ما لا يجب عليه فعله:
260
- معايير قبول مخرجاته:
261
- يعتمد على:
262
- يسلّم إلى:
263
- ```
264
-
265
- لا حاجة إلى شخصية طويلة أو قصة خلفية. المهم هو العقد التشغيلي: متى يعمل، ماذا يستلم، ماذا ينتج، وما حدوده.
266
-
267
- ---
268
-
269
- # 5. العملاء الأساسيون
270
-
271
- هؤلاء هم العملاء الذين قد يحتاجهم أغلب المشاريع، لكن تيرا يقرر استخدامهم حسب حجم التطبيق وحاجته.
272
-
273
- ---
274
-
275
- ## 5.1 RequirementsScopeAgent
276
-
277
- | البند | القيمة |
278
- |---|---|
279
- | اسم العميل | Requirements & Scope Agent |
280
- | المعرّف | `REQ_SCOPE_AGENT` |
281
- | الفئة | أساسي |
282
- | الدور | تحليل الفكرة، تثبيت الفهم، تحديد النطاق والحدود |
283
-
284
- ### متى يستدعيه تيرا؟
285
-
286
- - بعد قراءة `00_PROJECT_INPUTS.md`.
287
- - بعد إنشاء أو تحديث `TERA_PROJECT_DECISION.md`.
288
- - عند وجود متطلبات غير واضحة.
289
- - عند ظهور طلب تغيير يؤثر على النطاق.
290
-
291
- ### يقرأ
292
-
293
- ```text
294
- 00_PROJECT_INPUTS.md
295
- TERA_PROJECT_DECISION.md
296
- ```
297
-
298
- ### ينتج أو يساهم في
299
-
300
- ```text
301
- 01_PROJECT_BRIEF.md
302
- 02_SCOPE_AND_BOUNDARIES.md
303
- 04_USERS_ROLES_PERMISSIONS.md عند الحاجة
304
- ```
305
-
306
- ### حدوده
307
-
308
- - لا يختار تقنيات.
309
- - لا يصمم قاعدة البيانات.
310
- - لا يصمم الشاشات.
311
- - لا يضيف مزايا غير مذكورة.
312
- - لا يقرر النطاق النهائي دون اعتماد تيرا.
313
-
314
- ### معايير القبول
315
-
316
- - الفكرة مفهومة ومختصرة.
317
- - النطاق يحتوي ما هو داخل وما هو خارج.
318
- - لا توجد عبارات عامة غير قابلة للتنفيذ.
319
- - المتطلبات الغامضة موثقة كمعلومات ناقصة.
320
-
321
- ---
322
-
323
- ## 5.2 BusinessWorkflowAgent
324
-
325
- | البند | القيمة |
326
- |---|---|
327
- | اسم العميل | Business Workflow Agent |
328
- | المعرّف | `BUSINESS_WORKFLOW_AGENT` |
329
- | الفئة | أساسي |
330
- | الدور | تحويل المتطلبات إلى مسارات عمل ومراحل وحالات تشغيلية |
331
-
332
- ### متى يستدعيه تيرا؟
333
-
334
- - بعد اعتماد `01_PROJECT_BRIEF.md`.
335
- - بعد تثبيت `02_SCOPE_AND_BOUNDARIES.md`.
336
- - عندما يحتوي التطبيق على دورات عمل أو موافقات أو حالات.
337
-
338
- ### يقرأ
339
-
340
- ```text
341
- 01_PROJECT_BRIEF.md
342
- 02_SCOPE_AND_BOUNDARIES.md
343
- 04_USERS_ROLES_PERMISSIONS.md
344
- ```
345
-
346
- ### ينتج أو يساهم في
347
-
348
- ```text
349
- 05_BUSINESS_WORKFLOWS.md
350
- 12_BUSINESS_RULES.md عند الحاجة
351
- ```
352
-
353
- ### حدوده
354
-
355
- - لا يضيف متطلبات جديدة.
356
- - لا يصمم شاشات.
357
- - لا يكتب كود.
358
- - لا يغير النطاق.
359
- - لا يقرر صلاحيات تقنية.
360
-
361
- ### معايير القبول
362
-
363
- - كل مسار عمل له بداية ونهاية.
364
- - كل خطوة مرتبطة بدور مستخدم.
365
- - الحالات والانتقالات واضحة.
366
- - الاستثناءات المهمة موثقة.
367
-
368
- ---
369
-
370
- ## 5.3 UIUXStructureAgent
371
-
372
- | البند | القيمة |
373
- |---|---|
374
- | اسم العميل | UI/UX Structure Agent |
375
- | المعرّف | `UI_UX_STRUCTURE_AGENT` |
376
- | الفئة | أساسي |
377
- | الدور | تحديد هيكل الشاشات، التنقل، ومحتوى الواجهة وظيفيًا، والتنبيه إلى الحاجة لدليل UI عند وجود مصدر تصميم. لا يملك القرار البصري النهائي. |
378
-
379
- ### متى يستدعيه تيرا؟
380
-
381
- - بعد اعتماد الموديولات ومسارات العمل.
382
- - عندما يحتاج المشروع إلى شاشات واضحة قبل التنفيذ.
383
- - عندما تكون تجربة الاستخدام مؤثرة على نجاح المشروع.
384
- - عندما يقدم المستخدم ألوانًا، CSS، getdesign.md، screenshots، أو مرجعًا بصريًا.
385
-
386
- ### يقرأ
387
-
388
- ```text
389
- 01_PROJECT_BRIEF.md
390
- 02_SCOPE_AND_BOUNDARIES.md
391
- 03_MODULES_AND_FEATURES.md
392
- 04_USERS_ROLES_PERMISSIONS.md
393
- 05_BUSINESS_WORKFLOWS.md
394
- 06_DATA_MODEL_PREPARATION.md عند الحاجة
395
- 28_UI_UX_GUIDELINES.md كمصدر قراءة أو مساهمة هيكلية فقط عند الحاجة
396
- project-preparation/design-source/ عند توفيره من Tera
397
- ```
398
-
399
- ### ينتج أو يساهم في
400
-
401
- ```text
402
- 07_SCREENS_AND_UI_STRUCTURE.md
403
- 28_UI_UX_GUIDELINES.md عند الحاجة
404
- ```
405
-
406
- ### حدوده
407
-
408
- - لا يكتب Frontend code.
409
- - لا يختار Framework.
410
- - لا يضيف شاشة خارج النطاق.
411
- - لا يغير قواعد العمل.
412
- - لا يحسم قرارات تقنية.
413
- - لا يخترع ستايل بصري نهائي دون اعتماد مصدر التصميم من Tera.
414
- - لا يحل محل `UIVisualDesignerAgent` في Design Tokens أو Component Rules أو Layout Rules البصرية.
415
-
416
- ### معايير القبول
417
-
418
- - كل شاشة لها وظيفة واضحة.
419
- - كل شاشة مرتبطة بموديول أو مسار عمل.
420
- - الحقول والإجراءات الرئيسية مذكورة.
421
- - حالات الخطأ والفراغ مذكورة عند الحاجة.
422
-
423
- ---
424
-
425
- ## 5.3.1 UIVisualDesignerAgent
426
-
427
- | البند | القيمة |
428
- |---|---|
429
- | اسم العميل | UI Visual Designer Agent |
430
- | المعرّف | `UI_VISUAL_DESIGNER_AGENT` |
431
- | الفئة | أساسي عند وجود واجهات مهمة / مشروط للمشاريع البسيطة |
432
- | ملف العميل | `.opencode/agents/ui-designer.md` |
433
- | الدور | تحويل مصدر التصميم إلى Design Tokens وComponent Rules وLayout Rules وقواعد تنفيذ بصرية داخل `28_UI_UX_GUIDELINES.md` |
434
-
435
- ### الفرق بينه وبين UIUXStructureAgent
436
-
437
- | العميل | المسؤولية |
438
- |---|---|
439
- | `UIUXStructureAgent` | هيكل الشاشات، التنقل، تجربة الاستخدام، محتوى الشاشة وظيفيًا |
440
- | `UIVisualDesignerAgent` | الستايل، Design Tokens، Component Rules، Layout Rules، RTL/LTR visual behavior، والمراجعة البصرية |
441
-
442
- > **التعريف الكامل:** `.opencode/agents/ui-designer.md` — يحتوي جميع التفاصيل التشغيلية، حدود الصلاحيات، سير العمل، ومعايير القبول.
443
-
444
- ---
445
-
446
- ## 5.4 DataDesignAgent
447
-
448
- | البند | القيمة |
449
- |---|---|
450
- | اسم العميل | Data Design Agent |
451
- | المعرّف | `DATA_DESIGN_AGENT` |
452
- | الفئة | أساسي |
453
- | الدور | تحليل البيانات والكيانات والعلاقات المطلوبة للمشروع |
454
-
455
- ### متى يستدعيه تيرا؟
456
-
457
- - بعد وضوح الموديولات والعمليات.
458
- - عندما يكون للتطبيق بيانات مترابطة.
459
- - قبل التصميم الفني النهائي لقاعدة البيانات.
460
-
461
- ### يقرأ
462
-
463
- ```text
464
- 01_PROJECT_BRIEF.md
465
- 02_SCOPE_AND_BOUNDARIES.md
466
- 03_MODULES_AND_FEATURES.md
467
- 04_USERS_ROLES_PERMISSIONS.md
468
- 05_BUSINESS_WORKFLOWS.md
469
- ```
470
-
471
- ### ينتج أو يساهم في
472
-
473
- ```text
474
- 06_DATA_MODEL_PREPARATION.md
475
- 19_DATABASE_DESIGN.md عند الحاجة
476
- 29_SAMPLE_DATA_AND_SEEDING.md عند الحاجة
477
- ```
478
-
479
- ### حدوده
480
-
481
- - لا يكتب Migrations.
482
- - لا يكتب SQL نهائي إلا إذا طلب تيرا ذلك لاحقًا.
483
- - لا يغير النطاق الوظيفي.
484
- - لا يقرر نوع قاعدة البيانات وحده.
485
- - لا يصمم الشاشات.
486
-
487
- ### معايير القبول
488
-
489
- - الكيانات الأساسية واضحة.
490
- - العلاقات بين الكيانات موثقة.
491
- - الحقول المهمة مذكورة.
492
- - لا توجد كيانات مكررة بلا سبب.
493
- - القيود المهمة مذكورة.
494
-
495
- ---
496
-
497
- ## 5.5 SolutionArchitectureAgent
498
-
499
- | البند | القيمة |
500
- |---|---|
501
- | اسم العميل | Solution Architecture Agent |
502
- | المعرّف | `SOLUTION_ARCH_AGENT` |
503
- | الفئة | أساسي |
504
- | الدور | تحديد البنية التقنية العامة للمشروع |
505
-
506
- ### متى يستدعيه تيرا؟
507
-
508
- - بعد وضوح النطاق والموديولات.
509
- - عند وجود قرارات تقنية مؤثرة.
510
- - قبل بدء التنفيذ الفعلي.
511
-
512
- ### يقرأ
513
-
514
- ```text
515
- 00_PROJECT_INPUTS.md
516
- 01_PROJECT_BRIEF.md
517
- 02_SCOPE_AND_BOUNDARIES.md
518
- 03_MODULES_AND_FEATURES.md
519
- 05_BUSINESS_WORKFLOWS.md
520
- 06_DATA_MODEL_PREPARATION.md
521
- 07_SCREENS_AND_UI_STRUCTURE.md
522
- ```
523
-
524
- ### ينتج أو يساهم في
525
-
526
- ```text
527
- 08_TECHNICAL_ARCHITECTURE.md
528
- 20_API_CONTRACTS.md عند الحاجة
529
- 22_DEPLOYMENT_AND_ENVIRONMENTS.md عند الحاجة
530
- 32_PERFORMANCE_REQUIREMENTS.md عند الحاجة
531
- ```
532
-
533
- ### حدوده
534
-
535
- - لا يكتب الكود.
536
- - لا يغير المتطلبات.
537
- - لا يعيد تصميم الموديولات.
538
- - لا يتجاهل القيود التقنية الموجودة في المدخلات.
539
- - لا يحسم قرارات أمنية متخصصة إذا كان SecurityAgent مطلوبًا.
540
-
541
- ### معايير القبول
542
-
543
- - التقنية المقترحة متسقة مع المدخلات.
544
- - طبقات التطبيق واضحة.
545
- - قواعد المصادقة والتكامل مذكورة عند الحاجة.
546
- - لا توجد قرارات تقنية بلا سبب.
547
- - المعمارية مناسبة لحجم المشروع.
548
-
549
- ---
550
-
551
- ## 5.6 EngineeringAgent
552
-
553
- | البند | القيمة |
554
- |---|---|
555
- | اسم العميل | Engineering Agent |
556
- | المعرّف | `ENGINEERING_AGENT` |
557
- | الفئة | أساسي |
558
- | ملف العميل | `.opencode/agents/engineering-agent.md` |
559
- | الدور | تنفيذ المهام البرمجية بعد اعتماد التحليل والتصميم |
560
-
561
- ### متى يستدعيه تيرا؟
562
-
563
- - بعد اعتماد ملفات التحليل والتصميم الأساسية.
564
- - عند وجود مهمة برمجية محددة.
565
- - عند الحاجة لتعديل أو إصلاح أو بناء مكون.
566
-
567
- ### يقرأ
568
-
569
- ```text
570
- 03_MODULES_AND_FEATURES.md
571
- 06_DATA_MODEL_PREPARATION.md
572
- 07_SCREENS_AND_UI_STRUCTURE.md
573
- 08_TECHNICAL_ARCHITECTURE.md
574
- 09_IMPLEMENTATION_PLAN.md
575
- 10_TESTING_AND_ACCEPTANCE.md
576
- 28_UI_UX_GUIDELINES.md إلزامي لأي مهمة UI/Frontend ذات ستايل بصري
577
- project-preparation/design-source/DESIGN.md عند الإشارة إليه داخل 28_UI_UX_GUIDELINES.md
578
- أنماط المكونات المنفذة سابقًا عند تحديدها في المهمة
579
- tera-system/design-system/ كمرجع fallback يحدده Tera فقط
580
- ```
581
-
582
- ### ينتج أو يساهم في
583
-
584
- - الكود.
585
- - تعديلات المستودع.
586
- - ملاحظات التنفيذ.
587
- - تحديثات محدودة على ملفات التنفيذ إذا طلب تيرا.
588
-
589
- > **التعريف الكامل:** `.opencode/agents/engineering-agent.md` — يحتوي جميع التفاصيل التشغيلية، حدود الصلاحيات، سير العمل، ومعايير القبول.
590
-
591
- ---
592
-
593
- ## 5.6.1 EngineeringAgentTypeScript 🆕
594
-
595
- | البند | القيمة |
596
- |:------|:-------|
597
- | اسم العميل | TypeScript Engineering Agent |
598
- | المعرّف | `ENGINEERING_AGENT_TS` |
599
- | الفئة | أساسي — متخصص |
600
- | ملف العميل | `.opencode/agents/engineering-agent-typescript.md` |
601
- | الدور | تنفيذ كود TypeScript الوظيفي: Node.js backend (Express/Fastify)، React functional components (مع hooks + state + API)، Zustand stores، TanStack Query، shared types/Zod، React↔Phaser integration bridge |
602
-
603
- ### متى يستدعيه Tera؟
604
-
605
- - عند وجود مهمة TypeScript/Node.js مع `Pre-Execution Gate: PASS`.
606
- - عند وجود مهمة React functional components مع `Pre-Execution Gate: PASS`.
607
- - عند الحاجة لتعديل bridge بين React و Phaser.
608
- - **يُفضّل على EngineeringAgent العام** لمشاريع TypeScript.
609
-
610
- ### يقرأ
611
-
612
- ```text
613
- engineering-agent-core.md
614
- Active Technology Profile (framework rules)
615
- 28_UI_UX_GUIDELINES.md (لمهام React)
616
- UI Specification من ui-designer (component contracts)
617
- Task file + Allowed Write Targets
618
- ```
619
-
620
- ### ينتج أو يساهم في
621
-
622
- - كود TypeScript/Node.js backend.
623
- - كود React functional components.
624
- - Zustand stores + TanStack Query hooks.
625
- - Shared types + Zod schemas.
626
- - React↔Phaser bridge code.
627
- - Save/Load APIs.
628
-
629
- ### حدوده
630
-
631
- - لا ينفذ CSS/Tailwind/تصميماً بصرياً — هذا لـ ui-designer.
632
- - لا ينفذ presentational components بسيطة.
633
- - لا ينفذ كود Phaser game engine.
634
- - لا ينفذ مهاماً حساسة (Auth, Payment, Secrets) دون Security Review.
635
- - لا يدّعي تغطية كل TypeScript Web Ecosystem تلقائياً — يعمل عبر Technology Profile.
636
- - لا يقرر نطاق المشروع أو أسلوبه المعماري.
637
-
638
- ### معايير القبول
639
-
640
- - الكود متوافق مع Technology Profile و UI Spec.
641
- - SEMGREP_SANITY_CHECK: PASS.
642
- - PLAYWRIGHT_UI_CHECK منفذ لمهام UI.
643
- - Security Review Gate لم يتم تفعيلها أو تم تجاوزها.
644
- - Bridge code (إن وجد) متوافق مع واجهة Phaser agent.
645
-
646
- ---
647
-
648
- ## 5.6.2 EngineeringAgentPhaser 🆕
649
-
650
- | البند | القيمة |
651
- |:------|:-------|
652
- | اسم العميل | Phaser Engineering Agent |
653
- | المعرّف | `ENGINEERING_AGENT_PHASER` |
654
- | الفئة | أساسي — متخصص |
655
- | ملف العميل | `.opencode/agents/engineering-agent-phaser.md` |
656
- | الدور | تنفيذ كود Phaser 3 Web Games: scenes، entities، tilemaps، sprites، animations، Arcade Physics، game systems. **الإصدار الأول:** Phaser 3 Web Games فقط |
657
-
658
- ### متى يستدعيه Tera؟
659
-
660
- - عند وجود مهمة Phaser 3 game engine مع `Pre-Execution Gate: PASS`.
661
- - عند الحاجة لإنشاء أو تعديل game scenes, entities, systems.
662
- - عند دمج Tilemaps من Tiled Map Editor مع Phaser.
663
-
664
- ### يقرأ
665
-
666
- ```text
667
- engineering-agent-core.md
668
- Active Technology Profile
669
- Game design documents (scene list, entity specs, tilemap references)
670
- Task file + Allowed Write Targets
671
- ```
672
-
673
- ### ينتج أو يساهم في
674
-
675
- - كود Phaser 3 scenes (Boot, Preload, FarmScene).
676
- - كود game entities (Player, Field, Barn, Factory).
677
- - كود game systems (GrowthSystem, ProductionSystem).
678
- - Tilemap integration code.
679
- - Sprites, animations, physics.
680
-
681
- ### حدوده
682
-
683
- - لا ينفذ React components أو backend APIs.
684
- - لا ينفذ CSS أو Tailwind.
685
- - لا يعدّل React↔Phaser bridge — يرفع إلى engineering-agent-typescript عبر Tera.
686
- - لا يصمم Tilemaps (Tiled maps) — يستلمها جاهزة.
687
- - لا يقرر game design decisions — ينفّذ المواصفات فقط.
688
- - لا يدّعي دعم Unity أو Unreal أو Godot.
689
-
690
- ### معايير القبول
691
-
692
- - Scene/entity يعمل بدون أخطاء في المتصفح.
693
- - Tilemap يظهر بشكل صحيح مع الطبقات والأشياء.
694
- - التفاعلات الفيزيائية (collision, overlap) تعمل حسب المواصفات.
695
- - SEMGREP_SANITY_CHECK: PASS.
696
- - Game Preview (Playwright screenshot) مرفق.
697
-
698
- ---
699
-
700
- ## 5.6.3 EngineeringAgentDotNet
701
-
702
- | البند | القيمة |
703
- |:------|:-------|
704
- | اسم العميل | .NET Engineering Agent |
705
- | المعرّف | `ENGINEERING_AGENT_DOTNET` |
706
- | الفئة | أساسي — متخصص |
707
- | ملف العميل | `.opencode/agents/engineering-agent-dotnet.md` |
708
- | الدور | تنفيذ مهام .NET/C#: ASP.NET Core، Blazor، WPF، EF Core، ADO.NET |
709
-
710
- ### متى يستدعيه Tera؟
711
-
712
- - عند وجود مهمة .NET/C# مع `Pre-Execution Gate: PASS`.
713
-
714
- ### يقرأ
715
-
716
- ```text
717
- engineering-agent-core.md
718
- Active .NET Technology Profile
719
- Task file + Allowed Write Targets
720
- ```
721
-
722
- ### ينتج
723
-
724
- - كود .NET/C#.
725
-
726
- ### حدوده
727
-
728
- - لا ينفذ TypeScript أو Phaser أو أي لغة خارج .NET.
729
-
730
- ---
731
-
732
- ## 5.7 QAAndAcceptanceAgent
733
-
734
- | البند | القيمة |
735
- |---|---|
736
- | اسم العميل | QA & Acceptance Agent |
737
- | المعرّف | `QA_ACCEPTANCE_AGENT` |
738
- | الفئة | أساسي |
739
- | ملف العميل | `.opencode/agents/qa-agent.md` |
740
- | الدور | تخطيط + تنفيذ + مراجعة اختبارات — عميل اختبارات كامل يعمل في وضعين |
741
-
742
- ### الوضعين التشغيليين
743
-
744
- | الوضع | الغرض | الصلاحية |
745
- |---|---|---|
746
- | **Planning Mode** | تحديد الاختبارات ومعايير القبول ومراجعة جاهزية المخرجات | `WRITE_DOCS` |
747
- | **Execution Mode** | تشغيل اختبارات CLI فعلياً وإنتاج تقارير نتائج رسمية | `RUN_TESTS` + bash |
748
-
749
- > **التعريف الكامل:** `.opencode/agents/qa-agent.md` — يحتوي جميع التفاصيل التشغيلية، حدود الصلاحيات، سير العمل لكل وضع، نموذج التقرير، ومعايير القبول.
750
-
751
- ---
752
-
753
- ## 5.7.1 Quality Gate Auditor — مُدقق
754
-
755
- | البند | القيمة |
756
- |---|---|
757
- | اسم العميل | Quality Gate Auditor |
758
- | المعرّف | `AUDITOR` |
759
- | الفئة | أساسي / مراجعة جودة بعد التنفيذ |
760
- | ملف العميل | `.opencode/agents/auditor.md` |
761
- | الدور | تدقيق جودة Diff-first بعد التنفيذ: توثيق، نطاق، أدلة، جودة كود، P1/P2 security hygiene، اختبار كفاية أدلة، وfindings قابلة للتنفيذ |
762
-
763
- ### متى يستدعيه Tera؟
764
-
765
- - بعد Post-Execution Review عندما تكون الحالة `AUDITOR_REVIEW_REQUIRED`.
766
- - عند `AUDITOR_REVIEW_RECOMMENDED` إذا رأى Tera أن المخاطر أو الغموض تستحق مراجعة مستقلة.
767
- - عند طلب Majed مراجعة جودة من خلال Tera.
768
-
769
- ### متى يستدعيه Monitor؟
770
-
771
- - فقط عندما يطلب Majed من Monitor التحقق من عمل Tera أو تحديه بجودة مستقلة.
772
-
773
- ### يقرأ
774
-
775
- ```text
776
- project-control/PROJECT_STATE.md
777
- project-control/TASK_REGISTRY.md
778
- project-control/tasks/[TASK-ID].md
779
- project-control/PROJECT_ACTIVITY_LOG.md عند الحاجة
780
- project-control/test-reports/ عند وجود QA evidence
781
- الملفات المعدلة أو diff summary التي يحددها المستدعي
782
- tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md
783
- tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md عند مراجعة code/structure
784
- ```
785
-
786
- ### ينتج
787
-
788
- ```text
789
- project-control/audit-reports/QUAUD-[TASK-ID]-YYYY-MM-DD-NNN.md
790
- ```
791
-
792
- ويعيد نسخة مختصرة للوكيل المستدعي.
793
-
794
- ### حدوده
795
-
796
- - لا يكتب أو يعدّل كود التطبيق.
797
- - لا يشغل اختبارات؛ يقرأ QA evidence فقط.
798
- - لا يقوم بمراجعة بصرية؛ يحيل لـ DesignReviewer عند الحاجة.
799
- - لا يقوم بتحليل أمني عميق؛ يحيل لـ SecurityAgent عند الحاجة.
800
- - لا يقبل المهمة ولا يغلقها.
801
- - لا يحوّل findings إلى Tasks أو Issues بنفسه.
802
- - لا يخترع metrics دون evidence artifact.
803
-
804
- ### معايير القبول
805
-
806
- - التقرير Diff-first ومربوط بمهمة أو دفعة محددة.
807
- - كل finding يحتوي Evidence وSeverity وRecommended Action وRequired Owner.
808
- - يميز بين Changed Code و`BASELINE_DEBT`.
809
- - لا يحتوي أسراراً حقيقية أو بيانات غير منقحة.
810
- - يستخدم STOP / CAUTION / FLAG دون تحويل heuristics إلى blockers تلقائياً.
811
-
812
- ---
184
+ - **قرار التسليم:** القاضي وحده يصدر قرار بوابة الأمن — بعد Red Team + Observer + Fixes + Retest.
813
185
 
814
- ## 5.7.2 DesignReviewer — ناقد (SCP-2026-08-28-001)
186
+ قواعد النزاهة (SCP-2026-09-03-005 — بعد مراجعة خبير خارجي):
815
187
 
816
- | البند | القيمة |
817
- |---|---|
818
- | اسم العميل | Design Reviewer Agent |
819
- | المعرّف | `DESIGN_REVIEWER` |
820
- | الفئة | أساسي / مراجعة بصرية (Tera-managed review sub-agent) |
821
- | ملف العميل | `.opencode/agents/design-reviewer.md` |
822
- | الدور | مراجعة البروتوتايب (TASK-PROTO-*) والواجهات المنفذة مقابل مصدر التصميم المعتمد — حكم مستقل |
188
+ - **عزل Black Box:** Phase A (هجوم عبر URL فقط — ممنوع قراءة كود المصدر تقنياً). Phase B (وصول للكود) تُفتح فقط بعد إغلاق A وحفظ نتائجها. أي اكتشاف تطلب معرفة الكود أثناء Black Box غير صالح.
189
+ - **نزاهة الهدف:** `SECURITY_TARGET_SNAPSHOT.md` قبل/بعد الجولة (Commit SHA + Working Tree + Build + DB seed). تغيّر الهدف أثناء الجولة = الجولة INVALID (قرار القاضي).
190
+ - **نزاهة الأدلة:** `EVIDENCE_MANIFEST.md` (SHA256 لكل ملف + Freeze Timestamp). بعد التجميد: لا تعديل للأدلة الأصلية — الإضافات في `evidence-addendum/` فقط. القاضي يعيد حساب الهاشات.
191
+ - **Surface Reconciliation:** القاضي يبني A∪B∪C (مكتشف الشبح + Runtime من العين + Source-declared من Phase B) — لا يثق بسطح الهجوم وحده، ويكشف الـ endpoints غير المكتشفة.
192
+ - **فصل كتابة صارم:** الشبح لا يكتب `observer/` ولا `audit/` — العين تكتب `observer/` فقط، القاضي يكتب `audit/` فقط.
193
+ - **Retest ثنائي المسار:** Track A (بمعرفة الثغرات — bypass + regression) + Track B (Fresh Attack Clean-Room بلا أي معرفة سابقة) — القاضي يدمج النتيجتين.
823
194
 
824
- ### متى يستدعيه Tera؟
195
+ Its role is to help Tera decide whether the current model is sufficient, sufficient with safeguards, needs escalation, or whether the task should be split first.
825
196
 
826
- - بعد بناء البروتوتايب (`TASK-PROTO-*`) — قبل عرضه على Majed/الزبون (نمط Maker/Checker).
827
- - عند الحاجة لمراجعة بصرية للواجهات المنفذة أثناء التنفيذ (قبل القبول).
197
+ ### 3.3 ملفات المشروع هي مصدر الحقيقة
828
198
 
829
- ### متى يستدعيه Majed مباشرة؟
199
+ لا تعتمد القرارات على المحادثة فقط، بل على الملفات الرسمية مثل:
830
200
 
831
- - في أي وقت (درع الاستدعاء المزدوج) — لا احتكار من Tera.
201
+ ```text
202
+ 00_PROJECT_INPUTS.md
203
+ PROJECT_RULES.md عند وجوده
204
+ TERA_PROJECT_DECISION.md
205
+ 01_PROJECT_BRIEF.md
206
+ 02_SCOPE_AND_BOUNDARIES.md
207
+ 03_MODULES_AND_FEATURES.md
208
+ ...
209
+ ```
832
210
 
833
- ### الدروع الثلاثة (إلزامية)
211
+ ### 3.3.1 Technology Profile Rule
834
212
 
835
- - 🛡️ **درع الحياد**: قاعدة Reviewer Invocation Neutrality — ممنوع تلقين النتائج المتوقعة.
836
- - 🛡️ **درع التصعيد**: يرفع نتائجه إلى Majed مباشرة دون تحرير من Tera.
837
- - 🛡️ **درع الاستدعاء**: Majed يستدعيه مباشرة في أي وقت.
213
+ When a task depends on stack-specific execution rules, Tera must provide the active
214
+ Technology Profile as part of the official context.
838
215
 
839
- ### يقرأ
216
+ Sub-agents must not assume one default technology stack.
840
217
 
841
- ```text
842
- project-control/prototypes/ (البروتوتايب المبني)
843
- project-preparation/07_SCREENS_AND_UI_STRUCTURE.md
844
- project-preparation/28_UI_UX_GUIDELINES.md
845
- project-preparation/design-source/ عند وجوده
846
- tera-system/design-system/DESIGN_REVIEW_STANDARDS.md (يُقرأ قبل كل مراجعة)
847
- ```
218
+ Project-specific implementation agents may be generated using the active Technology Profile,
219
+ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutral.
220
+
221
+ ### 3.4 مالك واحد لكل ملف
222
+
223
+ كل ملف له مالك كتابة أساسي واحد. بقية العملاء يستطيعون القراءة أو تقديم ملاحظات، لكن لا يكتبون مباشرة في ملف لا يملكونه.
224
+
225
+ ### 3.5 حوكمة التفعيل والصلاحيات والأدوات
226
+
227
+ كل عميل فرعي في هذه المنظومة يخضع لثلاثة ملفات حوكمة:
848
228
 
849
- ### ينتج
229
+ | الملف | ماذا يحدد؟ |
230
+ |---|---|
231
+ | `AGENT_ACTIVATION_MATRIX.md` | متى يُفعّل العميل، وما Trigger التفعيل، ومتى لا يُفعّل |
232
+ | `AGENT_PERMISSION_MODEL.md` | ما صلاحية العميل الافتراضية، وهل يمكن رفعها أو خفضها |
233
+ | `TOOLING_AND_MCP_POLICY.md` | ما الأدوات و MCPs المسموحة للعميل، وما قواعد استخدامها |
234
+
235
+ **لا يتم تفعيل أي عميل دون Trigger واضح.**
236
+ **لا يملك أي عميل صلاحية أعلى من المسموح له بها.**
237
+ **لا يستخدم أي عميل أداة أو MCP دون سياسة محددة.**
238
+
239
+ ### 3.6 قواعد التواصل والتفاعل
240
+
241
+ - التواصل المباشر بين العملاء الفرعيين **ممنوع**.
242
+ - التفاعل المسموح به هو:
243
+ ```text
244
+ Sub-Agent → Tera → Official Files → Tera → Sub-Agent
245
+ ```
246
+ - العميل لا يخاطب عميلًا آخر مباشرة، ولا يفوّضه، ولا يعدّل تعريفه.
247
+ - إذا احتاج العميل إلى نتيجة من عميل آخر، يرفع الطلب إلى Tera.
248
+ - Tera هو المنسق الوحيد والموزع الوحيد للمهام.
249
+ - الاستثناء الوحيد في v1: Monitor يستطيع استدعاء Auditor فقط عندما يطلب Majed ذلك صراحة للتحقق من عمل Tera.
250
+ - أي خرق لقاعدة التواصل المباشر يُسجل كـ `Issue` ويُرفع إلى Tera فورًا.
251
+
252
+ ---
253
+
254
+ ## 4. نموذج تعريف العميل الفرعي
255
+
256
+ يُعرّف كل عميل فرعي بهذه الصيغة:
850
257
 
851
258
  ```text
852
- تقرير مراجعة تصميم/بروتوتايب مستقل إلى Majed (PASS / REVISION / BLOCKED)
259
+ اسم العميل:
260
+ المعرّف:
261
+ الفئة: أساسي / مشروط
262
+ الدور:
263
+ متى يستدعيه تيرا:
264
+ المدخلات المطلوبة:
265
+ الملفات التي يقرأها:
266
+ المخرجات المطلوبة:
267
+ الملفات التي يكتب أو يساهم فيها:
268
+ ما لا يجب عليه فعله:
269
+ معايير قبول مخرجاته:
270
+ يعتمد على:
271
+ يسلّم إلى:
853
272
  ```
854
273
 
855
- ### حدوده
856
-
857
- - لا يبني البروتوتايب — البناء حصراً Coding Agents تحت Tera.
858
- - لا يكتب أو يعدّل كود التطبيق ولا التصميم.
859
- - لا يقبل المهمة ولا يغلقها — يوصي فقط.
860
- - لا يحل محل Monitor (الرقابة على الخطط) ولا Auditor (الجودة الهندسية).
274
+ لا حاجة إلى شخصية طويلة أو قصة خلفية. المهم هو العقد التشغيلي: متى يعمل، ماذا يستلم، ماذا ينتج، وما حدوده.
861
275
 
862
276
  ---
863
277
 
864
- ## 5.8 DocumentationHandoverAgent
278
+ # 5. العملاء الأساسيون — السجل الرسمي (23 عميلاً)
865
279
 
866
- | البند | القيمة |
867
- |---|---|
868
- | اسم العميل | Documentation & Handover Agent |
869
- | المعرّف | `DOC_HANDOVER_AGENT` |
870
- | الفئة | أساسي |
871
- | الدور | تجهيز مستندات التسليم والتشغيل والاستخدام وPhase 7 handover/closure documentation |
280
+ > **مصدر الحقيقة:** `.opencode/agents/` — 23 ملفاً نشطاً بالأسماء الحديثة. هذا القسم **سجل مرجعي موجز**؛ التفاصيل التشغيلية الكاملة لكل عميل في ملفه الخاص.
281
+ > **التصنيف الرسمي:** 6 Coding + 3 Quality + 2 Management + 4 Engagement + 2 Research + 1 Knowledge + 1 Specialist + 1 System + 3 Security = **23 عميلاً**.
872
282
 
873
- ### متى يستدعيه تيرا؟
283
+ ---
874
284
 
875
- - عند قرب التسليم.
876
- - في Phase 7 — Delivery, Handover & Closure.
877
- - عند الحاجة لتجهيز دليل استخدام.
878
- - عند وجود عميل خارجي.
879
- - بعد اعتماد الاختبارات الأساسية.
285
+ ## 5.0 التصنيف الرسمي للعملاء
880
286
 
881
- ### يقرأ
287
+ | الفئة | العدد | العملاء |
288
+ |:------|:-----:|:--------|
289
+ | **Coding Agents** — يكتبون كوداً | 6 | engineering-agent, engineering-agent-dotnet, engineering-agent-typescript, engineering-agent-phaser, ui-designer, tera-software-designer |
290
+ | **Quality Agents** — جودة | 3 | auditor, qa-agent, design-reviewer |
291
+ | **Management** — إدارة | 2 | tera (TeraAgent), monitor |
292
+ | **Engagement** — عملاء خارجيون | 4 | tera-client-engagement, tera-business-transformation-consultant, application-blueprint, tera-strategic-advisor |
293
+ | **Research** — بحث | 2 | domain-research-agent, domain-expert-agent |
294
+ | **Knowledge** — معرفة | 1 | project-knowledge-agent |
295
+ | **Specialist** — تخصص | 1 | production-erp-expert |
296
+ | **System** — منظومة | 1 | tera-system-evolution |
297
+ | **Security** — فريق الحماية | 3 | red-team-agent, security-observer, security-auditor |
882
298
 
883
- ```text
884
- 01_PROJECT_BRIEF.md
885
- 03_MODULES_AND_FEATURES.md
886
- 07_SCREENS_AND_UI_STRUCTURE.md
887
- 08_TECHNICAL_ARCHITECTURE.md
888
- 10_TESTING_AND_ACCEPTANCE.md
889
- ```
299
+ ---
890
300
 
891
- ### ينتج أو يساهم في
301
+ ## 5.1 السجل المرجعي الموجز
302
+
303
+ | العميل (الملف) | الدور المختصر | الفئة |
304
+ |:--------------|:-------------|:------|
305
+ | `tera.md` | Engineering Delivery Lead (Phases 5–7) | Management |
306
+ | `monitor.md` | مراقبة الامتثال (رقيب) | Management |
307
+ | `engineering-agent.md` | منفذ عام (Fallback) | Coding |
308
+ | `engineering-agent-dotnet.md` | .NET/C# (Blazor, WPF, EF Core) | Coding |
309
+ | `engineering-agent-typescript.md` | TypeScript/Node.js/React (وظيفي) | Coding |
310
+ | `engineering-agent-phaser.md` | Phaser 3 Web Games | Coding |
311
+ | `ui-designer.md` | تصميم بصري UI/UX | Coding |
312
+ | `tera-software-designer.md` | تصميم تقني / Technical Specs | Coding |
313
+ | `auditor.md` | تدقيق جودة Diff-first (مُدقق) | Quality |
314
+ | `qa-agent.md` | اختبارات CLI (تخطيط + تنفيذ) | Quality |
315
+ | `design-reviewer.md` | مراجعة بصرية (ناقد) | Quality |
316
+ | `tera-client-engagement.md` | دورة حياة الزبون (TCEA) | Engagement |
317
+ | `tera-business-transformation-consultant.md` | تحول مؤسسي (Track C) | Engagement |
318
+ | `application-blueprint.md` | مهندس الحل (Phases 1–4, SCP-118) | Engagement |
319
+ | `tera-strategic-advisor.md` | استشارة استراتيجية (Majed فقط) | Engagement |
320
+ | `domain-research-agent.md` | بحث ويب موجه | Research |
321
+ | `domain-expert-agent.md` | تحليل معرفي وتحويل | Research |
322
+ | `project-knowledge-agent.md` | معرفة تشغيلية مختصرة | Knowledge |
323
+ | `production-erp-expert.md` | خبير ERP إنتاجي/تصنيعي | Specialist |
324
+ | `tera-system-evolution.md` | حارس المنظومة (تطوير Tera) | System |
325
+ | `red-team-agent.md` | الشبح — هجومي (Phase 7 gate) | Security |
326
+ | `security-observer.md` | العين — مراقب متزامن | Security |
327
+ | `security-auditor.md` | القاضي — تدقيق + قرار البوابة | Security |
892
328
 
893
- ```text
894
- 11_DELIVERY_AND_HANDOVER.md
895
- 30_USER_MANUAL_DRAFT.md عند الحاجة
896
- 31_MAINTENANCE_AND_SUPPORT.md عند الحاجة
897
- project-control/RELEASE_NOTES.md في Phase 7
898
- project-control/POST_IMPLEMENTATION_REVIEW.md في Phase 7
899
- project-control/PROJECT_CLOSURE_REPORT.md في Phase 7
900
- clients/CLIENT-*/applications/APP-*/delivery/CLIENT_HANDOVER_PACKAGE.md لمشاريع العملاء
901
- ```
329
+ ---
902
330
 
903
- قواعد إضافية:
331
+ ## 5.2 قواعد التشغيل (خلاصة)
904
332
 
905
- - يستخدم هذا العميل بعد اجتياز `Handoff Readiness Gate` عندما يكون المطلوب handoff أو release أو دليل تشغيل/استخدام رسمي.
906
- - `Handoff Readiness Gate` ليس مطلوبًا لتسليمات المهام الداخلية العادية (`task handbacks`)، بل فقط عند تقييم جاهزية مرحلة أو Release أو حزمة توثيق/تسليم.
907
- - في Phase 7 لا يكتب كودًا ولا يقرر إغلاق المشروع؛ يجهز الوثائق فقط وتيرا يقرر.
333
+ - **مالك التفعيل حسب المرحلة (SCP-118):** Phases 1–4 → `application-blueprint` (مهندس الحل)؛ Phases 5–7 → `tera.md` (TeraAgent).
334
+ - **لا تواصل مباشر بين العملاء.** الاستثناءات: Monitor→Auditor بطلب Majed؛ TCEA/Blueprint→Domain/ERP (بحث فقط).
335
+ - **لا تفعيل دون Trigger واضح** — `AGENT_ACTIVATION_MATRIX.md`.
336
+ - **الصلاحيات** — `AGENT_PERMISSION_MODEL.md`.
337
+ - **العملاء المشروطون/المساعدون** (Integration, DevOps, Performance, Compliance, SecurityAgent/الدرع...) في `TeraHelperAgents.md`.
908
338
 
909
- ### حدوده
339
+ ---
910
340
 
911
- - لا يقرر قبول التسليم وحده.
912
- - لا يغير وظائف التطبيق.
913
- - لا يضيف تعليمات غير مطابقة للتطبيق.
914
- - لا يخفي ملاحظات أو قيود تشغيلية.
915
- - لا يقرر أن المرحلة أصبحت handoff-ready من تلقاء نفسه؛ Tera وحده يشغل البوابة ويقرر.
341
+ ## 5.9 الأدوار التحضيرية (Preparation Roles — مملوكة لـ application-blueprint)
916
342
 
917
- ### معايير القبول
343
+ > **التصحيح المعياري (SCP-2026-09-04-001):** الأدوار التالية **ليست عملاءً ثابتين** — كانت "عملاء أساسيين" في البنية القديمة لـ §5، وبعد SCP-118 أصبحت **أدواراً تحضيرية** يملكها `application-blueprint` (مهندس الحل) ويؤديها عبر `TASK-PREP-*` أو عبر عملاء مساعدين مُولَّدين عند الحاجة وفق `AGENT_GENERATION_TEMPLATE.md`.
918
344
 
919
- - خطوات التشغيل واضحة.
920
- - عناصر التسليم محددة.
921
- - ملاحظات الدعم والصيانة مذكورة عند الحاجة.
922
- - دليل المستخدم مختصر ومطابق للشاشات الفعلية.
345
+ | الدور القديم | المسؤولية | المالك الحالي |
346
+ |:------------|:-----------|:--------------|
347
+ | RequirementsScopeAgent | تحليل المتطلبات وتثبيت النطاق | `application-blueprint` (عبر `TASK-PREP-*`) |
348
+ | BusinessWorkflowAgent | مسارات العمل والحالات الانتقالية | `application-blueprint` |
349
+ | UIUXStructureAgent | هيكل الشاشات والتنقل وظيفياً | `application-blueprint` + `ui-designer` (بصري) |
350
+ | UIVisualDesignerAgent | Design Tokens / Component Rules / Layout | `ui-designer` (ملف فعلي) |
351
+ | DataDesignAgent | نموذج البيانات والعلاقات | `application-blueprint` + `tera-software-designer` (تقني) |
352
+ | SolutionArchitectureAgent | البنية التقنية والقرارات المعمارية | `application-blueprint` + `tera-software-designer` (مهام) |
353
+ | DocumentationHandoverAgent | توثيق التسليم (Phase 7) | `tera.md` + `engineering-agent-typescript` (مستندات تقنية) — لا عميل مستقل |
923
354
 
924
- ---
355
+ **القاعدة:** لا يجوز التعامل مع أي من هذه الأدوار كعميل ثابت مستقل — تُنفَّذ مسؤوليتها عبر مالكها الحالي أو عبر عميل مساعد مُولَّد بموافقة (وفق `AGENT_GENERATION_TEMPLATE.md`).
356
+
357
+ ---
358
+
359
+ ## 5.10 العلاقة مع الملفات الأخرى
360
+
361
+ | الملف | الوظيفة |
362
+ |:------|:--------|
363
+ | `.opencode/agents/*.md` | التعريفات التشغيلية الكاملة (23 عميلاً) |
364
+ | `AGENT_DEPENDENCY_MAP.md` | التبعيات والترتيب الآمن للتعديل |
365
+ | `AGENT_ACTIVATION_MATRIX.md` | متى يُفعَّل كل عميل |
366
+ | `AGENT_PERMISSION_MODEL.md` | الصلاحيات الافتراضية لكل عميل |
367
+ | `TeraHelperAgents.md` | العملاء المشروطون/المساعدون (مثل الدرع) |
368
+ | `GENERATED_AGENTS_MANIFEST.md` | سجل التوليد والتفعيل |