@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,289 +1,287 @@
1
- # AGENT_ACTIVATION_MATRIX.md
2
-
3
- # مصفوفة تفعيل العملاء الفرعيين — Sub-Agent Activation Matrix
4
-
5
- هذا الملف يحدد **متى يتم تفعيل كل عميل فرعي** في منظومة Tera، ومتى **لا** يتم تفعيله.
6
-
7
- ---
8
-
9
- ## القاعدة الحاكمة
10
-
11
- > **لا يتم تفعيل العميل لأنه موجود، بل لأنه مطلوب بسبب Trigger واضح.**
12
-
13
- **مالك التفعيل حسب المرحلة (SCP-2026-07-28-118):**
14
- - **Phases 1–4 (Preparation):** مُهندس (ApplicationBlueprintAgent) هو المسؤول عن تفعيل عملاء التحضير والبحث.
15
- - **Phases 5–7 (Execution):** TeraAgent هو المسؤول عن تفعيل عملاء التنفيذ والتدقيق.
16
- - العميل لا يُفعّل نفسه ولا يُفعّل عملاء آخرين.
17
-
1
+ # AGENT_ACTIVATION_MATRIX.md
2
+
3
+ # مصفوفة تفعيل العملاء الفرعيين — Sub-Agent Activation Matrix
4
+
5
+ هذا الملف يحدد **متى يتم تفعيل كل عميل فرعي** في منظومة Tera، ومتى **لا** يتم تفعيله.
6
+
7
+ ---
8
+
9
+ ## القاعدة الحاكمة
10
+
11
+ > **لا يتم تفعيل العميل لأنه موجود، بل لأنه مطلوب بسبب Trigger واضح.**
12
+
13
+ **مالك التفعيل حسب المرحلة (SCP-2026-07-28-118):**
14
+ - **Phases 1–4 (Preparation):** مُهندس (ApplicationBlueprintAgent) هو المسؤول عن تفعيل عملاء التحضير والبحث.
15
+ - **Phases 5–7 (Execution):** TeraAgent هو المسؤول عن تفعيل عملاء التنفيذ والتدقيق.
16
+ - العميل لا يُفعّل نفسه ولا يُفعّل عملاء آخرين.
17
+
18
18
  استثناء محدود: `Monitor` يستطيع استدعاء `Auditor` فقط عندما يطلب Majed من Monitor مراجعة/تحدي عمل Tera بجودة مستقلة.
19
-
20
- ---
21
-
22
- ## 1. أنواع Triggers
23
-
24
- | نوع Trigger | وصف | مثال |
25
- |---|---|---|
26
- | `PHASE_GATE` | بداية مرحلة معينة | Phase 4 → Preparation, Phase 6 → Implementation |
27
- | `DOCUMENT_READY` | وجود ملف معين جاهز | `03_MODULES_AND_FEATURES.md` معتمد → DataDesignAgent |
28
- | `DECISION_MADE` | قرار من Tera أو المستخدم | "نحتاج تكامل API خارجي" → IntegrationAgent |
29
- | `COMPLEXITY_SIGNAL` | مؤشر تعقيد | حجم بيانات كبير → PerformanceAgent |
30
- | `RISK_SIGNAL` | مؤشر خطر | بيانات حساسة → SecurityAgent |
31
- | `USER_REQUEST` | طلب مباشر من المستخدم | "أضف Domain Research" → DomainResearchAgent |
32
- | `EXTERNAL_FACTOR` | عامل خارجي | مشروع عميل خارجي → Client Engagement Agents |
19
+
20
+ > **المرجع المعياري (SCP-2026-09-04-001):** العملاء الرسميون هم **23 عميلاً** بالأسماء الحديثة في `.opencode/agents/` (راجع `TeraSubAgents.md` §5). الأسماء القديمة (RequirementsScopeAgent, BusinessWorkflowAgent, DataDesignAgent, SolutionArchitectureAgent, UIUXStructureAgent, UIVisualDesignerAgent, QAAndAcceptanceAgent, EngineeringAgentTypeScript...) استُبدلت بأسمائها الفعلية أو انتقلت إلى **Preparation Roles** (أدوار تحضيرية يملكها application-blueprint).
21
+
22
+ ---
23
+
24
+ ## 1. أنواع Triggers
25
+
26
+ | نوع Trigger | وصف | مثال |
27
+ |---|---|---|
28
+ | `PHASE_GATE` | بداية مرحلة معينة | Phase 4 → Preparation, Phase 6 → Implementation |
29
+ | `DOCUMENT_READY` | وجود ملف معين جاهز | `03_MODULES_AND_FEATURES.md` معتمد → تطبيق الأدوار التحضيرية (يملكها application-blueprint) |
30
+ | `DECISION_MADE` | قرار من Tera أو المستخدم | "نحتاج تكامل API خارجي" → IntegrationAgent |
31
+ | `COMPLEXITY_SIGNAL` | مؤشر تعقيد | حجم بيانات كبير → PerformanceAgent |
32
+ | `RISK_SIGNAL` | مؤشر خطر | بيانات حساسة → SecurityAgent (الدرع) |
33
+ | `USER_REQUEST` | طلب مباشر من المستخدم | "أضف Domain Research" → DomainResearchAgent |
34
+ | `EXTERNAL_FACTOR` | عامل خارجي | مشروع عميل خارجي → Client Engagement Agents |
33
35
  | `REVIEW_NEEDED` | حاجة مراجعة | بعد عدة مهام تنفيذية → QualityReviewCoordinatorAgent |
34
36
  | `TASK_COMPLETED` | اكتمال مهمة تنفيذية تحتاج مراجعة بعد التنفيذ | TASK-COD حساس اكتمل → Auditor |
35
37
  | `QUALITY_SIGNAL` | ظهور مؤشر جودة أو أثر معماري يحتاج تدقيق | تعقيد/اختبارات ناقصة/تضخم diff → Auditor |
