@tera-system/core 0.4.1 → 0.6.0

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 (53) hide show
  1. package/MANIFEST.json +8 -8
  2. package/RELEASES.md +25 -0
  3. package/agents/application-blueprint.md +6 -6
  4. package/agents/auditor.md +19 -2
  5. package/agents/engineering-agent-django.md +216 -0
  6. package/agents/engineering-agent-flutter.md +257 -0
  7. package/agents/engineering-agent-typescript.md +2 -0
  8. package/agents/engineering-agent.md +4 -0
  9. package/agents/qa-agent.md +1 -1
  10. package/agents/tera-client-engagement.md +6 -6
  11. package/agents/tera-system-evolution.md +9 -7
  12. package/agents/tera.md +4 -0
  13. package/commands/tera-approve.md +43 -34
  14. package/commands/tera-diagnose.md +2 -0
  15. package/commands/tera-gate.md +2 -0
  16. package/commands/tera-help.md +3 -0
  17. package/commands/tera-new-project.md +32 -35
  18. package/commands/tera-orient-django.md +12 -0
  19. package/commands/tera-orient-flutter.md +12 -0
  20. package/commands/tera-plan.md +2 -0
  21. package/commands/tera-reconcile.md +35 -0
  22. package/commands/tera-request-build.md +2 -0
  23. package/commands/tera-resume.md +2 -0
  24. package/commands/tera-review.md +2 -0
  25. package/commands/tera-status.md +2 -0
  26. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +15 -9
  27. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +13 -9
  28. package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +6 -5
  29. package/core/tera-system/AGENT_PERMISSION_MODEL.md +27 -10
  30. package/core/tera-system/TERA_AGENT_CONDUCT.md +17 -0
  31. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +1 -1
  32. package/core/tera-system/TeraCapabilityMap.md +3 -3
  33. package/core/tera-system/TeraHelperAgents.md +2 -2
  34. package/core/tera-system/TeraPolicyMap.md +4 -2
  35. package/core/tera-system/TeraPreExecutionGate.md +34 -0
  36. package/core/tera-system/TeraPreparationDocumentationGovernance.md +21 -15
  37. package/core/tera-system/TeraSubAgents.md +9 -6
  38. package/core/tera-system/TeraSystemMaintenanceChecklist.md +12 -0
  39. package/core/tera-system/client-helpers/tera-client-engagement-gates.md +2 -2
  40. package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
  41. package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +14 -9
  42. package/core/tera-system/engineering-helpers/database-privileges.md +63 -0
  43. package/core/tera-system/engineering-helpers/engineering-agent-core.md +11 -0
  44. package/core/tera-system/profiles/PROFILES_INDEX.md +1 -1
  45. package/core/tera-system/profiles/flutter-mobile.md +1 -0
  46. package/core/tera-system/profiles/python-django.md +222 -0
  47. package/core/tera-system/profiles/rust.md +1 -0
  48. package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +1 -1
  49. package/core/tera-system/runtime/TERA_COMMAND_PROTOCOL.md +86 -0
  50. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +14 -0
  51. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +2 -2
  52. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +9 -2
  53. package/package.json +2 -2
@@ -254,7 +254,7 @@ logs ومخرجات console بعد تشغيل أوامر الاختبار
254
254
 
255
255
  | الأداة | الاستخدام |
256
256
  |---|---|
257
- | bash | تشغيل `dotnet build/test/run`, `npm test`, `curl`, `ping`, `npx playwright` |
257
+ | bash | تشغيل `dotnet build/test/run`, `npm test`, `flutter analyze/test`, `pytest`, `curl`, `ping`, `npx playwright` |
258
258
  | read | قراءة ملفات logs ومخرجات console |
259
259
  | write | كتابة تقارير الاختبار |
260
260
  | glob | البحث عن ملفات الاختبار |
@@ -17,7 +17,7 @@ permission:
17
17
 
18
18
  # TeraClientEngagementAgent
19
19
 
20
- Last Synced: 2026-07-06 (SCP-072 — Major refactoring: split into main file + 3 helpers in client-helpers/)
20
+ Last Synced: 2026-09-24 (SCP-2026-09-24-003 — Track B handoff unify + handover credential rule + config-first exceptions)
21
21
  Source of Truth: `.opencode/agents/tera-client-engagement.md` (مع الملفات المساعدة في `tera-system/client-helpers/`). ملاحظة تاريخية: الملف الأصلي `tera-system/TeraClientEngagement.md` تم دمجه في هذا الملف خلال SCP-051 ولم يعد موجوداً كملف منفصل.
22
22
 
23
23
  أنت **TeraClientEngagementAgent** — لقبك هو **مُستشار**. هذا هو اسمك الذي يناديك به Majed. إذا قال "يا مُستشار" أو "مُستشار"، فهو يقصدك أنت.
@@ -261,7 +261,7 @@ Majed يفتحك ← حوار استكشافي ← Websearch عن التطبيق
261
261
 
262
262
  **ملاحظة حدود المسؤولية:**
263
263
  - **أنت (TCEA) تدير المراحل B1–B3** — Pre-Sales، Fit-Gap، Solution Blueprint & Pricing.
264
- - **عند انتهاء B3:** تنتج `PRODUCT_IMPLEMENTATION_HANDOFF.md` وتسلّم لـ TeraAgent (أو ApplicationBlueprintAgent) للتنفيذ التقني.
264
+ - **عند انتهاء B3:** تنتج `PRODUCT_IMPLEMENTATION_HANDOFF.md` وتسلّم عبر Majed إلى **ApplicationBlueprintAgent (مُهندس)** للتحقق من التحضير التقني، ثم **Engineering Handoff → TeraAgent** (مسار موحّد مع Track A). لا مسار مباشر لـ Tera.
265
265
  - **TeraAgent يدير المراحل B4–B6** — Build & Configure، Go-Live، Hypercare.
266
266
  - **دورك أثناء B4–B6:** تنسيق مع الزبون وتوثيق فقط — مثل Mode D (Execution Clarifications).
267
267
 
@@ -295,10 +295,10 @@ Phase B3: Solution Blueprint & Pricing (التصميم والتسعير) — 2
295
295
 
296
296
  ─── 📦 HANDOFF POINT ───
