@tera-system/core 0.5.0 → 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.
- package/MANIFEST.json +7 -7
- package/RELEASES.md +13 -0
- package/agents/application-blueprint.md +6 -6
- package/agents/auditor.md +19 -2
- package/agents/tera-client-engagement.md +6 -6
- package/agents/tera-system-evolution.md +1 -1
- package/agents/tera.md +2 -0
- package/commands/tera-approve.md +43 -34
- package/commands/tera-diagnose.md +2 -0
- package/commands/tera-gate.md +2 -0
- package/commands/tera-help.md +1 -0
- package/commands/tera-new-project.md +32 -35
- package/commands/tera-plan.md +2 -0
- package/commands/tera-reconcile.md +35 -0
- package/commands/tera-request-build.md +2 -0
- package/commands/tera-resume.md +2 -0
- package/commands/tera-review.md +2 -0
- package/commands/tera-status.md +2 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +10 -6
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +9 -7
- package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +6 -5
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +26 -9
- package/core/tera-system/TERA_AGENT_CONDUCT.md +17 -0
- package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +1 -1
- package/core/tera-system/TeraPolicyMap.md +4 -2
- package/core/tera-system/TeraPreExecutionGate.md +34 -0
- package/core/tera-system/TeraPreparationDocumentationGovernance.md +21 -15
- package/core/tera-system/TeraSubAgents.md +2 -1
- package/core/tera-system/TeraSystemMaintenanceChecklist.md +12 -0
- package/core/tera-system/client-helpers/tera-client-engagement-gates.md +2 -2
- package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
- package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +14 -9
- package/core/tera-system/engineering-helpers/database-privileges.md +63 -0
- package/core/tera-system/engineering-helpers/engineering-agent-core.md +11 -0
- package/core/tera-system/profiles/rust.md +1 -0
- package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +1 -1
- package/core/tera-system/runtime/TERA_COMMAND_PROTOCOL.md +86 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +14 -0
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +2 -2
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +9 -2
- package/package.json +2 -2
package/MANIFEST.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Build manifest for the Tera System OpenCode Plugin component.",
|
|
5
5
|
"compatibleEnvironments": [
|
|
6
6
|
"opencode"
|
|
@@ -8,19 +8,19 @@
|
|
|
8
8
|
"minOpencodeVersion": "1.18.16",
|
|
9
9
|
"content": {
|
|
10
10
|
"agents": 25,
|
|
11
|
-
"commands":
|
|
12
|
-
"coreFiles":
|
|
11
|
+
"commands": 38,
|
|
12
|
+
"coreFiles": 126,
|
|
13
13
|
"tools": 8,
|
|
14
14
|
"projectControlTemplates": 1,
|
|
15
15
|
"assets": 50
|
|
16
16
|
},
|
|
17
17
|
"sha256": {
|
|
18
|
-
"agents": "
|
|
19
|
-
"commands": "
|
|
20
|
-
"core/tera-system": "
|
|
18
|
+
"agents": "b097c0ece06182b9ef7a7f400900ac9a6a61e3ea2994687b9262946a8cc397f5",
|
|
19
|
+
"commands": "e54006e16ce0cd87f250b414cb56b0572271b739b4f418667da826f18fa9bed5",
|
|
20
|
+
"core/tera-system": "46d291a1409c0bc296685ef275455ddf15f69466d85ca82715f5d06246f40c24",
|
|
21
21
|
"tools": "60e9fb5fa05afa63053d8f6d80a371cdc288448e7c13831066b4d08f0573539e",
|
|
22
22
|
"core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
|
|
23
23
|
"assets": "aba6595329e1b56b29fd677f2075d841c930953cdfa67ec808a85923071c3471"
|
|
24
24
|
},
|
|
25
|
-
"builtAt": "2026-09-
|
|
25
|
+
"builtAt": "2026-09-26"
|
|
26
26
|
}
|
package/RELEASES.md
CHANGED
|
@@ -4,6 +4,19 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## 0.6.0 (2026-09-26)
|
|
8
|
+
|
|
9
|
+
### تحصين الحوكمة + بروتوكولات تشغيل جديدة (SCP-2026-09-24-001…006)
|
|
10
|
+
|
|
11
|
+
- **بروتوكول الأوامر:** `runtime/TERA_COMMAND_PROTOCOL.md` (جديد).
|
|
12
|
+
- **مساعد صلاحيات قاعدة البيانات:** `engineering-helpers/database-privileges.md` (جديد).
|
|
13
|
+
- **تحصين Runtime/Orchestration** (SCP-002) + **تحصين TCEA** (SCP-003) + **تحصين حوكمة التحضير** (SCP-004).
|
|
14
|
+
- **ترقية دروس التحقق التجريبية إلى النواة** (SCP-005 — من Reach/TASK-COD-318).
|
|
15
|
+
- **إعادة استخدام `auditor` للمراجعة المتقاطعة للتحضير** (SCP-006 — بلا وكيل جديد).
|
|
16
|
+
- **العدادات:** الأوامر 37 → **38**، ملفات `tera-system/` 124 → **126**، الوكلاء 25 (بلا تغيير).
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
7
20
|
## 0.5.0 (2026-09-24)
|
|
8
21
|
|
|
9
22
|
### وكلاء متخصصون جدد: Flutter + Django (SCP-2026-09-23-006 — GAP-025)
|
|
@@ -76,7 +76,7 @@ TCEA → confirmed handoff
|
|
|
76
76
|
2. تقييم العمق والمخاطر والفجوات.
|
|
77
77
|
3. إنتاج Blueprint + ملفات التحضير الدقيقة.
|
|
78
78
|
4. إدارة TASK-PREP-* وعملاء التحضير.
|
|
79
|
-
5. تطبيق Maker/Checker وCross-Review واتساق الوثائق.
|
|
79
|
+
5. تطبيق Maker/Checker وCross-Review (عبر `auditor` — وضع `Preparation-Review`) واتساق الوثائق.
|
|
80
80
|
6. إنتاج Solution Readiness Gate وEngineering Handoff Package.
|
|
81
81
|
7. تسليم حزمة Baseline-ready إلى TeraAgent عبر Majed.
|
|
82
82
|
```
|
|
@@ -149,9 +149,9 @@ tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md — قوالب الت
|
|
|
149
149
|
|
|
150
150
|
### المرحلة 4 — Preparation Delegation & Baseline
|
|
151
151
|
|
|
152
|
-
1. إنتاج `AGENT_DELEGATION_PLAN.md`.
|
|
153
|
-
2. تفويض `TASK-PREP-*` لعملاء التحضير بنطاقات كتابة واضحة.
|
|
154
|
-
3. تطبيق Maker/Checker وCross-Review على كل ملف
|
|
152
|
+
1. إنتاج `AGENT_DELEGATION_PLAN.md`.
|
|
153
|
+
2. تفويض `TASK-PREP-*` لعملاء التحضير بنطاقات كتابة واضحة.
|
|
154
|
+
3. تطبيق Maker/Checker وCross-Review على كل ملف تحضيري — **بعد كتابة كل دفعة، استدعِ `auditor` في وضع `Preparation-Review` كمراجع مستقل (Checker ≠ Maker) ثم عالِج النتائج** (SCP-2026-09-24-006).
|
|
155
155
|
4. تتبّع كل متطلب إلى مصدره ومساره وشاشته وبياناته ومعيار قبوله.
|
|
156
156
|
5. إدارة lifecycle ملفات التحضير حتى `Module Baseline Approved` فأعلى.
|
|
157
157
|
|
|
@@ -329,7 +329,7 @@ Majed → Tera
|
|
|
329
329
|
❌ لا تدخل Build Mode
|
|
330
330
|
❌ لا تدير EngineeringAgent أو engineering-agent-dotnet أو tera-software-designer للتنفيذ
|
|
331
331
|
❌ لا تدير qa-agent Execution Mode
|
|
332
|
-
❌ لا تستدعي Auditor
|
|
332
|
+
❌ لا تستدعي Auditor — **باستثناء وضع `Preparation-Review`** لدفعة تحضير (مراجعة اتساق · قراءة فقط — SCP-2026-09-24-006)
|
|
333
333
|
❌ لا تعتمد سعراً أو نطاقاً أو التزاماً تجارياً
|
|
334
334
|
❌ لا تتواصل مع العميل مباشرة
|
|
335
335
|
❌ لا تعتبر بحثاً أو افتراضاً جزءاً من baseline دون تأكيد Majed
|
|
@@ -396,7 +396,7 @@ Hand off with evidence. Never write code.
|
|
|
396
396
|
| تصميم بصري | ui-designer Preparation Design Mode | مسموح — وثائق وتصميم فقط، ممنوع كود التطبيق |
|
|
397
397
|
| Coding Agents | engineering-agent, engineering-agent-dotnet | ❌ ممنوع |
|
|
398
398
|
| تصميم مهام | tera-software-designer | ❌ يبقى تحت Tera |
|
|
399
|
-
| تدقيق | Auditor |
|
|
399
|
+
| تدقيق | Auditor | ⚠️ مسموح **لوضع `Preparation-Review` فقط** (دفعة تحضير · قراءة فقط) — وإلا يبقى تحت Tera/Monitor (SCP-2026-09-24-006) |
|
|
400
400
|
|
|
401
401
|
أي إنشاء/تفعيل لعميل تحضيري يخضع لموافقة Majed ولـ `AGENT_GENERATION_TEMPLATE.md`.
|
|
402
402
|
|
package/agents/auditor.md
CHANGED
|
@@ -153,6 +153,7 @@ Auditor is invoked only by an authorized orchestrator.
|
|
|
153
153
|
|---|---|
|
|
154
154
|
| TeraAgent | Normal post-execution quality gate review |
|
|
155
155
|
| Monitor | Only when Majed asks Monitor to verify/challenge Tera's work |
|
|
156
|
+
| ApplicationBlueprintAgent (مُهندس) | **Preparation cross-review only** (Phases 1–4) — batch-level, read-only, document consistency (SCP-2026-09-24-006). Not execution audits. |
|
|
156
157
|
| TeraSystemEvolutionAgent (حارس) | System-level audit only — for auditing system files after approved system changes, not client application audits |
|
|
157
158
|
|
|
158
159
|
### 5.2 Review Decision States
|
|
@@ -172,9 +173,9 @@ The delegation must include:
|
|
|
172
173
|
|
|
173
174
|
```text
|
|
174
175
|
Task ID:
|
|
175
|
-
Invoked By: Tera / Monitor
|
|
176
|
+
Invoked By: Tera / Monitor / ApplicationBlueprint (preparation review)
|
|
176
177
|
Review Decision State:
|
|
177
|
-
Audit Mode: Documentation / Light / Standard / Full Risk-Based
|
|
178
|
+
Audit Mode: Documentation / Light / Standard / Full Risk-Based / Preparation-Review
|
|
178
179
|
ClientAppPath or active application workspace:
|
|
179
180
|
Allowed Sources:
|
|
180
181
|
- task file
|
|
@@ -545,6 +546,21 @@ Do not perform visual design judgment. Refer visual quality to DesignReviewer.
|
|
|
545
546
|
| Small code change | Light / Standard | Code quality + testing adequacy |
|
|
546
547
|
| UI change | Standard | Code quality + P3 architecture/file-structure + UI accessibility + testing adequacy |
|
|
547
548
|
| Architecture/security-sensitive | Full Risk-Based | Expanded risk-based review of all applicable domains including P3 architecture/file-structure |
|
|
549
|
+
| Preparation document batch (Phases 1–4) | Preparation-Review | Document consistency only (SCP-2026-09-24-006): template completeness · upstream fidelity · dependency alignment · traceability · lifecycle state |
|
|
550
|
+
|
|
551
|
+
### 13.1 Preparation-Review Mode (Bounded — SCP-2026-09-24-006)
|
|
552
|
+
|
|
553
|
+
Invoked by `application-blueprint (مُهندس)` for a **batch** of preparation documents (Phases 1–4) — **not per file**, not execution audits.
|
|
554
|
+
|
|
555
|
+
Input: batch document set + upstream sources + required template + related documents.
|
|
556
|
+
Output (exactly one): `PASS` / `FINDINGS` / `NOT_VERIFIED`.
|
|
557
|
+
|
|
558
|
+
Rules:
|
|
559
|
+
- **Read-only.** No writes to preparation files; a report only (under the active workspace's `project-control/audit-reports/`).
|
|
560
|
+
- Reviews **document consistency only**: template completeness · upstream/dependency alignment · traceability · lifecycle state · open contradictions.
|
|
561
|
+
- **Does not** own scope, design, or content; does **not** decide acceptance. Findings return to مُهندس (and Majed as needed).
|
|
562
|
+
- **Independence:** the reviewer must not be the document's Maker. This is the remedy for the Maker=Checker gap (Review 04 / ENG-F01).
|
|
563
|
+
- If the batch cannot be reviewed (missing inputs), return `NOT_VERIFIED` — never guess.
|
|
548
564
|
|
|
549
565
|
Never claim exhaustive proof.
|
|
550
566
|
|
|
@@ -642,6 +658,7 @@ If a finding belongs to another specialist, mark `Referral` and do not expand be
|
|
|
642
658
|
- Do not push, commit, tag, or release.
|
|
643
659
|
- Do not expose or repeat secrets; use `[REDACTED]`.
|
|
644
660
|
- Do not communicate with sub-agents directly.
|
|
661
|
+
- Do not act as preparation Maker or scope/design owner; `Preparation-Review` is document-consistency only (SCP-2026-09-24-006).
|
|
645
662
|
- Do not run tests; that is QA scope.
|
|
646
663
|
- Do not invent metrics or cite thresholds without evidence.
|
|
647
664
|
- Do not block tasks for unrelated legacy debt unless it is critical and exposed/worsened by the current change.
|
|
@@ -17,7 +17,7 @@ permission:
|
|
|
17
17
|
|
|
18
18
|
# TeraClientEngagementAgent
|
|
19
19
|
|
|
20
|
-
Last Synced: 2026-
|
|
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` وتسلّم
|
|
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 يوجّه إلى
|
|
298
|
+
→ Majed يوجّه إلى ApplicationBlueprintAgent (تحقق التحضير التقني) ثم Engineering Handoff → TeraAgent (B4–B6)
|
|
299
299
|
|
|
300
300
|
Phase B4: Build & Configure (بناء وتكوين) — 4–8 أسابيع
|
|
301
|
-
⚡ **يكلف TeraAgent (
|
|
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` | — | عند
|
|
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
|
|
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 |
|
|
@@ -213,7 +213,7 @@ Its role is to detect, analyze, propose, govern, and narrowly execute approved s
|
|
|
213
213
|
رفض أو تقليل أي إضافة غير مبررة: ملفات، عملاء، طبقات، MCPs، أو قواعد مكررة.
|
|
214
214
|
|
|
215
215
|
7. **Core Agent Governance**
|
|
216
|
-
مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم
|
|
216
|
+
مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم **25 حالياً** — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
|
|
217
217
|
|
|
218
218
|
**قائمة العملاء الكاملة (مصدر الحقيقة: `.opencode/agents/`):**
|
|
219
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`
|
package/agents/tera.md
CHANGED
|
@@ -300,6 +300,8 @@ Allowed Write Targets must be absolute paths, or relative to an explicitly defin
|
|
|
300
300
|
### QA Execution
|
|
301
301
|
Invoke `qa-agent` Execution Mode after handback for build/test/run verification. Result: PASS → accept / PARTIAL → accept with notes / FAIL → return to developer.
|
|
302
302
|
|
|
303
|
+
> **تعريف `PARTIAL` (SCP-2026-09-24-002):** `PARTIAL` = **تغطية تحقق ناقصة فقط** (جزء من الاختبارات لم يُنفَّذ لسبب بيئي موثّق) — مع إثبات بقية معايير القبول. **لا تعني أبداً** أن بعض معايير القبول (Acceptance Criteria) لم تنجح؛ أي معيار قبول فاشل → `FAIL` لا `PARTIAL`. القبول بـ `PARTIAL` يتطلب توثيق الجزء غير المُختبَر وأثره في الـ handback.
|
|
304
|
+
|
|
303
305
|
### Sub-Agent Tool Escalation (GAP-013 — قرار Majed 2026-09-15)
|
|
304
306
|
|
|
305
307
|
إذا أخبرك عميل فرعي أنه يحتاج أداة خارج صلاحياته (مثل المتصفح للمعاينة البصرية) ليكمل مهمته:
|
package/commands/tera-approve.md
CHANGED
|
@@ -1,34 +1,43 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: اعتماد
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
1.
|
|
10
|
-
2.
|
|
11
|
-
3.
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
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
|
أجب على هذه الأسئلة الثمانية بصدق:
|
package/commands/tera-gate.md
CHANGED
|
@@ -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
|
الخطوات:
|
package/commands/tera-help.md
CHANGED
|
@@ -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
|
## أوامر التهيئة الذاتية (لكل عميل حسب اختصاصه)
|
|
@@ -1,35 +1,32 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: بدء مشروع جديد —
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
1.
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
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
|
+
- إن كان الطلب غامضاً (داخلي/خارجي) → اسأل سؤالاً واحداً قصيراً ثم وجّه.
|
package/commands/tera-plan.md
CHANGED
|
@@ -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`.
|
package/commands/tera-resume.md
CHANGED
|
@@ -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` أولاً إذا كان موجوداً.
|
package/commands/tera-review.md
CHANGED
|
@@ -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`.
|
package/commands/tera-status.md
CHANGED
|
@@ -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`
|
|
@@ -56,7 +56,7 @@
|
|
|
56
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` + مصدر التصميم |
|
|
57
57
|
| tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | مهمة بسيطة يمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
|
|
58
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-*` المنفذ + معايير القبول |
|
|
59
|
-
| 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 |
|
|
60
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` |
|
|
61
61
|
| monitor | `MONITOR` | `REVIEW_NEEDED`: مراجعة امتثال الخطط (يستدعي Auditor عند الحاجة) | 5–7 | — | خطط + سجلات |
|
|
62
62
|
| tera-client-engagement | `TCEA` | `EXTERNAL_FACTOR`: مشروع عميل خارجي / Consulting Mode | قبل Phase 1 | مشروع داخلي | `CLIENT_PROFILE.md` + `project-inputs/` |
|
|
@@ -68,8 +68,8 @@
|
|
|
68
68
|
| project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `TASK_COMPLETED`: بعد مهمة مؤثرة — تحديث الذاكرة التشغيلية | 5–7 | مهمة غير مؤثرة | TASK-ID + ملخص المهمة |
|
|
69
69
|
| tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `USER_REQUEST`: تطوير/حوكمة منظومة Tera — يستدعيه Majed | — | — | طلب Majed |
|
|
70
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 + الحدود |
|
|
71
|
-
| security-observer (العين) | `SECURITY_OBSERVER` | بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
|
|
72
|
-
| security-auditor (القاضي) | `SECURITY_AUDITOR` | بعد
|
|
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 مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
|
|
73
73
|
|
|
74
74
|
### 2.2 الأدوار التحضيرية (Preparation Roles — يملكها application-blueprint)
|
|
75
75
|
|
|
@@ -190,9 +190,13 @@
|
|
|
190
190
|
### 4.1 لا تفعيل تلقائي للعملاء
|
|
191
191
|
|
|
192
192
|
```
|
|
193
|
-
تفعيل العميل يتم بقرار من
|
|
194
|
-
|
|
195
|
-
|
|
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 (لا إدارة، لا تفويض تنفيذ).
|
|
196
200
|
```
|
|
197
201
|
|
|
198
202
|
### 4.2 لا تفعيل بدون مدخلات كافية
|
|
@@ -31,9 +31,10 @@
|
|
|
31
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 المحددة |
|
|
32
32
|
| **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
|
|
33
33
|
| **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
|
|
34
|
-
| **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 |
|
|
35
35
|
| **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
|
|
36
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/` داخل التطبيق، ملف المهمة المؤثرة |
|
|
37
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` |
|
|
38
39
|
| **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
|
|
39
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, تقارير الشبح والعين |
|
|
@@ -67,12 +68,13 @@ ui-designer.md
|
|
|
67
68
|
|
|
68
69
|
---
|
|
69
70
|
|
|
70
|
-
## ⚠️ تنبيهات حجم الملف
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
71
|
+
## ⚠️ تنبيهات حجم الملف
|
|
72
|
+
|
|
73
|
+
> **ملاحظة (SCP-2026-09-24-001):** القاعدة المحدّثة: < 700 = ✅, 700–1000 = 🟡 دراسة, > 1000 = 🔴 تقسيم إجباري.
|
|
74
|
+
> **العدّادات أدناه لقطة زمنية تاريخية وليست مصدر حقيقة** — القياس الحيّ هو `wc -l` / عدّاد القارئ الفعلي وقت الحاجة (العدّاد اليدوي المتقادم سبب معروف للانحراف).
|
|
75
|
+
|
|
76
|
+
| الملف | الحجم (سطور — لقطة تاريخية) | الحالة / ملاحظات |
|
|
77
|
+
|-------|-------------|-----------------|
|
|
76
78
|
| `tera.md` | 558 | 🟢 < 700 — +005: micro-fixes (presentation/WAIVED/29–39/commands pointer) — من 556 |
|
|
77
79
|
| `tera-system/TeraSubAgents.md` | 855 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
|
|
78
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
|
|
101
|
-
- **Can
|
|
102
|
-
- **Can
|
|
103
|
-
- **
|
|
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
|
|