36
- | `PHASE_7_GATE` | بداية Phase 7 | QAAndAcceptanceAgent + DocumentationHandoverAgent |
37
-
38
- ---
39
-
40
- ## 2. مصفوفة التفعيل حسب العميل
41
-
42
- ### 2.1 العملاء الأساسيون
43
-
44
- | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
45
- |---|---|---|---|---|---|
46
- | RequirementsScopeAgent | `REQ_SCOPE_AGENT` | `DOCUMENT_READY`: بعد `TERA_PROJECT_DECISION.md` أو `00_PROJECT_INPUTS.md` | 2–3 | إذا كانت الفكرة بسيطة وواضحة بالكامل ويمكن لـ Tera كتابة `01_PROJECT_BRIEF.md` مباشرة | `00_PROJECT_INPUTS.md` أو `TERA_PROJECT_DECISION.md` |
47
- | BusinessWorkflowAgent | `BUSINESS_WORKFLOW_AGENT` | `DOCUMENT_READY`: بعد اعتماد `01_PROJECT_BRIEF.md` + `02_SCOPE_AND_BOUNDARIES.md` + وجود workflows | 3–4 | إذا كان التطبيق لا يحتوي أي دورة عمل أو حالات (مثل CRUD بسيط بدون موافقات) | `01_PROJECT_BRIEF.md` + `02_SCOPE_AND_BOUNDARIES.md` |
48
- | UIUXStructureAgent | `UI_UX_STRUCTURE_AGENT` | `DOCUMENT_READY`: بعد اعتماد الموديولات ومسارات العمل | 4 | إذا كان المشروع API-only أو Backend-only بدون واجهة مستخدم | `03_MODULES_AND_FEATURES.md` + `05_BUSINESS_WORKFLOWS.md` |
49
- | UIVisualDesignerAgent | `UI_VISUAL_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: وجود Frontend مهم أو مصدر تصميم (Figma, getdesign.md, screenshots) | 4–5 | إذا كان المشروع API-only، أو UI بسيط جدًا بدون متطلبات بصرية | `07_SCREENS_AND_UI_STRUCTURE.md` + مصدر التصميم |
50
- | DataDesignAgent | `DATA_DESIGN_AGENT` | `DOCUMENT_READY`: بعد وضوح الموديولات والعمليات | 4 | إذا كان التطبيق لا يملك بيانات مترابطة (مثل موقع بسيط بمحتوى ثابت) | `03_MODULES_AND_FEATURES.md` + `05_BUSINESS_WORKFLOWS.md` |
51
- | SolutionArchitectureAgent | `SOLUTION_ARCH_AGENT` | `PHASE_GATE`: قبل التنفيذ (Phase 5) | 5 | إذا كان المشروع صغيرًا جدًا والتقنيات محددة مسبقًا بدون قرارات معمارية مؤثرة | `08_TECHNICAL_ARCHITECTURE.md` أو `00_PROJECT_INPUTS.md` |
52
- | EngineeringAgent (Fallback) | `ENGINEERING_AGENT` | `PHASE_GATE`: عند وجود مهمة تنفيذية مع `Pre-Execution Gate: PASS` وليس للـ stack وكيل متخصص | 6 | يُفضّل تفعيل الوكيل المتخصص أولاً. لا يُفعّل بدون `TASK-COD-*` معتمد. لا يُفعّل لتحضير أو تحليل | ملفات التحليل والتصميم المعتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` |
53
- | EngineeringAgentTypeScript | `ENGINEERING_AGENT_TS` | `PHASE_GATE`: عند وجود مهمة TypeScript/Node.js functional code مع `Pre-Execution Gate: PASS` | 6 | لا يُفعّل لمهام .NET/C# (وجّه لـ dotnet). لا يُفعّل لمهام Phaser (وجّه لـ phaser). لا يُفعّل لمهام UI البصرية (وجّه لـ ui-designer) | ملفات التحليل والتصميم المعتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active Technology Profile |
54
- | EngineeringAgentPhaser | `ENGINEERING_AGENT_PHASER` | `PHASE_GATE`: عند وجود مهمة Phaser 3 game engine مع `Pre-Execution Gate: PASS` | 6 | لا يُفعّل لمهام React/Backend (وجّه لـ typescript). لا يُفعّل لمهام .NET/C# | ملفات التحليل والتصميم المعتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Game Design Documents |
55
- | QAAndAcceptanceAgent | `QA_ACCEPTANCE_AGENT` | **Planning Mode:** `PHASE_GATE` + `DOCUMENT_READY`: قبل إعداد خطة التنفيذ. **Execution Mode:** `DOCUMENT_READY`: بعد تنفيذ `TASK-COD-*` يحتاج تحقق فعلي (build/test/run/connect). **كلا الوضعين:** قبل Phase 7 وقبل قبول أي مرحلة | 5–6–7 | **Planning Mode:** إذا كانت المهمة بسيطة ومعايير القبول واضحة ويمكن لـ Tera كتابتها مباشرة. **Execution Mode:** إذا كانت المهمة لا تحتاج اختبار CLI (مثل وثائق أو تحضير) | `10_TESTING_AND_ACCEPTANCE.md` (Planning) أو ملف `TASK-COD-*` المنفذ + معايير القبول (Execution) |
56
- | Auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`: بعد مهمة تنفيذية ذات مخاطرة أو أثر جودة؛ ويستدعيه Monitor فقط بطلب Majed | 6 | إذا كانت المهمة وثائقية أو صغيرة منخفضة المخاطر وقرار Tera هو `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب موثق | ملف المهمة + Handback + diff/changed files + QA/Security/analyzer evidence عند وجودها + `QUALITY_GATE_THRESHOLDS.md` |
57
- | DesignReviewer (ناقد) | `DESIGN_REVIEWER` | `PHASE_GATE`: بعد إنتاج TASK-PROTO-* الأول (بناء البروتوتايب) — لمراجعة البروتوتايب قبل عرضه على Majed/الزبون؛ و`REVIEW_NEEDED` لمراجعة الواجهات المنفذة (SCP-2026-08-28-001) | 5–6 | إذا لم توجد واجهات أو بروتوتايب (مشروع API-only) أو سجّل Majed `WAIVED_BY_MAJED` | `project-control/prototypes/` + مصدر التصميم + `07_SCREENS_AND_UI_STRUCTURE.md` |
58
- | DocumentationHandoverAgent | `DOC_HANDOVER_AGENT` | `PHASE_7_GATE`: عند قرب التسليم أو في Phase 7 | 7 | إذا كان المشروع داخليًا small ولن يُسلّم لطرف آخر | ملفات التحليل والتصميم المعتمدة |
59
-
60
- ---
61
-
62
- ### 2.2 العملاء المشروطون
63
-
64
- | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
65
- |---|---|---|---|---|---|
66
- | SecurityAgent | `SECURITY_AGENT` | `RISK_SIGNAL`: بيانات حساسة، Auth، صلاحيات مدفوعات، أسرار، Middleware، Config حرجة | 5–6–7 | إذا لم يكن هناك أي بيانات حساسة أو صلاحيات أو تكاملات خارجية | `04_USERS_ROLES_PERMISSIONS.md` + `08_TECHNICAL_ARCHITECTURE.md` |
67
- | IntegrationAgent | `INTEGRATION_AGENT` | `EXTERNAL_FACTOR`: API خارجي، بوابة دفع، Webhooks، ERP خارجي | 5–6 | إذا كان المشروع لا يتصل بأي خدمة خارجية | `14_INTEGRATIONS_AND_EXTERNAL_SERVICES.md` أو ما يعادلها |
68
- | DevOpsDeploymentAgent | `DEVOPS_DEPLOYMENT_AGENT` | `EXTERNAL_FACTOR / USER_REQUEST`: نشر فعلي، CI/CD، Docker، Cloud، Domain/SSL | 6–7 | إذا كان المشروع في بيئة محلية فقط أو لا يحتاج نشر رسمي بعد | `22_DEPLOYMENT_AND_ENVIRONMENTS.md` أو `08_TECHNICAL_ARCHITECTURE.md` |
69
- | PerformanceAgent | `PERFORMANCE_AGENT` | `COMPLEXITY_SIGNAL`: حجم بيانات كبير، مستخدمون كثر، SLA، بطء متوقع | 5–6 | إذا كان المشروع صغيرًا وعدد المستخدمين محدودًا | `06_DATA_MODEL_PREPARATION.md` + `32_PERFORMANCE_REQUIREMENTS.md` |
70
- | ComplianceAgent | `COMPLIANCE_AGENT` | `RISK_SIGNAL`: متطلبات قانونية، بيانات شخصية، مالية، قطاع منظم | 5–6–7 | إذا لم يكن المشروع خاضعًا لأي تنظيم أو امتثال | `34_COMPLIANCE_AND_LEGAL_NOTES.md` أو `02_SCOPE_AND_BOUNDARIES.md` |
71
- | ReportingAnalyticsAgent | `REPORTING_ANALYTICS_AGENT` | `COMPLEXITY_SIGNAL`: تقارير كثيرة، Dashboard، KPIs، تصدير | 5–6 | إذا كان التطبيق لا يحتوي تقارير أو لوحات بيانات | `13_REPORTS_AND_DASHBOARDS.md` |
72
- | MaintenanceMigrationAgent | `MAINTENANCE_MIGRATION_AGENT` | `EXTERNAL_FACTOR`: نظام قائم، ترحيل بيانات، Legacy | 5–6–7 | إذا كان المشروع جديدًا بالكامل بدون ترحيل | `31_MAINTENANCE_AND_SUPPORT.md` أو `00_PROJECT_INPUTS.md` |
73
- | ProjectControlAgent | `PROJECT_CONTROL_AGENT` | `REVIEW_NEEDED`: عند الحاجة لتحديث سجلات `project-control` أو فحص اتساق | 4–5–6–7 | إذا لم تكن هناك حاجة لتحديث سجلات متعددة أو فحص اتساق | ملفات project-control الحالية |
74
- | tera-software-designer (SoftwareDesignerAgent) | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | إذا كانت المهمة بسيطة ويمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
75
- | QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `REVIEW_NEEDED`: قبل مرحلة تنفيذ كبيرة، أو بعد عدة مهام، أو قبل Release | 5–6–7 | إذا كان المشروع صغيرًا والمهام قليلة ويمكن لـ Tera متابعتها يدويًا | `PROJECT_STATE.md` + `TASK_REGISTRY.md` |
76
- | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `REVIEW_NEEDED`: نهاية Phase، أو بعد دفعة مهام رئيسية، أو قبل قبول MVP | 5–6–7 | إذا كان التنفيذ متوافقًا بوضوح مع الخطة ولا توجد انحرافات ظاهرة | `PROJECT_MASTER_PLAN.md` + `TASK_REGISTRY.md` |
77
- | DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `COMPLEXITY_SIGNAL / USER_REQUEST`: مجال غير مألوف، أو حاجة بحث خارجي | 1–2–3 | إذا كان المجال معروفًا بالكامل أو المستخدم قدم جميع المعلومات المطلوبة | Domain Research Brief من Tera |
78
- | DomainExpertAgent | `DOMAIN_EXPERT_AGENT` | `COMPLEXITY_SIGNAL`: بعد اكتمال Domain Research، أو عند الحاجة لتحليل متقدم | 2–3–4 | إذا لم يُظهر Domain Research نتائج تستدعي تحليلًا إضافيًا | Domain Research Report + Domain Research Brief |
79
- | ProductionERPExpert | `PRODUCTION_ERP_EXPERT` | `COMPLEXITY_SIGNAL / USER_REQUEST`: موديول تصنيع/إنتاج ERP، أو حاجة لتحليل BOM/Routing/MRP/WIP/Costing/Quality/Rework/Scrap أو مراجعة Production Blueprint | 1–5 | إذا كان المشروع لا يحتوي تصنيع/إنتاج، أو كانت الأسئلة CRUD عامة لا تحتاج خبرة Production ERP | Production context + ملفات discovery/blueprint ذات الصلة + KB index عند الحاجة |
80
- | RedTeamAgent (الشبح) 🆕 | `RED_TEAM_AGENT` | `PHASE_7_GATE`: بوابة الأمن قبل التسليم — أو `USER_REQUEST` من Majed: "اختبر أمان التطبيق" | 7 (أو بطلب Majed) | لا يُفعّل تلقائياً في Phases 1–6؛ لا يُفعّل على Production بلا تفويض مكتوب؛ لا يُفعّل لأطراف ثالثة | `00_AUTHORIZATION.md` (التفويض والنطاق) + URL/البيئة + Commit SHA + الحدود |
81
- | SecurityObserver (العين) 🆕 | `SECURITY_OBSERVER` | بالتزامن مع تفعيل Red Team — `PHASE_7_GATE / USER_REQUEST` | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة Red Team ليراقبها | Round ID + سجلات التطبيق + Canary baseline + Test IDs من الشبح |
82
- | SecurityAuditor (القاضي) 🆕 | `SECURITY_AUDITOR` | بعد اكتمال: Red Team + Observer + Engineering Fixes + Retest — `PHASE_7_GATE / USER_REQUEST` | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الجولة والأدلة؛ لا يصدر PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح وإعادة الاختبار |
83
-
84
- ---
85
-
86
- ### 2.3 عملاء التعامل مع العملاء الخارجيين
87
-
88
- | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
89
- |---|---|---|---|---|---|
90
- | ClientDiscoveryAgent | `CLIENT_DISCOVERY_AGENT` | `EXTERNAL_FACTOR`: بداية مشروع عميل خارجي | Client Discovery (قبل Phase 1) | إذا كان المشروع داخليًا (غير موجه لعميل خارجي) | `CLIENT_PROFILE.md` + `project-inputs/` |
91
- | ProposalScopeAgent | `PROPOSAL_SCOPE_AGENT` | `EXTERNAL_FACTOR`: بعد اكتمال Client Discovery واعتماد الفهم | Client Discovery (قبل Phase 1) | إذا لم يكتمل Client Discovery بعد | `project-inputs/` كاملة |
92
- | ClientApprovalReviewAgent | `CLIENT_APPROVAL_REVIEW_AGENT` | `EXTERNAL_FACTOR`: قبل إرسال حزمة اعتماد العميل أو قبل Build Mode | ما قبل التنفيذ | إذا لم تكتمل حزمة الاعتماد بعد | `clients/.../client-approval/` |
93
- | ChangeControlAgent | `CHANGE_CONTROL_AGENT` | `EXTERNAL_FACTOR`: طلب تغيير جديد بعد اعتماد النطاق | أي مرحلة بعد اعتماد النطاق | إذا لم يظهر أي طلب تغيير | `11_CHANGE_CONTROL.md` أو طلب التغيير الجديد |
94
-
95
- ---
96
-
97
- ## 3. مصفوفة التفعيل حسب نوع المشروع
98
-
99
- ### 3.1 مشروع صغير (CRUD بسيط)
100
-
101
- | العميل | هل يُفعّل؟ | ملاحظة |
102
- |---|---|---|
103
- | RequirementsScopeAgent | اختياري | إذا كانت الفكرة بسيطة وواضحة، يمكن لـ Tera كتابة `01_PROJECT_BRIEF.md` مباشرة |
104
- | BusinessWorkflowAgent | لا | إذا لم يكن هناك workflows |
105
- | UIUXStructureAgent | اختياري | إذا كان هناك واجهة بسيطة |
106
- | UIVisualDesignerAgent | لا | إلا إذا قدم المستخدم ألوانًا أو مصدر تصميم |
107
- | DataDesignAgent | اختياري | إذا كانت البيانات مترابطة |
108
- | SolutionArchitectureAgent | لا | التقنيات محددة مسبقًا |
109
- | EngineeringAgent | نعم | مع `Pre-Execution Gate: PASS` |
110
- | QAAndAcceptanceAgent | اختياري | يمكن لـ Tera مراجعة المهمة مباشرة |
111
- | DocumentationHandoverAgent | لا | |
112
- | SecurityAgent | لا | إلا إذا كان هناك Auth |
113
- | باقي المشروطون | لا | لا triggers كافية |
114
-
115
- ### 3.2 مشروع متوسط (تطبيق ويب متكامل مع Dashboard)
116
-
117
- | العميل | هل يُفعّل؟ | ملاحظة |
118
- |---|---|---|
119
- | RequirementsScopeAgent | نعم | |
120
- | BusinessWorkflowAgent | نعم | إذا كان هناك workflows |
121
- | UIUXStructureAgent | نعم | |
122
- | UIVisualDesignerAgent | اختياري | إذا كان هناك متطلبات بصرية |
123
- | DataDesignAgent | نعم | |
124
- | SolutionArchitectureAgent | نعم | |
125
- | EngineeringAgent | نعم | |
126
- | QAAndAcceptanceAgent | نعم | |
127
- | DocumentationHandoverAgent | اختياري | إذا كان هناك تسليم لطرف آخر |
128
- | SecurityAgent | نعم | إذا كان هناك Auth أو صلاحيات |
129
- | PerformanceAgent | اختياري | إذا توقعنا حجم مستخدمين متوسط |
130
- | ReportingAnalyticsAgent | اختياري | إذا كان هناك Dashboard |
38
+ | `PHASE_7_GATE` | بداية Phase 7 | qa-agent (Execution) + red-team-agent (بوابة الأمن) |
39
+
40
+ ---
41
+
42
+ ## 2. مصفوفة التفعيل حسب العميل
43
+
44
+ ### 2.1 العملاء الأساسيون (الـ 23 الرسميون)
45
+
46
+ | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
47
+ |---|---|---|---|---|---|
48
+ | tera (TeraAgent) | `TERA` | `PHASE_GATE`: بداية Phase 5 (تسليم Engineering Handoff Package) | 5–7 | — | Engineering Handoff Package من application-blueprint |
49
+ | application-blueprint (مهندس) | `APPLICATION_BLUEPRINT_AGENT` | `PHASE_GATE`: بداية Phase 1–4 | 1–4 | — | Handoff من TCEA أو طلب Majed |
50
+ | engineering-agent | `ENGINEERING_AGENT` | `PHASE_GATE`: مهمة تنفيذية مع `Pre-Execution Gate: PASS` وليس للـ stack وكيل متخصص | 6 | يُفضّل المتخصص أولاً. لا يُفعّل بدون `TASK-COD-*` معتمد | ملفات التحليل والتصميم المعتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` |
51
+ | engineering-agent-typescript | `ENGINEERING_AGENT_TS` | `PHASE_GATE`: مهمة TypeScript/Node.js functional code مع `Pre-Execution Gate: PASS` | 6 | لا لمهام .NET (dotnet). لا لـ Phaser (phaser). لا للـ UI البصري (ui-designer) | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active Technology Profile |
52
+ | engineering-agent-phaser | `ENGINEERING_AGENT_PHASER` | `PHASE_GATE`: مهمة Phaser 3 game engine مع `Pre-Execution Gate: PASS` | 6 | لا لمهام React/Backend (typescript). لا لـ .NET | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Game Design Documents |
53
+ | engineering-agent-dotnet | `ENGINEERING_AGENT_DOTNET` | `PHASE_GATE`: مهمة .NET/C# مع `Pre-Execution Gate: PASS` | 6 | لا لمهام TypeScript/Phaser | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active .NET Profile |
54
+ | ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: وجود Frontend مهم أو مصدر تصميم (Figma, getdesign.md, screenshots) | 4–5 | API-only أو UI بسيط بدون متطلبات بصرية | `07_SCREENS_AND_UI_STRUCTURE.md` + مصدر التصميم |
55
+ | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | مهمة بسيطة يمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
56
+ | qa-agent | `QA_ACCEPTANCE_AGENT` | **Planning:** `PHASE_GATE` + `DOCUMENT_READY`. **Execution:** `DOCUMENT_READY` بعد تنفيذ `TASK-COD-*` يحتاج تحقق فعلي. **كلا الوضعين:** قبل Phase 7 | 5–6–7 | مهمة بسيطة واضحة / لا تحتاج اختبار CLI | `10_TESTING_AND_ACCEPTANCE.md` أو ملف `TASK-COD-*` المنفذ + معايير القبول |
57
+ | auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed | 6 | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence |
58
+ | design-reviewer | `DESIGN_REVIEWER` | `PHASE_GATE`: بعد إنتاج TASK-PROTO-* الأول؛ و`REVIEW_NEEDED` للواجهات المنفذة | 5–6 | لا واجهات/بروتوتايب (API-only) أو `WAIVED_BY_MAJED` | `project-control/prototypes/` + مصدر التصميم + `07_SCREENS_AND_UI_STRUCTURE.md` |
59
+ | monitor | `MONITOR` | `REVIEW_NEEDED`: مراجعة امتثال الخطط (يستدعي Auditor عند الحاجة) | 5–7 | — | خطط + سجلات |
60
+ | tera-client-engagement | `TCEA` | `EXTERNAL_FACTOR`: مشروع عميل خارجي / Consulting Mode | قبل Phase 1 | مشروع داخلي | `CLIENT_PROFILE.md` + `project-inputs/` |
61
+ | tera-business-transformation-consultant | `BTCA` | `EXTERNAL_FACTOR / USER_REQUEST`: تحول مؤسسي (Track C) — يُستدعى عبر TCEA | Track C | — | طلب Majed/عميل |
62
+ | tera-strategic-advisor | `STRATEGIC_ADVISOR` | `USER_REQUEST`: يستدعيه Majed فقط | أي وقت | — | طلب Majed المباشر |
63
+ | domain-research-agent | `DOMAIN_RESEARCH_AGENT` | `COMPLEXITY_SIGNAL / USER_REQUEST`: مجال غير مألوف أو حاجة بحث خارجي | 1–2–3 | المجال معروف بالكامل | Domain Research Brief |
64
+ | domain-expert-agent | `DOMAIN_EXPERT_AGENT` | `COMPLEXITY_SIGNAL`: بعد Domain Research أو تحليل متقدم | 2–3–4 | نتائج البحث لا تستدعي تحليلاً إضافياً | Domain Research Report + Brief |
65
+ | production-erp-expert | `PRODUCTION_ERP_EXPERT` | `COMPLEXITY_SIGNAL / USER_REQUEST`: موديول تصنيع/إنتاج ERP | 1–5 | لا تصنيع/إنتاج | Production context + ملفات discovery/blueprint |
66
+ | project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `TASK_COMPLETED`: بعد مهمة مؤثرة — تحديث الذاكرة التشغيلية | 5–7 | مهمة غير مؤثرة | TASK-ID + ملخص المهمة |
67
+ | tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `USER_REQUEST`: تطوير/حوكمة منظومة Tera — يستدعيه Majed | — | — | طلب Majed |
68
+ | red-team-agent (الشبح) | `RED_TEAM_AGENT` | `PHASE_7_GATE`: بوابة الأمن قبل التسليم — أو `USER_REQUEST` من Majed | 7 (أو بطلب Majed) | لا يُفعّل تلقائياً في Phases 1–6؛ لا على Production بلا تفويض مكتوب | `00_AUTHORIZATION.md` + URL/البيئة + Commit SHA + الحدود |
69
+ | security-observer (العين) | `SECURITY_OBSERVER` | بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
70
+ | security-auditor (القاضي) | `SECURITY_AUDITOR` | بعد اكتمال: Red Team + Observer + Fixes + Retest | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الأدلة؛ لا PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
71
+
72
+ ### 2.2 الأدوار التحضيرية (Preparation Roles — يملكها application-blueprint)
73
+
74
+ > ليست عملاءً ثابتين — تُنفَّذ مسؤوليتها عبر `application-blueprint` (`TASK-PREP-*`) أو عبر عملاء مساعدين مُولَّدين عند الحاجة. (راجع `TeraSubAgents.md` §5.9)
75
+
76
+ | الدور (القديم) | المسؤولية | المالك الحالي |
77
+ |---|---|---|
78
+ | RequirementsScopeAgent | تحليل المتطلبات والنطاق | `application-blueprint` |
79
+ | BusinessWorkflowAgent | مسارات العمل والحالات | `application-blueprint` |
80
+ | UIUXStructureAgent | هيكل الشاشات والتنقل | `application-blueprint` + `ui-designer` |
81
+ | UIVisualDesignerAgent | Design Tokens / Component Rules | `ui-designer` |
82
+ | DataDesignAgent | نموذج البيانات | `application-blueprint` + `tera-software-designer` |
83
+ | SolutionArchitectureAgent | البنية التقنية | `application-blueprint` + `tera-software-designer` |
84
+ | DocumentationHandoverAgent | توثيق التسليم (Phase 7) | `tera.md` + `engineering-agent-typescript` |
85
+
86
+ ### 2.3 العملاء المشروطون (Helper Agents — مُولَّدون عند الحاجة)
87
+
88
+ | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
89
+ |---|---|---|---|---|---|
90
+ | SecurityAgent (الدرع) | `SECURITY_AGENT` | `RISK_SIGNAL`: بيانات حساسة، Auth، صلاحيات، مدفوعات، أسرار | 5–6–7 | لا بيانات حساسة أو صلاحيات | `04_USERS_ROLES_PERMISSIONS.md` + `08_TECHNICAL_ARCHITECTURE.md` |
91
+ | IntegrationAgent | `INTEGRATION_AGENT` | `EXTERNAL_FACTOR`: API خارجي، بوابة دفع، Webhooks | 5–6 | لا تكاملات خارجية | `14_INTEGRATIONS_AND_EXTERNAL_SERVICES.md` |
92
+ | DevOpsDeploymentAgent | `DEVOPS_DEPLOYMENT_AGENT` | `EXTERNAL_FACTOR / USER_REQUEST`: نشر فعلي، CI/CD، Docker | 6–7 | بيئة محلية فقط | `22_DEPLOYMENT_AND_ENVIRONMENTS.md` |
93
+ | PerformanceAgent | `PERFORMANCE_AGENT` | `COMPLEXITY_SIGNAL`: حجم بيانات كبير، SLA | 5–6 | مشروع صغير | `06_DATA_MODEL_PREPARATION.md` + `32_PERFORMANCE_REQUIREMENTS.md` |
94
+ | ComplianceAgent | `COMPLIANCE_AGENT` | `RISK_SIGNAL`: متطلبات قانونية/قطاع منظم | 5–6–7 | غير خاضع لتنظيم | `34_COMPLIANCE_AND_LEGAL_NOTES.md` |
95
+ | ReportingAnalyticsAgent | `REPORTING_ANALYTICS_AGENT` | `COMPLEXITY_SIGNAL`: تقارير كثيرة، Dashboard | 5–6 | لا تقارير | `13_REPORTS_AND_DASHBOARDS.md` |
96
+ | MaintenanceMigrationAgent | `MAINTENANCE_MIGRATION_AGENT` | `EXTERNAL_FACTOR`: نظام قائم، ترحيل | 5–6–7 | مشروع جديد | `31_MAINTENANCE_AND_SUPPORT.md` |
97
+ | ProjectControlAgent | `PROJECT_CONTROL_AGENT` | `REVIEW_NEEDED`: تحديث سجلات project-control | 4–5–6–7 | لا حاجة | ملفات project-control الحالية |
98
+ | QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `REVIEW_NEEDED`: قبل تنفيذ كبير أو بعد عدة مهام | 5–6–7 | مشروع صغير | `PROJECT_STATE.md` + `TASK_REGISTRY.md` |
99
+ | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `REVIEW_NEEDED`: نهاية Phase أو قبل قبول MVP | 5–6–7 | تنفيذ متوافق بوضوح | `PROJECT_MASTER_PLAN.md` + `TASK_REGISTRY.md` |
100
+
101
+ ### 2.4 عملاء التعامل مع العملاء الخارجيين
102
+
103
+ | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
104
+ |---|---|---|---|---|---|
105
+ | ClientDiscoveryAgent | `CLIENT_DISCOVERY_AGENT` | `EXTERNAL_FACTOR`: بداية مشروع عميل خارجي | قبل Phase 1 | مشروع داخلي | `CLIENT_PROFILE.md` + `project-inputs/` |
106
+ | ProposalScopeAgent | `PROPOSAL_SCOPE_AGENT` | `EXTERNAL_FACTOR`: بعد اكتمال Client Discovery | قبل Phase 1 | لم يكتمل Discovery | `project-inputs/` كاملة |
107
+ | ClientApprovalReviewAgent | `CLIENT_APPROVAL_REVIEW_AGENT` | `EXTERNAL_FACTOR`: قبل إرسال حزمة اعتماد | ما قبل التنفيذ | لم تكتمل الحزمة | `clients/.../client-approval/` |
108
+ | ChangeControlAgent | `CHANGE_CONTROL_AGENT` | `EXTERNAL_FACTOR`: طلب تغيير جديد | بعد اعتماد النطاق | لا طلب تغيير | `11_CHANGE_CONTROL.md` |
109
+
110
+ ---
111
+
112
+ ## 3. مصفوفة التفعيل حسب نوع المشروع
113
+
114
+ ### 3.1 مشروع صغير (CRUD بسيط)
115
+
116
+ | العميل | هل يُفعّل؟ | ملاحظة |
117
+ |---|---|---|
118
+ | application-blueprint | نعم | إنتاج الحد الأدنى من التحضير |
119
+ | الأدوار التحضيرية (Scope/Workflow/UIUX/Data/Arch) | اختياري | عبر application-blueprint — فقط عند الحاجة |
120
+ | ui-designer | لا | إلا إذا قدم المستخدم ألواناً أو مصدر تصميم |
121
+ | engineering-agent | نعم | مع `Pre-Execution Gate: PASS` |
122
+ | qa-agent | اختياري | يمكن لـ Tera مراجعة المهمة مباشرة |
123
+ | SecurityAgent (الدرع) | لا | إلا إذا كان هناك Auth |
124
+ | باقي المشروطون | لا | لا triggers كافية |
125
+
126
+ ### 3.2 مشروع متوسط (تطبيق ويب متكامل مع Dashboard)
127
+
128
+ | العميل | هل يُفعّل؟ | ملاحظة |
129
+ |---|---|---|
130
+ | application-blueprint | نعم | |
131
+ | الأدوار التحضيرية (Scope/Workflow/UIUX/Data/Arch) | نعم | عبر application-blueprint (عند الحاجة) |
132
+ | ui-designer | اختياري | إذا كان هناك متطلبات بصرية |
133
+ | engineering-agent | نعم | (أو المتخصص حسب الـ stack) |
134
+ | engineering-agent-typescript / dotnet / phaser | حسب الـ stack | |
135
+ | qa-agent | نعم | |
136
+ | tera-software-designer | اختياري | عند تعقيد المهمات |
137
+ | auditor | اختياري | عند risk/architecture/quality trigger |
138
+ | PerformanceAgent | اختياري | إذا توقعنا حجم مستخدمين متوسط |
139
+ | ReportingAnalyticsAgent | اختياري | إذا كان هناك Dashboard |
131
140
  | ProjectControlAgent | اختياري | عند تعدد المهمات |
132
- | tera-software-designer (SoftwareDesignerAgent) | اختياري | عند تعقيد المهمات |
133
- | Auditor | اختياري | مطلوب فقط عند risk/architecture/quality trigger بعد التنفيذ |
134
-
135
- ### 3.3 مشروع ERP (نظام تخطيط موارد مؤسسة)
136
-
137
- | العميل | هل يُفعّل؟ | ملاحظة |
138
- |---|---|---|
139
- | RequirementsScopeAgent | نعم | |
140
- | BusinessWorkflowAgent | نعم | أساسي في ERP |
141
- | UIUXStructureAgent | نعم | |
142
- | UIVisualDesignerAgent | نعم | إذا كان UI مهمًا |
143
- | DataDesignAgent | نعم | أساسي |
144
- | SolutionArchitectureAgent | نعم | |
145
- | EngineeringAgent | نعم | مع تفعيل متكرر عبر موديولات متعددة |
146
- | QAAndAcceptanceAgent | نعم | |
147
- | DocumentationHandoverAgent | نعم | ERP يحتاج توثيق تسليم كامل |
148
- | SecurityAgent | نعم | ERP يحتوي صلاحيات وبيانات حساسة |
149
- | IntegrationAgent | نعم | تكاملات خارجية متوقعة |
150
- | DevOpsDeploymentAgent | نعم | نشر في بيئات متعددة |
151
- | PerformanceAgent | نعم | حجم بيانات كبير |
152
- | ComplianceAgent | اختياري | حسب المجال |
153
- | ReportingAnalyticsAgent | نعم | ERP يحتوي تقارير كثيرة |
154
- | MaintenanceMigrationAgent | نعم | ERP يحتاج ترحيل بيانات |
155
- | ProjectControlAgent | نعم | إدارة تتبع متقدمة |
156
- | tera-software-designer (SoftwareDesignerAgent) | نعم | مهام متعددة ومعقدة تحتاج Technical Specification |
141
+
142
+ ### 3.3 مشروع ERP (نظام تخطيط موارد مؤسسة)
143
+
144
+ | العميل | هل يُفعّل؟ | ملاحظة |
145
+ |---|---|---|
146
+ | application-blueprint | نعم | |
147
+ | الأدوار التحضيرية (Scope/Workflow/UIUX/Data/Arch) | نعم | أساسي — عبر application-blueprint |
148
+ | ui-designer | نعم | إذا كان UI مهمًا |
149
+ | engineering-agent | نعم | مع تفعيل متكرر عبر موديولات متعددة |
150
+ | qa-agent | نعم | |
151
+ | tera-software-designer | نعم | مهام متعددة ومعقدة |
152
+ | auditor | نعم | بعد المهام الحساسة |
153
+ | SecurityAgent (الدرع) | نعم | صلاحيات وبيانات حساسة |
154
+ | IntegrationAgent | نعم | تكاملات خارجية متوقعة |
155
+ | DevOpsDeploymentAgent | نعم | نشر في بيئات متعددة |
156
+ | PerformanceAgent | نعم | حجم بيانات كبير |
157
+ | ComplianceAgent | اختياري | حسب المجال |
158
+ | ReportingAnalyticsAgent | نعم | تقارير كثيرة |
159
+ | MaintenanceMigrationAgent | نعم | ترحيل بيانات |
160
+ | ProjectControlAgent | نعم | إدارة تتبع متقدمة |
157
161
  | QualityReviewCoordinatorAgent | نعم | بعد مجموعات مهام |
158
- | Auditor | نعم | بعد المهام الحساسة أو ذات الأثر المعماري/الجودة |
159
162
  | PlanComplianceReviewAgent | نعم | قبل قبول مراحل |
160
- | DomainResearchAgent | اختياري | لمجالات ERP غير المألوفة |
161
- | DomainExpertAgent | اختياري | لتحليل متقدم للمجال |
162
- | ProductionERPExpert | نعم عند وجود موديول تصنيع/إنتاج | أساسي لمشاريع ERP التصنيعية أو أي Production module |
163
- | Client Engagement Agents | اختياري | إذا كان ERP لعميل خارجي |
164
-
165
- ### 3.4 مشروع SaaS (منصة خدمية)
166
-
167
- | العميل | هل يُفعّل؟ | ملاحظة |
168
- |---|---|---|
169
- | RequirementsScopeAgent | نعم | |
170
- | BusinessWorkflowAgent | نعم | |
171
- | UIUXStructureAgent | نعم | |
172
- | UIVisualDesignerAgent | نعم | UI مهم لـ SaaS |
173
- | DataDesignAgent | نعم | |
174
- | SolutionArchitectureAgent | نعم | |
175
- | EngineeringAgent | نعم | |
176
- | QAAndAcceptanceAgent | نعم | |
177
- | DocumentationHandoverAgent | نعم | توثيق للمستخدمين |
178
- | SecurityAgent | نعم | Auth/Multi-tenant أساسي |
179
- | IntegrationAgent | اختياري | حسب التكاملات |
180
- | DevOpsDeploymentAgent | نعم | نشر مستمر |
181
- | PerformanceAgent | نعم | قابلية التوسع |
182
- | ReportingAnalyticsAgent | اختياري | حسب الاحتياج |
183
- | ProjectControlAgent | اختياري | عند تعدد المهمات |
184
- | tera-software-designer (SoftwareDesignerAgent) | اختياري | عند تعقيد المهمات |
185
-
186
- ---
187
-
188
- ## 4. قواعد التفعيل الصارمة
189
-
190
- ### 4.1 لا تفعيل تلقائي للعملاء
191
-
192
- ```
163
+ | domain-research-agent / domain-expert-agent | اختياري | لمجالات غير مألوفة |
164
+ | production-erp-expert | نعم عند وجود موديول تصنيع | أساسي لمشاريع ERP التصنيعية |
165
+ | tera-client-engagement | اختياري | إذا كان ERP لعميل خارجي |
166
+
167
+ ### 3.4 مشروع SaaS (منصة خدمية)
168
+
169
+ | العميل | هل يُفعّل؟ | ملاحظة |
170
+ |---|---|---|
171
+ | application-blueprint | نعم | |
172
+ | الأدوار التحضيرية (Scope/Workflow/UIUX/Data/Arch) | نعم | عبر application-blueprint |
173
+ | ui-designer | نعم | UI مهم لـ SaaS |
174
+ | engineering-agent | نعم | (أو المتخصص) |
175
+ | qa-agent | نعم | |
176
+ | tera-software-designer | اختياري | عند تعقيد المهمات |
177
+ | SecurityAgent (الدرع) | نعم | Auth/Multi-tenant أساسي |
178
+ | IntegrationAgent | اختياري | حسب التكاملات |
179
+ | DevOpsDeploymentAgent | نعم | نشر مستمر |
180
+ | PerformanceAgent | نعم | قابلية التوسع |
181
+ | ReportingAnalyticsAgent | اختياري | حسب الاحتياج |
182
+ | ProjectControlAgent | اختياري | عند تعدد المهمات |
183
+
184
+ ---
185
+
186
+ ## 4. قواعد التفعيل الصارمة
187
+
188
+ ### 4.1 لا تفعيل تلقائي للعملاء
189
+
190
+ ```
193
191
  تفعيل العميل يتم بقرار من Tera فقط، استنادًا إلى Trigger واضح.
194
192
  الاستثناء الوحيد في v1: Monitor → Auditor بطلب Majed الصريح.
195
193
  لا يتم تفعيل العميل تلقائيًا لمجرد دخول مرحلة أو وجود ملف جاهز.
196
- ```
197
-
198
- ### 4.2 لا تفعيل بدون مدخلات كافية
199
-
200
- ```
201
- لا يُفعّل عميل إذا لم تتوفر المدخلات الدنيا المطلوبة.
202
- إذا كانت المدخلات ناقصة، إما:
203
- - أن يكمل Tera المدخلات بنفسه
204
- - أو يُفعّل عميلًا آخر لتجهيز المدخلات أولاً
205
- - أو يطلب من المستخدم إكمالها
206
- ```
207
-
208
- ### 4.3 لا تفعيل عميل موجود بالفعل في مهمة حاليًا
209
-
210
- ```
211
- لا يتم تفعيل نسخة جديدة من عميل موجود حاليًا في مهمة نشطة،
212
- إلا إذا كان العميل جاهزًا لتسلم مهمة جديدة ومستقلة.
213
- ```
214
-
215
- ### 4.4 لا تفعيل عميل لمتطلبات مستقبلية
216
-
217
- ```
218
- لا يتم تفعيل عميل بناءً على متطلبات أو سيناريوهات قد تحدث في المستقبل.
219
- التفعيل يكون للحاجة الحالية فقط.
220
- ```
221
-
222
- ### 4.5 عميل واحد لكل اختصاص في كل مرة
223
-
224
- ```
225
- لا يتم تفعيل عميلين لهما نفس الاختصاص (مثل اثنين EngineeringAgent) في وقت واحد
226
- على نفس الموديول، إلا في حالات المهام المتوازية المستقلة تمامًا.
227
- ```
228
-
229
- ---
230
-
231
- ## 5. تسجيل قرار التفعيل
232
-
194
+ ```
195
+
196
+ ### 4.2 لا تفعيل بدون مدخلات كافية
197
+
198
+ ```
199
+ لا يُفعّل عميل إذا لم تتوفر المدخلات الدنيا المطلوبة.
200
+ إذا كانت المدخلات ناقصة، إما:
201
+ - أن يكمل Tera المدخلات بنفسه
202
+ - أو يُفعّل عميلًا آخر لتجهيز المدخلات أولاً
203
+ - أو يطلب من المستخدم إكمالها
204
+ ```
205
+
206
+ ### 4.3 لا تفعيل عميل موجود بالفعل في مهمة حاليًا
207
+
208
+ ```
209
+ لا يتم تفعيل نسخة جديدة من عميل موجود حاليًا في مهمة نشطة،
210
+ إلا إذا كان العميل جاهزًا لتسلم مهمة جديدة ومستقلة.
211
+ ```
212
+
213
+ ### 4.4 لا تفعيل عميل لمتطلبات مستقبلية
214
+
215
+ ```
216
+ لا يتم تفعيل عميل بناءً على متطلبات أو سيناريوهات قد تحدث في المستقبل.
217
+ التفعيل يكون للحاجة الحالية فقط.
218
+ ```
219
+
220
+ ### 4.5 عميل واحد لكل اختصاص في كل مرة
221
+
222
+ ```
223
+ لا يتم تفعيل عميلين لهما نفس الاختصاص (مثل اثنين engineering-agent) في وقت واحد
224
+ على نفس الموديول، إلا في حالات المهام المتوازية المستقلة تمامًا.
225
+ ```
226
+
227
+ ---
228
+
229
+ ## 5. تسجيل قرار التفعيل
230
+
233
231
  عند تفعيل أي عميل فرعي، يسجل Tera في `PROJECT_ACTIVITY_LOG.md`.
234
232
  وعند استدعاء Monitor لـ Auditor بطلب Majed، يسجل Monitor ذلك في تقريره أو في السجل المتاح له:
235
-
236
- ```
237
- - Agent ID
238
- - Activation Trigger
239
- - Task ID المستهدف
240
- - المرحلة الحالية
241
- - Brief reason for activation
242
- ```
243
-
244
- ---
245
-
246
- ## 6. إلغاء التفعيل أو التعطيل المؤقت
247
-
248
- إذا تم تفعيل عميل ثم تبين أنه غير مطلوب:
249
-
250
- 1. يتم إنهاء مهمته الحالية بحالة `Cancelled` مع سبب واضح.
251
- 2. يسجل Tera الإلغاء في `PROJECT_ACTIVITY_LOG.md`.
252
- 3. لا يُعاد تفعيله إلا عند ظهور Trigger جديد ومستقل.
253
-
254
- ---
255
-
256
- ## 7. أمثلة على تطبيق القواعد
257
-
258
- ### مثال 1: مشروع ERP جديد — مرحلة التحضير
259
-
260
- ```
261
- Trigger: بداية Phase 4 (Preparation)
262
- مُهندس يقرر: تفعيل RequirementsScopeAgent و BusinessWorkflowAgent و DataDesignAgent
263
- لا يُفعّل: SolutionArchitectureAgent (يُفعّل لاحقاً في Phase 4 حسب الحاجة)، SecurityAgent (لا يوجد موديول حساس بعد)
264
- ```
265
-
266
- ### مثال 2: طلب تغيير من عميل
267
-
268
- ```
269
- Trigger: طلب إضافة تكامل دفع خارجي
270
- Tera يقرر: تفعيل IntegrationAgent
271
- لا يُفعّل: ChangeControlAgent (لأنه سيقترح فقط، ويمكن لـ Tera إدارة ذلك)
272
- ```
273
-
274
- ### مثال 3: مراجعة بعد 5 مهام تنفيذية
275
-
276
- ```
277
- Trigger: REVIEW_NEEDED
278
- Tera يقرر: تفعيل QualityReviewCoordinatorAgent
279
- بعد تقريره: قد يُفعّل SecurityAgent إذا وجد findings أمنية
280
- ```
281
-
282
- ---
283
-
284
- ## 8. الملخص — قاعدة التفعيل الذهبية
285
-
286
- > **عند الشك، لا تُفعّل.**
287
- >
288
- > العميل هو أداة متخصصة تُستدعى للحاجة الحالية فقط،
289
- > وليس عضوا دائمًا في فريق المشروع.
233
+
234
+ ```
235
+ - Agent ID
236
+ - Activation Trigger
237
+ - Task ID المستهدف
238
+ - المرحلة الحالية
239
+ - Brief reason for activation
240
+ ```
241
+
242
+ ---
243
+
244
+ ## 6. إلغاء التفعيل أو التعطيل المؤقت
245
+
246
+ إذا تم تفعيل عميل ثم تبين أنه غير مطلوب:
247
+
248
+ 1. يتم إنهاء مهمته الحالية بحالة `Cancelled` مع سبب واضح.
249
+ 2. يسجل Tera الإلغاء في `PROJECT_ACTIVITY_LOG.md`.
250
+ 3. لا يُعاد تفعيله إلا عند ظهور Trigger جديد ومستقل.
251
+
252
+ ---
253
+
254
+ ## 7. أمثلة على تطبيق القواعد
255
+
256
+ ### مثال 1: مشروع ERP جديد — مرحلة التحضير
257
+
258
+ ```
259
+ Trigger: بداية Phase 4 (Preparation)
260
+ مُهندس (application-blueprint) يقرر: تنفيذ الأدوار التحضيرية (Scope + Workflow + Data Design) عبر TASK-PREP-*
261
+ لا يُفعّل: حلول معمارية مستقلة (تُنفَّذ ضمن blueprint أو tera-software-designer عند الحاجة)، SecurityAgent (لا يوجد موديول حساس بعد)
262
+ ```
263
+
264
+ ### مثال 2: طلب تغيير من عميل
265
+
266
+ ```
267
+ Trigger: طلب إضافة تكامل دفع خارجي
268
+ Tera يقرر: تفعيل IntegrationAgent (عميل مشروط/مساعد)
269
+ لا يُفعّل: ChangeControlAgent (لأنه سيقترح فقط، ويمكن لـ Tera إدارة ذلك)
270
+ ```
271
+
272
+ ### مثال 3: مراجعة بعد 5 مهام تنفيذية
273
+
274
+ ```
275
+ Trigger: REVIEW_NEEDED
276
+ Tera يقرر: تفعيل QualityReviewCoordinatorAgent
277
+ بعد تقريره: قد يُفعّل SecurityAgent (الدرع) إذا وجد findings أمنية
278
+ ```
279
+
280
+ ---
281
+
282
+ ## 8. الملخص — قاعدة التفعيل الذهبية
283
+
284
+ > **عند الشك، لا تُفعّل.**
285
+ >
286
+ > العميل هو أداة متخصصة تُستدعى للحاجة الحالية فقط،
287
+ > وليس عضوا دائمًا في فريق المشروع.