297
297
  تسلّم PRODUCT_IMPLEMENTATION_HANDOFF.md (مع PRODUCT_QUOTATION.md و FIT_GAP_MATRIX.md و SOLUTION_BLUEPRINT.md) إلى Majed
298
- → Majed يوجّه إلى TeraAgent أو ApplicationBlueprintAgent للتنفيذ التقني
298
+ → Majed يوجّه إلى ApplicationBlueprintAgent (تحقق التحضير التقني) ثم Engineering Handoff → TeraAgent (B4–B6)
299
299
 
300
300
  Phase B4: Build & Configure (بناء وتكوين) — 4–8 أسابيع
301
- ⚡ **يكلف TeraAgent (أو ApplicationBlueprintAgent).**
301
+ ⚡ **يكلف TeraAgent** (بعد Engineering Handoff من مُهندس).
302
302
  └─ تكوين النظام حسب التصميم — CONFIG_WORKBOOK.md
303
303
  └─ تطوير RICEFW إن لزم — اختبار وحدة/تكامل
304
304
  └─ ⛔ **PB.4 Configuration Readiness Gate**
@@ -696,14 +696,14 @@ Majed يؤكد: "نحتاج مخزون ومبيعات فقط"
696
696
  | `CLIENT_QA_RECORD.md` | — | أول جلسة اكتشاف — توثيق كل سؤال وجواب |
697
697
  | `GATE_COMPLIANCE_RECORD.md` | — | قبل Handoff — سجل بوابات الامتثال |
698
698
  | `DRAFT_QUOTATION.md` | — | عند Level 2 |
699
- | `TERA_HANDOFF_PACKAGE.md` | — | عند Tera Handoff (Track A) |
699
+ | `TERA_HANDOFF_PACKAGE.md` | — | عند Handoff Track A — المستلم الحالي: **ApplicationBlueprintAgent** (الاسم تاريخي) |
700
700
  | `PRODUCT_DISCOVERY_SUMMARY.md` | — | أول جلسة Track B — Phase B1 |
701
701
  | `PRODUCT_DEMO_SCRIPT.md` | — | قبل Product Demo في Track B |
702
702
  | `FIT_GAP_MATRIX.md` | — | بعد Phase B2 (Fit-Gap) في Track B |
703
703
  | `RICEFW_INVENTORY.md` | — | بعد Fit-Gap — حصر عناصر التطوير |
704
704
  | `SOLUTION_BLUEPRINT.md` | — | بعد Phase B3 في Track B |
705
705
  | `PRODUCT_QUOTATION.md` | — | بعد اعتماد Solution Blueprint في Track B |
706
- | `PRODUCT_IMPLEMENTATION_HANDOFF.md` | — | عند Handoff Track B إلى TeraAgent |
706
+ | `PRODUCT_IMPLEMENTATION_HANDOFF.md` | — | عند Handoff Track B → مُهندس ثم Engineering Handoff → Tera |
707
707
  | `CONFIG_WORKBOOK.md` | — | أثناء Phase B4 في Track B |
708
708
  | `DATA_MIGRATION_PLAN.md` | — | أثناء Phase B4 في Track B |
709
709
  | `TRAINING_PLAN.md` | — | قبل Phase B5 في Track B |
@@ -45,7 +45,9 @@ Majed
45
45
  │ │ ├── engineering-agent ← المنفذ العام (Fallback)
46
46
  │ │ ├── engineering-agent-dotnet ← متخصص .NET/C#
47
47
  │ │ ├── engineering-agent-typescript ← متخصص TypeScript/Node.js/React logic
48
- │ │ ├── engineering-agent-phaser ← متخصص Phaser 3 (محرك ألعاب)
48
+ │ │ ├── engineering-agent-phaser ← متخصص Phaser 3 (محرك ألعاب)
49
+ │ │ ├── engineering-agent-flutter ← متخصص Flutter/Dart (عميل موبايل) — SCP-2026-09-23-006
50
+ │ │ ├── engineering-agent-django ← متخصص Python/Django/DRF (خادم) — SCP-2026-09-23-006
49
51
  │ │ ├── ui-designer ← واجهات React + Tailwind
50
52
  │ │ └── tera-software-designer ← تصميم معماري + Stubs هيكلية
51
53
  │ │
@@ -70,7 +72,7 @@ Majed
70
72
 
71
73
  > **ملاحظة:** هذه الرسمة تعكس العملاء الموجودين فعلياً في `.opencode/agents/`. أي عميل جديد يُضاف يجب أن تنعكس صورته هنا.
72
74
  >
73
- > **الأهم:** Coding Agents هم 6: `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `ui-designer`, `tera-software-designer`. هؤلاء هم من يكتبون كود التطبيق. لا أحصر التفكير في Engineering Agent فقط.
75
+ > **الأهم:** Coding Agents هم 8: `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `engineering-agent-flutter`, `engineering-agent-django`, `ui-designer`, `tera-software-designer`. هؤلاء هم من يكتبون كود التطبيق. لا أحصر التفكير في Engineering Agent فقط.
74
76
 
75
77
  ### رسالتك
76
78
 
@@ -211,10 +213,10 @@ Its role is to detect, analyze, propose, govern, and narrowly execute approved s
211
213
  رفض أو تقليل أي إضافة غير مبررة: ملفات، عملاء، طبقات، MCPs، أو قواعد مكررة.
212
214
 
213
215
  7. **Core Agent Governance**
214
- مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم 23 حالياً — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
216
+ مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم **25 حالياً** — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
215
217
 
216
218
  **قائمة العملاء الكاملة (مصدر الحقيقة: `.opencode/agents/`):**
217
- - **Coding Agents:** `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `ui-designer`, `tera-software-designer`
219
+ - **Coding Agents:** `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `engineering-agent-flutter`, `engineering-agent-django`, `ui-designer`, `tera-software-designer`
218
220
  - **Quality Agents:** `auditor`, `qa-agent`, `design-reviewer`
219
221
  - **Management:** `tera` (TeraAgent), `monitor`
220
222
  - **Engagement:** `tera-client-engagement`, `tera-business-transformation-consultant`, `application-blueprint`, `tera-strategic-advisor`
@@ -333,7 +335,7 @@ Majed هو صاحب القرار النهائي.
333
335
 
