@tera-system/core 0.2.15 → 0.2.17
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.
- package/MANIFEST.json +5 -5
- package/README.md +3 -3
- package/RELEASES.md +328 -308
- package/agents/application-blueprint.md +4 -4
- package/agents/domain-expert-agent.md +4 -4
- package/agents/domain-research-agent.md +4 -4
- package/agents/engineering-agent-typescript.md +1 -1
- package/agents/production-erp-expert.md +2 -2
- package/agents/red-team-agent.md +1 -1
- package/agents/tera-client-engagement.md +1 -1
- package/agents/tera-system-evolution.md +2 -1
- package/agents/tera.md +1 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
- package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
- package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
- package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
- package/core/tera-system/TeraCapabilityMap.md +327 -0
- package/core/tera-system/TeraHelperAgents.md +13 -10
- package/core/tera-system/TeraPolicyMap.md +2 -1
- package/core/tera-system/TeraPreExecutionGate.md +1 -1
- package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
- package/core/tera-system/TeraSubAgents.md +312 -868
- package/core/tera-system/TeraTokenPolicy.md +1 -1
- package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
- package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
- package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
- package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
- package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
- package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
- package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
- package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
- 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
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
|
27
|
-
|
|
28
|
-
| `
|
|
29
|
-
| `
|
|
30
|
-
| `
|
|
31
|
-
| `
|
|
32
|
-
| `
|
|
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 |
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 2. مصفوفة التفعيل حسب العميل
|
|
41
|
-
|
|
42
|
-
### 2.1 العملاء الأساسيون
|
|
43
|
-
|
|
44
|
-
| العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
|
|
45
|
-
|---|---|---|---|---|---|
|
|
46
|
-
|
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
|
65
|
-
|
|
66
|
-
|
|
|
67
|
-
|
|
|
68
|
-
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
|
75
|
-
|
|
76
|
-
|
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
|
89
|
-
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
###
|
|
100
|
-
|
|
101
|
-
| العميل |
|
|
102
|
-
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
|
118
|
-
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
|
127
|
-
|
|
128
|
-
|
|
|
129
|
-
|
|
|
130
|
-
|
|
|
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
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
|
138
|
-
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
145
|
-
|
|
|
146
|
-
|
|
|
147
|
-
|
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
|
|
|
151
|
-
|
|
|
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
|
-
|
|
|
161
|
-
|
|
|
162
|
-
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
|
170
|
-
|
|
|
171
|
-
|
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
|
|
|
176
|
-
|
|
|
177
|
-
|
|
|
178
|
-
|
|
|
179
|
-
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
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
|
-
لا يتم تفعيل عميلين لهما نفس الاختصاص (مثل اثنين
|
|
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
|
-
مُهندس يقرر:
|
|
263
|
-
لا يُفعّل:
|
|
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
|
+
> وليس عضوا دائمًا في فريق المشروع.
|