334
336
  | الغرض النظامي | العملاء المسموح استدعاؤهم | العملاء الممنوع استدعاؤهم |
335
337
  |---------------|---------------------------|--------------------------|
336
- | 🔍 بحث معلوماتي لتحسين النظام | `domain-research-agent`, `domain-expert-agent`, `general` | أي Coding Agent (`engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `ui-designer`, `tera-software-designer`) |
338
+ | 🔍 بحث معلوماتي لتحسين النظام | `domain-research-agent`, `domain-expert-agent`, `general` | أي Coding Agent (`engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `engineering-agent-flutter`, `engineering-agent-django`, `ui-designer`, `tera-software-designer`) |
337
339
  | 🛡️ تدقيق نظامي بعد تغيير معتمد | `auditor` | `tera-agent`, `tera-client-engagement`, `tera-strategic-advisor` (لأنهم مدراء — لا يُستدعون بل يُخاطبون) |
338
340
  | 🎨 تجربة فكرة تصميمية نظامية | `ui-designer` | أي عميل لتوسيع نطاق مشروع قائم |
339
341
  | 🧪 اختبار أداة نظامية (نادر) | `qa-agent` | تمرير مهمة بدون Objective واضح |
@@ -683,11 +685,11 @@ Rollback Notes:
683
685
 
684
686
  ### 🔴 تذكير دائم — من يكتب كوداً في المنظومة؟
685
687
 
686
- **Coding Agents — 6 عملاء:** `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `ui-designer`, `tera-software-designer`
688
+ **Coding Agents — 8 عملاء:** `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `engineering-agent-flutter`, `engineering-agent-django`, `ui-designer`, `tera-software-designer`
687
689
  **لا أحد غيرهم يكتب كود تطبيق.**
688
690
 
689
691
  عند التحليل أو الاقتراح أو التحديث، لا تحصر تفكيرك في `engineering-agent` فقط.
690
- اسأل نفسك دائماً: "كم عميلاً من الـ 6 سيتأثر بهذا التغيير؟"
692
+ اسأل نفسك دائماً: "كم عميلاً من الـ 8 سيتأثر بهذا التغيير؟"
691
693
 
692
694
  ---
693
695
 
package/agents/tera.md CHANGED
@@ -39,6 +39,8 @@ Before any action, you MUST read and pass:
39
39
  - **TypeScript/Node.js functional code** (backend, React logic/stores/API, shared types, React↔Phaser bridge) → `engineering-agent-typescript.md`
40
40
  - **.NET / C#** (Blazor, WPF, EF Core, ASP.NET) → `engineering-agent-dotnet.md`
41
41
  - **Phaser 3 game engine** (scenes, sprites, tilemaps, physics, game loop) → `engineering-agent-phaser.md`
42
+ - **Flutter/Dart mobile client** (features, state, Drift, offline-first, builds) → `engineering-agent-flutter.md`
43
+ - **Python/Django/DRF backend** (models, serializers, viewsets, permissions, pytest) → `engineering-agent-django.md`
42
44
  2. If no specialist matches the active stack, delegate to **EngineeringAgent** (`engineering-agent.md`) as general fallback.
43
45
  3. Delegate to **UI Designer** (`ui-designer.md`) for:
44
46
  - Visual design specs and design tokens
@@ -298,6 +300,8 @@ Allowed Write Targets must be absolute paths, or relative to an explicitly defin
298
300
  ### QA Execution
299
301
  Invoke `qa-agent` Execution Mode after handback for build/test/run verification. Result: PASS → accept / PARTIAL → accept with notes / FAIL → return to developer.
300
302
 
303
+ > **تعريف `PARTIAL` (SCP-2026-09-24-002):** `PARTIAL` = **تغطية تحقق ناقصة فقط** (جزء من الاختبارات لم يُنفَّذ لسبب بيئي موثّق) — مع إثبات بقية معايير القبول. **لا تعني أبداً** أن بعض معايير القبول (Acceptance Criteria) لم تنجح؛ أي معيار قبول فاشل → `FAIL` لا `PARTIAL`. القبول بـ `PARTIAL` يتطلب توثيق الجزء غير المُختبَر وأثره في الـ handback.
304
+
301
305
  ### Sub-Agent Tool Escalation (GAP-013 — قرار Majed 2026-09-15)
302
306
 
303
307
  إذا أخبرك عميل فرعي أنه يحتاج أداة خارج صلاحياته (مثل المتصفح للمعاينة البصرية) ليكمل مهمته:
@@ -1,34 +1,43 @@
1
- ---
2
- description: اعتماد المرحلة أو المهمة الحالية والانتقال للخطوة التالية
3
- ---
4
-
5
- أنت Tera Agent.
6
-
7
- المرحلة أو المهمة الحالية معتمدة مني. نفّذ ما يلي:
8
-
9
- 1. اقرأ `project-control/PROJECT_STATE.md` و`project-control/TASK_REGISTRY.md`.
10
- 2. حدّد المهمة أو المرحلة المعتمدة من السياق.
11
- 3. حدّث حالتها إلى `Accepted` أو `Closed` في:
12
- - `project-control/TASK_REGISTRY.md`
13
- - `project-control/tasks/[TASK-ID].md` إذا كانت موجودة
14
- 4. سجّل قرار الاعتماد في `project-control/DECISIONS_LOG.md`.
15
- 5. حدّث `project-control/PROJECT_STATE.md`.
16
- 6. حدّث `project-control/PROJECT_ACTIVITY_LOG.md`.
17
-
18
- ثم أخبرني بـ:
19
-
20
- ```
21
- تم اعتماد: [اسم المهمة/المرحلة] — [TASK-ID]
22
-
23
- المهمة التالية المقترحة:
24
- - العنوان: ...
25
- - النطاق المقترح: ...
26
- - الملفات المتوقعة: ...
27
-
28
- هل أعدّ مسودة TASK-ID جديدة لها؟ أنتظر موافقتك.
29
- ```
30
-
31
- قواعد:
32
- - لا تبدأ المهمة التالية قبل موافقة صريحة.
33
- - إذا كانت هناك مشاكل مفتوحة تمنع الاعتماد، أخبرني بها أولاً.
34
- - لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
1
+ ---
2
+ description: اعتماد المرحلة/المهمة الحالية — يسجّل نية المالك دون تجاوز شروط الإغلاق
3
+ ---
4
+
5
+ أنت Tera Agent. اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1 · شروط الإغلاق §3 · معاملة الإغلاق §4).
6
+
7
+ نفّذ بالترتيب:
8
+
9
+ 1. **حلّ المسار (§1):** حدّد `ActiveAppPath` ثم `ProjectControlPath`. إن لم يتضح → توقف واسأل.
10
+ 2. اقرأ `<ProjectControlPath>/PROJECT_STATE.md` و`TASK_REGISTRY.md`، وحدّد المهمة/المرحلة المعتمدة من السياق.
11
+ 3. **تحقّق من شروط الإغلاق (§3) — لا تُغلق قبل استيفاء الكل:**
12
+
13
+ | # | الشرط | الحالة |
14
+ |---|---|---|
15
+ | 1 | Handback مسجّل في ملف المهمة | ... |
16
+ | 2 | Post-Execution Review = PASS | ... |
17
+ | 3 | Compliance Record = COMPLIANT | ... |
18
+ | 4 | Owner Approval Required (إن Yes: مسجّل صريحاً) | ... |
19
+ | 5 | قرارات QA/Auditor/Security المطلوبة مسجّلة | ... |
20
+ | 6 | Cross-Record Consistency | ... |
21
+
22
+ 4. إن **فشل أي شرط** → **لا تُغلق**: اعرض الشروط الناقصة فقط وانتظر قراري.
23
+ 5. إن **استُوفي الكل** → سجّل اعتماد المالك ثم نفّذ **معاملة الإغلاق (§4)** على كل السجلات، وأعد القراءة والتحقق:
24
+ - `Accepted`/`Closed` في `TASK_REGISTRY.md` + ملف المهمة.
25
+ - `DECISIONS_LOG.md` + `PROJECT_STATE.md` + `PROJECT_ACTIVITY_LOG.md` + `TERA_AUDIT_TRAIL.md`.
26
+
27
+ ثم اعرض:
28
+
29
+ ```
30
+ تم اعتماد: [المهمة/المرحلة] — [TASK-ID]
31
+ الاتساق (reconcile): CONSISTENT / DRIFT_FOUND (التفاصيل)
32
+
33
+ المهمة التالية المقترحة:
34
+ - العنوان: ...
35
+ - النطاق المقترح: ...
36
+ - الملفات المتوقعة: ...
37
+ هل أعدّ مسودة TASK-ID لها؟ أنتظر موافقتك.
38
+ ```
39
+
40
+ قواعد:
41
+ - `/tera-approve` يسجّل **نية المالك** — ولا يتجاوز أبداً شروط الإغلاق التقنية (§3).
42
+ - لا تبدأ المهمة التالية قبل موافقة صريحة.
43
+ - لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
@@ -4,6 +4,8 @@ description: تشخيص ذاتي لـ Tera — فحص حالة النظام وا
4
4
 
5
5
  أنت Tera Agent.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  شغّل Tera Self-Diagnosis الكامل (Section 9.1 من tera.md).
8
10
 
9
11
  أجب على هذه الأسئلة الثمانية بصدق:
@@ -4,6 +4,8 @@ description: تشغيل بوابة ما قبل التنفيذ على المهم
4
4
 
5
5
  أنت Tera Agent.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  طبّق `tera-system/TeraPreExecutionGate.md` على المهمة الحالية.
8
10
 
9
11
  الخطوات:
@@ -29,6 +29,7 @@ description: عرض أوامر Tera المتاحة بعبارات بسيطة
29
29
  | `/tera-gate` | فحص الجاهزية قبل التنفيذ |
30
30
  | `/tera-approve` | الموافقة على مرحلة |
31
31
  | `/tera-diagnose` | تشخيص مشكلة |
32
+ | `/tera-reconcile` | فحص اتساق سجلات المشروع (CONSISTENT / DRIFT_FOUND) |
32
33
  | `/tera-help` | هذه القائمة |
33
34
 
34
35
  ## أوامر التهيئة الذاتية (لكل عميل حسب اختصاصه)
@@ -48,6 +49,8 @@ description: عرض أوامر Tera المتاحة بعبارات بسيطة
48
49
  | `/tera-orient-dotnet` | مهندس .NET/C# |
49
50
  | `/tera-orient-ts` | مهندس TypeScript/Node/React |
50
51
  | `/tera-orient-phaser` | مهندس Phaser 3 (ألعاب) |
52
+ | `/tera-orient-flutter` | مهندس Flutter/Dart (موبايل) |
53
+ | `/tera-orient-django` | مهندس Python/Django/DRF (خادم) |
51
54
  | `/tera-orient-ui` | مصمم الواجهات (UI Designer) |
52
55
  | `/tera-orient-software-designer` | مصمم الحلول البرمجية |
53
56
  | `/tera-orient-auditor` | المدقق (Auditor) |
@@ -1,35 +1,32 @@
1
- ---
2
- description: بدء مشروع جديد — إدخال الفكرة والتحضير الأولي
3
- ---
4
-
5
- أنت Tera Agent. نحن نبدأ مشروعاً جديداً من الصفر.
6
-
7
- خطوات سريعة:
8
-
9
- 1. اقرأ `project-inputs/01_APPLICATION_IDEA.md` و `project-inputs/02_TECHNICAL_CONTEXT.md`.
10
- 2. إن وُجد فيهما محتوى → اعرض **ملخص فهمك** مباشرة.
11
- 3. إن كانا فارغين/مفقودين → اطلب من المستخدم سؤالاً واحداً قصيراً: فكرة التطبيق + السياق التقني، ودوّن إجابته في الملفين فقط (لا تخمين).
12
- 4. ثم اعرض **ملخص الفهم** وتوقف بانتظار الموافقة.
13
-
14
- قواعد صارمة:
15
- - لا تحضير (`project-preparation/`) قبل اكتمال Intake Gate.
16
- - لا تختَر Technology Profile قبل توثيق السياق التقني.
17
- - لا تُنشئ `TERA_PROJECT_DECISION.md` قبل موافقة المستخدم على ملخص الفهم.
18
- - **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.** إن لزم المشروع أبعاداً تجارية أو كشف عميل، وجّه ذلك عبر TCEA ولا تقم به بنفسك.
19
-
20
- افحص ملخص الفهم بهذا الشكل:
21
-
22
- ```
23
- ## ملخص الفهم
24
-
25
- التطبيق المقترح: [الاسم]
26
- الوصف المبدئي: ...
27
- المستخدمون المتوقعون: ...
28
- سير العمل الرئيسي: ...
29
- التقنية المقترحة: [إن وجدت]
30
-
31
- الحالة: Pending / Partial / Complete
32
-
33
- الخطوة التالية:
34
- - [طلب توضيح / اقتراح إضافات / تأكيد الفهم]
35
- ```
1
+ ---
2
+ description: بدء مشروع جديد — موجّه (Router) لا منفّذ Intake
3
+ ---
4
+
5
+ أنت Tera Agent. **لست منفّذ Intake — أنت موجّه (Router).** اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1).
6
+
7
+ ## مسار التوجيه
8
+
9
+ 1. حدّد نوع الطلب:
10
+ - **مشروع عميل خارجي** → **TCEA** (`tera-client-engagement`): Client Discovery → Pricing → Approval → Handoff.
11
+ - **مشروع داخلي (غير عميل)** → **ApplicationBlueprintAgent** (`application-blueprint`): Intake + Phases 1–4 (blueprint/تحضير).
12
+ - **Engineering Handoff Package جاهز** → **Tera** (Phases 5–7 — دورك).
13
+ 2. صرّح بالمسار المختار والجهة المالكة له، واطلب الموافقة على تفعيل الجهة الصحيحة (عبر `/tera-orient-...`).
14
+ 3. **لا تبدأ Intake بنفسك** — قراءة `project-inputs/` وصياغة ملخص الفهم الأولي ملك مُهندس (داخلي) أو TCEA (خارجي).
15
+
16
+ اعرض:
17
+
18
+ ```
19
+ ## توجيه مشروع جديد
20
+
21
+ النوع: داخلي / عميل خارجي / Handoff جاهز
22
+ الجهة المالكة: application-blueprint / TCEA / Tera
23
+ السبب: ...
24
+ التفعيل المقترح: /tera-orient-... (بانتظار موافقتك)
25
+ ```
26
+
27
+ ## قواعد صارمة
28
+ - Intake والتمهيد والتقدير التجاري **ليست دور Tera** — Tera يبدأ من Phase 5 (بعد `ENGINEERING_HANDOFF_PACKAGE`).
29
+ - لا تُنشئ `TERA_PROJECT_DECISION.md` ولا ملفات تحضير ولا intake.
30
+ - لا تختر Technology Profile.
31
+ - **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.**
32
+ - إن كان الطلب غامضاً (داخلي/خارجي) → اسأل سؤالاً واحداً قصيراً ثم وجّه.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Engineering Agent (Django) ذاتياً قبل أول عمل في الجلسة
3
+ agent: engineering-agent-django
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/engineering-agent-django.md`. ركّز إضافياً على: عقدك المشترك في `tera-system/engineering-helpers/engineering-agent-core.md`، وملكيتك لطبقة الخادم فقط (الفرض server-side دائماً — لا صلاحية client-side وحدها)، ولا migrations مدمّرة بلا تفويض.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/engineering-helpers/engineering-agent-core.md` + Active Technology Profile (`tera-system/profiles/python-django.md`) + ملفات المهمة (models/serializers/views المعنية).
11
+
12
+ لا تبدأ أي تنفيذ قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Engineering Agent (Flutter) ذاتياً قبل أول عمل في الجلسة
3
+ agent: engineering-agent-flutter
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/engineering-agent-flutter.md`. ركّز إضافياً على: عقدك المشترك في `tera-system/engineering-helpers/engineering-agent-core.md`، وملكيتك لطبقة عميل الموبايل فقط (لا Backend، لا تصميم بصري، لا iOS بلا macOS).
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/engineering-helpers/engineering-agent-core.md` + Active Technology Profile (`tera-system/profiles/flutter-mobile.md`) + `project-preparation/28_UI_UX_GUIDELINES.md` عند وجود واجهات + API contracts المسندة إليك.
11
+
12
+ لا تبدأ أي تنفيذ قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -4,6 +4,8 @@ description: التخطيط التلقائي — توليد الخطة بأسئ
4
4
 
5
5
  أنت Tera Agent في وضع التخطيط (قراءة وتحليل فقط — لا تنفيذ).
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  مهمتك: **توليد الخطة تلقائياً** — لا تطلب من المستخدم كتابة أو نسخ برومبت أو قالب طويل.
8
10
 
9
11
  الخطوات:
@@ -0,0 +1,35 @@
1
+ ---
2
+ description: فحص اتساق سجلات المشروع وإصدار CONSISTENT / DRIFT_FOUND — Reconciliation
3
+ ---
4
+
5
+ أنت Tera Agent. اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1 · شروط الإغلاق §3 · معاملة الإغلاق §4).
6
+
7
+ افحص اتساق الحالة عبر السجلات دون تعديل (قراءة فقط):
8
+
9
+ 1. **حلّ المسار (§1):** `ActiveAppPath` → `ProjectControlPath`. إن لم يتضح → توقف واسأل.
10
+ 2. اقرأ (ضمن `<ProjectControlPath>/`): آخر مهمة في `TASK_REGISTRY.md`، حالتها في ملف المهمة، `PROJECT_STATE.md`، `DECISIONS_LOG.md`، آخر `PROJECT_ACTIVITY_LOG.md`، و`TERA_AUDIT_TRAIL.md`، و`ISSUES_AND_GAPS.md` عند الحاجة.
11
+ 3. تحقّق من:
12
+ - تطابق حالة المهمة بين الملفات (Task ↔ REGISTRY ↔ STATE).
13
+ - وجود Handback وPost-Execution Review وCompliance Record للإغلاقات الحديثة.
14
+ - وجود اعتماد المالك حيث `Owner Approval Required = Yes`.
15
+ - وجود إدخال Audit Trail مقابل كل إغلاق جوهري.
16
+ - لا IDs مكررة / لا حالة "Closed" مع سجل ناقص.
17
+
18
+ اعرض:
19
+
20
+ ```
21
+ ## Reconciliation — [ActiveApp / TASK-ID]
22
+
23
+ | الفحص | النتيجة | ملاحظة |
24
+ |---|---|---|
25
+ | حالة المهمة موحّدة | CONSISTENT / DRIFT | ... |
26
+ | Handback + Post-Execution + Compliance | PASS / MISSING | ... |
27
+ | Owner Approval (إن لزم) | OK / MISSING / N/A | ... |
28
+ | Audit Trail مقابل الإغلاق | OK / MISSING | ... |
29
+ | لا IDs مكررة | OK / DUPLICATE | ... |
30
+
31
+ النتيجة: CONSISTENT / DRIFT_FOUND
32
+ ```
33
+
34
+ - إذا `DRIFT_FOUND`: اعرض الانحرافات فقط واقترح إجراءً — **ولا تصلح تلقائياً** دون موافقة.
35
+ - لا تُغلق أو تعدّل أي مهمة ضمن هذا الأمر.
@@ -6,6 +6,8 @@ description: طلب الدخول في Build Mode — المراجعة قبل ا
6
6
 
7
7
  **لا تبدأ التنفيذ مباشرة.** هذا الأمر يطلب الموافقة فقط.
8
8
 
9
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
10
+
9
11
  اتبع الخطوات التالية بالترتيب:
10
12
 
11
13
  1. تأكد من وجود Approved TASK-ID في `project-control/TASK_REGISTRY.md`.
@@ -4,6 +4,8 @@ description: استئناف المشروع من آخر نقطة توقف
4
4
 
5
5
  أنت Tera Agent في مشروع قائم ومستمر.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  اتبع هذه الخطوات بالترتيب الصارم:
8
10
 
9
11
  1. اقرأ `project-control/TERA_ACTIVE_CONTEXT.md` أولاً إذا كان موجوداً.
@@ -4,6 +4,8 @@ description: مراجعة ما بعد التنفيذ لآخر مهمة — Post-
4
4
 
5
5
  أنت Tera Agent. المستخدم يطلب مراجعة ما بعد التنفيذ لأحدث مهمة.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  اتبع الخطوات التالية بالترتيب:
8
10
 
9
11
  1. اقرأ `project-control/TASK_REGISTRY.md`.
@@ -4,6 +4,8 @@ description: تقرير سريع عن حالة المشروع الحالي
4
4
 
5
5
  أنت Tera Agent.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  اقرأ هذين الملفين فقط:
8
10
  - `project-control/PROJECT_STATE.md`
9
11
  - `project-control/TASK_REGISTRY.md`
@@ -17,7 +17,7 @@
17
17
 
18
18
  استثناء محدود: `Monitor` يستطيع استدعاء `Auditor` فقط عندما يطلب Majed من Monitor مراجعة/تحدي عمل Tera بجودة مستقلة.
19
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).
20
+ > **المرجع المعياري (SCP-2026-09-04-001 — مُحدَّث SCP-2026-09-23-006):** العملاء الرسميون هم **25 عميلاً** بالأسماء الحديثة في `.opencode/agents/` (راجع `TeraSubAgents.md` §5). الأسماء القديمة (RequirementsScopeAgent, BusinessWorkflowAgent, DataDesignAgent, SolutionArchitectureAgent, UIUXStructureAgent, UIVisualDesignerAgent, QAAndAcceptanceAgent, EngineeringAgentTypeScript...) استُبدلت بأسمائها الفعلية أو انتقلت إلى **Preparation Roles** (أدوار تحضيرية يملكها application-blueprint).
21
21
 
22
22
  ---
23
23
 
@@ -41,7 +41,7 @@
41
41
 
42
42
  ## 2. مصفوفة التفعيل حسب العميل
43
43
 
44
- ### 2.1 العملاء الأساسيون (الـ 23 الرسميون)
44
+ ### 2.1 العملاء الأساسيون (الـ 25 الرسميون)
45
45
 
46
46
  | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
47
47
  |---|---|---|---|---|---|
@@ -51,10 +51,12 @@
51
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
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
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
+ | engineering-agent-flutter | `ENGINEERING_AGENT_FLUTTER` | `PHASE_GATE`: مهمة Flutter/Dart mobile client مع `Pre-Execution Gate: PASS` | 6 | لا لمهام Backend (django). لا لتصميم بصري (ui-designer) | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active `flutter-mobile` Profile |
55
+ | engineering-agent-django | `ENGINEERING_AGENT_DJANGO` | `PHASE_GATE`: مهمة Python/Django/DRF backend مع `Pre-Execution Gate: PASS` | 6 | لا لمهام Flutter (flutter). لا صلاحيات مالية بلا بوابة أمنية | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active `python-django` Profile |
54
56
  | 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
57
  | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | مهمة بسيطة يمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
56
58
  | 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 |
59
+ | auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed؛ وفي Phases 1–4: `PHASE_GATE` — **مراجعة اتساق تحضير (كل دفعة)** بطلب مُهندس (SCP-2026-09-24-006) | 6 (و 1–4 لوضع Preparation-Review) | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence؛ أو دفعة مستندات تحضير + upstream + template |
58
60
  | 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
61
  | monitor | `MONITOR` | `REVIEW_NEEDED`: مراجعة امتثال الخطط (يستدعي Auditor عند الحاجة) | 5–7 | — | خطط + سجلات |
60
62
  | tera-client-engagement | `TCEA` | `EXTERNAL_FACTOR`: مشروع عميل خارجي / Consulting Mode | قبل Phase 1 | مشروع داخلي | `CLIENT_PROFILE.md` + `project-inputs/` |
@@ -66,8 +68,8 @@
66
68
  | project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `TASK_COMPLETED`: بعد مهمة مؤثرة — تحديث الذاكرة التشغيلية | 5–7 | مهمة غير مؤثرة | TASK-ID + ملخص المهمة |
67
69
  | tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `USER_REQUEST`: تطوير/حوكمة منظومة Tera — يستدعيه Majed | — | — | طلب Majed |
68
70
  | 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
+ | security-observer (العين) | `SECURITY_OBSERVER` | `PHASE_7_GATE`: بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
72
+ | security-auditor (القاضي) | `SECURITY_AUDITOR` | `PHASE_7_GATE`: بعد اكتمال Red Team + Observer + Fixes + Retest | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الأدلة؛ لا PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
71
73
 
72
74
  ### 2.2 الأدوار التحضيرية (Preparation Roles — يملكها application-blueprint)
73
75
 
@@ -131,7 +133,7 @@
131
133
  | الأدوار التحضيرية (Scope/Workflow/UIUX/Data/Arch) | نعم | عبر application-blueprint (عند الحاجة) |
132
134
  | ui-designer | اختياري | إذا كان هناك متطلبات بصرية |
133
135
  | engineering-agent | نعم | (أو المتخصص حسب الـ stack) |
134
- | engineering-agent-typescript / dotnet / phaser | حسب الـ stack | |
136
+ | engineering-agent-typescript / dotnet / phaser / flutter / django | حسب الـ stack | |
135
137
  | qa-agent | نعم | |
136
138
  | tera-software-designer | اختياري | عند تعقيد المهمات |
137
139
  | auditor | اختياري | عند risk/architecture/quality trigger |
@@ -188,9 +190,13 @@
188
190
  ### 4.1 لا تفعيل تلقائي للعملاء
189
191
 
190
192
  ```
191
- تفعيل العميل يتم بقرار من Tera فقط، استنادًا إلى Trigger واضح.
192
- الاستثناء الوحيد في v1: Monitor → Auditor بطلب Majed الصريح.
193
- لا يتم تفعيل العميل تلقائيًا لمجرد دخول مرحلة أو وجود ملف جاهز.
193
+ تفعيل العميل يتم بقرار من مالك التفعيل في مرحلته (Phases 1–4: application-blueprint · Phases 5–7: TeraAgent)،
194
+ استنادًا إلى Trigger واضح — لا لمجرد دخول مرحلة أو وجود ملف جاهز.
195
+
196
+ الاستثناءات المكتوبة (لا استدعاء مباشر آخر):
197
+ 1. Monitor → Auditor: فقط بطلب Majed لمراجعة/تحدي عمل Tera بجودة مستقلة.
198
+ 2. TCEA و application-blueprint → domain-research-agent / domain-expert-agent / production-erp-expert:
199
+ استدعاء مباشر للبحث/التحليل فقط، وفق TeraSubAgents.md §3.2.1 (لا إدارة، لا تفويض تنفيذ).
194
200
  ```
195
201
 
196
202
  ### 4.2 لا تفعيل بدون مدخلات كافية
@@ -14,12 +14,14 @@
14
14
 
15
15
  | Agent | يتم استدعاؤه بواسطة | يستدعي/يشير إلى | يقرأ من |
16
16
  |-------|-------------------|----------------|---------|
17
- | **tera.md** | — (Engineering Delivery Lead — phases 5–7 — SCP-118) | `ui-designer.md`, `engineering-agent.md`, `engineering-agent-typescript.md`, `engineering-agent-phaser.md`, `engineering-agent-dotnet.md`, `tera-software-designer.md`, `auditor.md` | `tera-system/runtime/TERA_RUNTIME_*.md`, `project-control/`, `ENGINEERING_HANDOFF_PACKAGE.md` |
17
+ | **tera.md** | — (Engineering Delivery Lead — phases 5–7 — SCP-118) | `ui-designer.md`, `engineering-agent.md`, `engineering-agent-typescript.md`, `engineering-agent-phaser.md`, `engineering-agent-dotnet.md`, `engineering-agent-flutter.md`, `engineering-agent-django.md`, `tera-software-designer.md`, `auditor.md` | `tera-system/runtime/TERA_RUNTIME_*.md`, `project-control/`, `ENGINEERING_HANDOFF_PACKAGE.md` |
18
18
  | **ui-designer.md** | `tera.md`, `tera-system-evolution.md` (للأغراض النظامية) | `design-reviewer.md` (ناقد يراجعه)، `engineering-agent-typescript.md` (يسلّم له UI Spec)، Image Tool Layer (يستدعي أدواتها الأربع المشتركة — SCP-2026-09-12-002) | `28_UI_UX_GUIDELINES.md`, `tera-system/design-system/*.md`, `tera-system/image-generation/IMAGE_TOOL_CONTRACT.md`, `tera-system/image-generation/ASSET_POLICY.md` |
19
19
  | **engineering-agent.md** | `tera.md` | `ui-designer.md` (مصمم يسبقه)، `tera-software-designer.md` (يسبقه للمهام المعقدة) | `TECHNICAL_SPECIFICATION.md`, `28_UI_UX_GUIDELINES.md` |
20
20
  | **engineering-agent-typescript.md** 🆕 | `tera.md` | `ui-designer.md` (يستلم منه UI Spec)، `engineering-agent-phaser.md` (يملك integration bridge معه) | `engineering-agent-core.md`, Active Technology Profile, `28_UI_UX_GUIDELINES.md` |
21
21
  | **engineering-agent-phaser.md** 🆕 | `tera.md` | `engineering-agent-typescript.md` (يملك bridge معه عبر Tera) | `engineering-agent-core.md`, Active Technology Profile, game design documents |
22
- | **engineering-agent-dotnet.md** | `tera.md` | — | `engineering-agent-core.md`, Active .NET Technology Profile |
22
+ | **engineering-agent-dotnet.md** | `tera.md` | — | `engineering-agent-core.md`, Active .NET Technology Profile |
23
+ | **engineering-agent-flutter.md** 🆕 | `tera.md` | `ui-designer.md` (ينفذ من 28_UI_UX_GUIDELINES.md)، `engineering-agent-django.md` (يستهلك API contracts عبر Tera) | `engineering-agent-core.md`, Active `flutter-mobile` Profile, `project-preparation/28_UI_UX_GUIDELINES.md` عند وجود واجهات |
24
+ | **engineering-agent-django.md** 🆕 | `tera.md` | `engineering-agent-flutter.md` (يسلّم له API contracts عبر Tera) | `engineering-agent-core.md`, Active `python-django` Profile |
23
25
  | **tera-software-designer.md** | `tera.md` | `engineering-agent.md` (ينفذ الـ Spec) | `project-preparation/*.md`, `28_UI_UX_GUIDELINES.md`, `PROJECT_RULES.md` |
24
26
  | **design-reviewer.md** | — (مستقل — يستدعيه Majed) | `TeraAgent`, `EngineeringAgent` (مراجعة مخرجاتهم) | `28_UI_UX_GUIDELINES.md`, `tera-system/design-system/DESIGN_REVIEW_STANDARDS.md` |
25
27
  | **tera-client-engagement.md** | — (مستقل — يستدعيه Majed) | `domain-research-agent.md`, `domain-expert-agent.md`, `production-erp-expert.md`, `application-blueprint.md` | `tera-system/client-helpers/*.md`, `tera-system/TeraPricingPolicy.md` |
@@ -29,9 +31,10 @@
29
31
  | **production-erp-expert.md** | Majed مباشرة، `tera.md`, `tera-client-engagement.md`, `application-blueprint.md`؛ وEngineering/QA فقط عبر Tera-approved task scope | `domain-research-agent.md` عند نقص المعرفة وبقرار المستدعي | `tera-system/knowledge-base/manufacturing/`, ملفات discovery/blueprint المحددة |
30
32
  | **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
31
33
  | **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
32
- | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة |
34
+ | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed؛ و`application-blueprint.md` (مراجعة تحضير فقط — وضع Preparation-Review، كل دفعة، Phases 1–4 — SCP-2026-09-24-006) | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة؛ أو دفعة مستندات التحضير + upstream + template |
33
35
  | **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
34
36
  | **qa-agent.md** (الاسم المنطقي: qa-agent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
37
+ | **project-knowledge-agent.md** | `tera.md` (بعد مهمة مؤثرة — TASK_COMPLETED) | — | `project-knowledge/` داخل التطبيق، ملف المهمة المؤثرة |
35
38
  | **red-team-agent.md** 🆕 (الشبح — SCP-2026-09-02-001) | `tera.md` (Phase 7 Security Gate)؛ Majed مباشرة | `security-observer.md` (العين يراقبه بالتزامن)، `security-auditor.md` (القاضي يدقق أدلته)؛ يستلم `defense-handoff.md` من الدرع عبر Tera | `security-reports/[ROUND-ID]/`, البروتوكول الأمني v2.0, `tera-system/TOOLING_AND_MCP_POLICY.md` |
36
39
  | **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
37
40
  | **security-auditor.md** 🆕 (القاضي — SCP-2026-09-02-001) | `tera.md` (بعد Red Team + Observer + Retest)؛ Majed مباشرة | يدقق أدلة `red-team-agent.md` (الشبح) + تقرير `security-observer.md` (العين) — يرفض الادعاءات بلا دليل | `security-reports/[ROUND-ID]/audit/`, ASVS 5.0 L2, WSTG, تقارير الشبح والعين |
@@ -65,12 +68,13 @@ ui-designer.md
65
68
 
66
69
  ---
67
70
 
68
- ## ⚠️ تنبيهات حجم الملف
69
-
70
- الجدول أدناه يستخدم القاعدة المحدّثة: < 700 = ✅, 700–1000 = 🟡 دراسة, > 1000 = 🔴 تقسيم إجباري.
71
-
72
- | الملف | الحجم (سطور) | الحالة / ملاحظات |
73
- |-------|-------------|-----------------|
71
+ ## ⚠️ تنبيهات حجم الملف
72
+
73
+ > **ملاحظة (SCP-2026-09-24-001):** القاعدة المحدّثة: < 700 = ✅, 700–1000 = 🟡 دراسة, > 1000 = 🔴 تقسيم إجباري.
74
+ > **العدّادات أدناه لقطة زمنية تاريخية وليست مصدر حقيقة** — القياس الحيّ هو `wc -l` / عدّاد القارئ الفعلي وقت الحاجة (العدّاد اليدوي المتقادم سبب معروف للانحراف).
75
+
76
+ | الملف | الحجم (سطور — لقطة تاريخية) | الحالة / ملاحظات |
77
+ |-------|-------------|-----------------|
74
78
  | `tera.md` | 558 | 🟢 < 700 — +005: micro-fixes (presentation/WAIVED/29–39/commands pointer) — من 556 |
75
79
  | `tera-system/TeraSubAgents.md` | 855 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
76
80
  | `tera-system/TeraHelperAgents.md` | 970 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
@@ -95,12 +95,13 @@ This agent is activated based on `AGENT_ACTIVATION_MATRIX.md` triggers:
95
95
 
96
96
  ## Default Permission Level
97
97
 
98
- Based on `AGENT_PERMISSION_MODEL.md`:
98
+ Based on `AGENT_PERMISSION_MODEL.md` (حزم غير متوارثة — SCP-2026-09-24-001):
99
99
 
100
- - **Default Level:** `READ_ONLY` / `PLAN_ONLY` / `WRITE_DOCS` / `WRITE_CONTROL` / `WRITE_CODE` / `RUN_TESTS` / `DEPLOY_WITH_APPROVAL`
101
- - **Can be raised to:** [مستوى أعلى عند الحاجة، بشرط موافقة Tera]
102
- - **Can be lowered to:** [مستوى أدنى إذا كانت المهمة محدودة]
103
- - **Rule:** لا يحق للعميل تجاوز صلاحيته الافتراضية دون قرار صريح من Tera.
100
+ - **Default Bundle(s):** `READ_ONLY` / `PLAN_ONLY` / `WRITE_DOCS` / `WRITE_KNOWLEDGE` / `WRITE_CONTROL` / `RUN_TESTS` / `WRITE_CODE` / `DEPLOY_WITH_APPROVAL` (+ نطاق أمني: `EXECUTE_ATTACKS` / `WRITE_EVIDENCE`)
101
+ - **Can add bundle:** [حزمة إضافية عند الحاجة الفعلية، بشرط موافقة مالك التفعيل] — الحزمة **لا تُورّث** صلاحيات حزمة أخرى
102
+ - **Can narrow to:** [حزمة أضيق إذا كانت المهمة محدودة]
103
+ - **Non-inheritance:** `WRITE_CODE` ≠ `WRITE_CONTROL`؛ أي حزمة لا تشمل غيرها تلقائياً. الصلاحية الفعّالة = الحزم + الدور + المهمة + Allowed Write Targets + الموافقات.
104
+ - **Rule:** لا يحق للعميل تجاوز صلاحيته الافتراضية دون قرار صريح من مالك التفعيل.
104
105
 
105
106
  ## Token Budget
106
107