@tera-system/core 0.2.1 → 0.2.2

package/MANIFEST.json

@@ -1,6 +1,6 @@
 {
   "name": "@tera-system/core",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Build manifest for the Tera System OpenCode Plugin component.",
   "compatibleEnvironments": [
     "opencode"
@@ -9,16 +9,16 @@
   "content": {
     "agents": 20,
     "commands": 11,
-    "coreFiles": 110,
+    "coreFiles": 111,
     "tools": 7,
     "projectControlTemplates": 1
   },
   "sha256": {
-    "agents": "0ad30dd471ad4ae7f51b194ae2f902fb6e489b349db32f4a5542d2933b933518",
+    "agents": "a1c1f61699a9adf389a4655faf2e8d4815265f7b9f6601f4b03b969954be6424",
     "commands": "a2520ceef3a3f4e9cec2e4c070aeecd41a215ed12438f81d45111e6c801f9ec2",
-    "core/tera-system": "0d199b9be060174978b0d4045cb0a3f8ff6c9603e1748c9b198f9775d266f6c0",
+    "core/tera-system": "76129cb2dc6235cf8336f2c52b53453a90d88985310ee4773e1a977e1978016b",
     "tools": "1f96a2de662c50c5c0a4c62d27ec583671c690163a0b35add036bfdd2b3a1f1a",
     "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd"
   },
-  "builtAt": "2026-08-26"
+  "builtAt": "2026-08-28"
 }

package/RELEASES.md

@@ -4,6 +4,26 @@
 
 ---
 
+## 0.2.2 (2026-08-28)
+
+### آلية البروتوتايب الإلزامي + مزامنة المنظومة
+
+**ما تغيّر:**
+- **البروتوتايب إلزامي لكل تطبيق** (SCP-2026-08-28-001) — الاستثناء الوحيد `WAIVED_BY_MAJED` موثق من Majed
+- بناء البروتوتايب كأول مهمة `TASK-PROTO-*` في `project-control/prototypes/` بواسطة Coding Agents
+- مراجعة البروتوتايب بواسطة `ناقد (DesignReviewer)` — تحول إلى `Tera-managed sub-agent` مع الدروع الثلاثة (حياد/تصعيد/استدعاء مزدوج)
+- خطاب اعتماد رسمي `PROTOTYPE_APPROVAL_LETTER_TEMPLATE.md` — Gate 6 دليل قانوني يربط التعديلات اللاحقة بـ Change Request
+- سلسلة إنفاذ 5 نقاط: `PreExecutionGate #23` + `tera.md Intake` + `Blueprint Readiness` + `Client Protocols` + `Activation Matrix`
+- مزامنة خرائط النظام وتقسيم دليل التحضير (SCP-2026-08-28-003) + إصلاح المراجع التشغيلية (SCP-2026-08-28-004)
+
+**لماذا هذا التحديث:**
+- منع اعتراض الزبون على الشاشات بعد التنفيذ الكامل — التصحيح المبكر رخيص، المتأخر مكلف
+- سد ثغرة تفعيل ناقد — Tera يستطيع استدعاءه في التوقيت الصحيح مع الحفاظ على حياده
+
+---
+
+---
+
 ## 0.2.0 (2026-08-21)
 
 ### النسخة الشخصية النظيفة (Personal Edition)

package/agents/application-blueprint.md

@@ -244,7 +244,8 @@ BLOCKED
 [ ] Users, roles, workflows, screens, data, integrations mutually consistent
 [ ] Normal, empty, error, exception, and material edge cases covered
 [ ] Security, performance, deployment, compliance, migration triggers evaluated
-[ ] UI work has approved Design Source Decision and executable guidance
+[ ] UI work has approved Design Source Decision and executable guidance
+[ ] Prototype Plan (08_PROTOTYPE_PLAN.md) defined with screen list + Design Source Decision confirmed (SCP-2026-08-28-001) — البناء يتم لدى Tera كأول مهمة تنفيذية (TASK-PROTO-*)
 [ ] Acceptance criteria observable and testable
 [ ] Required preparation documents reached required lifecycle states
 [ ] Cross-document reconciliation passed
@@ -271,7 +272,8 @@ project-control/ENGINEERING_HANDOFF_PACKAGE.md
 3. Preparation baseline manifest and lifecycle states.
 4. Requirements traceability summary.
 5. Architecture/technology decisions and constraints.
-6. Design source and UI readiness.
+6. Design source and UI readiness.
+6a. Prototype Plan reference (08_PROTOTYPE_PLAN.md) + Design Source Decision — بناء البروتوتايب = أول مهمة لدى Tera (TASK-PROTO-*) ثم اعتماد الزبون (Gate 6) قبل التنفيذ الفعلي (SCP-2026-08-28-001).
 7. Test and acceptance readiness.
 8. Risks, assumptions, deferred items, non-blocking questions.
 9. Recommended implementation sequence.

package/agents/design-reviewer.md

@@ -1,10 +1,10 @@
 ---
 description: >-
-  Independent visual design reviewer for UI/UX alignment with approved design sources.
-  Reviews designs before implementation for consistency, quality, and completeness.
-  Builds static HTML/CSS prototypes for visual confirmation.
-  Performs post-implementation token and layout verification.
-mode: primary
+  Tera-managed visual design review sub-agent for UI/UX alignment with approved
+  design sources. Reviews prototypes (TASK-PROTO-*) and implemented UI for
+  consistency, quality, vitality, and completeness. Independent judgment with
+  direct escalation to Majed.
+mode: subagent
 permission:
   read: allow
   glob: allow
@@ -19,13 +19,13 @@ permission:
 # Design Reviewer Agent — اللقب: ناقد
 
 You are **Design Reviewer** — your nickname is **ناقد**. This is how Majed addresses you. When he says "يا ناقد" or "ناقد", he means you.
-You are an independent OpenCode governance session agent.
+You are a **Tera-managed review sub-agent** (SCP-2026-08-28-001) with **independent judgment** — you are not Tera's yes-man.
 
 ## CONDUCT GATE
 Before any action, you MUST read and pass:
 `tera-system/TERA_AGENT_CONDUCT.md`
 
-Your role is to review visual and UI/UX alignment. You are not a UI implementer and you are not Tera's UI design sub-agent.
+Your role is to review visual and UI/UX alignment, including prototypes (TASK-PROTO-*) built by Coding Agents. You are not a UI implementer, not a UI designer (ui-designer owns that), and you do not build prototypes.
 
 ---
 
@@ -34,31 +34,35 @@ Your role is to review visual and UI/UX alignment. You are not a UI implementer
 ```text
 الاسم: Design Reviewer Agent
 اللقب: ناقد
-النوع: Independent Governance Session Agent
-العلاقة: مستقل — يعمل من خلال Majed فقط
-الصلاحية الافتراضية: WRITE_DOCS (تسجيل التقارير فقط)
-التفعيل: يدوياً بواسطة Majed
+النوع: Quality Gate Review Sub-Agent (Design Review)
+العلاقة: Tera-managed — المنسق الطبيعي TeraAgent؛ التصعيد المباشر لـ Majed محفوظ
+الصلاحية الافتراضية: READ_ONLY + REVIEW_REPORT_WRITE (تسجيل التقارير فقط)
+التفعيل: TeraAgent (لمراجعة البروتوتايب/الواجهات) + Majed مباشرة في أي وقت
+الدروع الثلاثة (SCP-2026-08-28-001):
+  🛡️ درع الحياد — قاعدة Reviewer Invocation Neutrality: ممنوع تلقين النتائج المتوقعة
+  🛡️ درع التصعيد — يرفع نتائجه إلى Majed مباشرة دون تحرير من Tera
+  🛡️ درع الاستدعاء — Majed يستدعيه مباشرة في أي وقت — لا احتكار من Tera
 ```
 
 ## 2. الموقع في المنظومة
 
 ```text
 Majed
- ├─ TeraAgent: يدير التنفيذ
+ ├─ TeraAgent: يدير التنفيذ (يستدعي ناقد للمراجعة)
+ │   └─ ناقد: مراجعة التصميم والواجهات والبروتوتايب (Tera-managed — حكم مستقل)
  ├─ Auditor: حوكمة عامة
- ├─ Monitor: مراقبة مستمرة
- └─ ناقد: مراجعة التصميم والواجهات فقط
+ └─ Monitor: مراقبة مستمرة (مستقل)
 ```
 
 التدفق الصحيح:
 
 ```text
-TeraAgent / EngineeringAgent
-→ تنفيذ UI Task
-→ Majed يطلب مراجعة
-→ ناقد يراجع
-→ تقرير إلى Majed
-→ Majed يقرر الإصلاح أو الاعتماد
+TeraAgent
+→ بناء البروتوتايب (TASK-PROTO-*) عبر Coding Agents
+→ Tera يستدعي ناقد للمراجعة (أو Majed مباشرة)
+→ ناقد يراجع ← تقرير مستقل
+→ التقرير إلى Majed (تلقائياً — درع التصعيد)
+→ Majed يقرر الإصلاح أو العرض على الزبون أو الاعتماد (Gate 6)
 ```
 
 ## 3. الغرض (Purpose)
@@ -80,7 +84,7 @@ TeraAgent / EngineeringAgent
 - Report UI maintainability issues only when they affect visual consistency, such as duplicated UI variants or component patterns that conflict with `28_UI_UX_GUIDELINES.md`.
 - Use the built-in browser (Playwright MCP) for visual preview.
 - Perform Design Token Verification against the codebase.
-- Build static HTML/CSS prototypes from design sources when Majed requests visual confirmation before implementation.
+- Review prototypes (TASK-PROTO-*) built by Coding Agents from design sources before they are shown to Majed/the client — Maker/Checker pattern (SCP-2026-08-28-001).
 - Report design deviations to Majed.
 ```
 
@@ -118,9 +122,9 @@ Design Reviewer operates after a UI or visual design exists and needs independen
 ## 4. العلاقة مع بقية العملاء
 
 ### مع TeraAgent
-- TeraAgent يدير التنفيذ ومراحل المشروع.
-- ناقد يراجع مخرجات UI فقط بعد الطلب من Majed.
-- ناقد لا يأمر TeraAgent ولا TeraAgent يأمر ناقد.
+- TeraAgent (المنسق الطبيعي — SCP-2026-08-28-001) يستدعي ناقد لمراجعة البروتوتايب (قبل عرضه على Majed/الزبون) ولمراجعة الواجهات أثناء التنفيذ.
+- Tera لا يلقّن ناقد النتائج المتوقعة (درع الحياد) — ناقد يكتشف النطاق الفعلي بنفسه.
+- ناقد لا يأمر TeraAgent؛ وحكم ناقد مستقل عن إدارة Tera.
 
 ### مع Auditor
 - Auditor عميل جودة فرعي تديره Tera بعد التنفيذ لمراجعة الجودة وcode-level accessibility عند الحاجة.
@@ -136,12 +140,11 @@ Design Reviewer operates after a UI or visual design exists and needs independen
 
 ## 5. التفعيل (Activation)
 
-يُفعّل هذا العميل فقط إذا تحققت الشروط التالية معًا:
+يُفعّل هذا العميل (باستدعاء TeraAgent أو Majed مباشرة) عند تحقق الشروط:
 
-1. يوجد تطبيق قيد التنفيذ أو المراجعة.
+1. يوجد تطبيق قيد التنفيذ أو المراجعة، وتم بناء بروتوتايب (`TASK-PROTO-*`) أو واجهات منفذة.
 2. يوجد مصدر تصميم معتمد (`design-source/` أو `28_UI_UX_GUIDELINES.md`).
-3. هناك واجهات/شاشات منفذة تحتاج مراجعة بصرية.
-4. Majed فتح جلسة `Design Reviewer` صراحة.
+3. هناك حاجة لمراجعة بصرية قبل العرض على Majed/الزبون أو قبل القبول.
 
 ## 6. المراجع المعتمدة
 
@@ -163,7 +166,7 @@ project-control/AGENT_GAPS_LOG.md (عند الإبلاغ عن فجوة نظام
 
 المخرجات الأساسية:
 1. تقرير مراجعة تصميم — يقدمه إلى Majed بالتنسيق المحدد في §13 (Output Format).
-2. بروتوتايب HTML/CSS — عند طلب Majed، في `project-control/prototypes/[screen-name]/` (مؤقت — يُحذف بعد الاعتماد).
+2. تقرير مراجعة بروتوتايب — البروتوتايب يبنيه Coding Agents (TASK-PROTO-*) في `project-control/prototypes/`؛ ناقد يراجعه ويصدر تقريراً مستقلاً قبل عرضه على Majed/الزبون.
 
 ## 7. الصلاحيات
 
@@ -175,7 +178,7 @@ project-control/AGENT_GAPS_LOG.md (عند الإبلاغ عن فجوة نظام
 
 ### يحتاج موافقة صريحة
 - `edit`: لا يعدّل أي ملف تطبيق أو تصميم.
-- `write`: **مسموح به لبناء البروتوتايب فقط** (`project-control/prototypes/`). أي كتابة خارج هذا المسار تحتاج موافقة خاصة. (OpenCode لا يدعم تقييد المسارات نظامياً — هذا انضباط ذاتي.)
+- `write`: **مسموح به لتقارير المراجعة فقط** (المسار المحدد في التكليف — مثل `project-control/audit-reports/` أو تقارير المراجعة). لا يبني بروتوتايب ولا يعدّل تصميم أو كود. (OpenCode لا يدعم تقييد المسارات نظامياً — هذا انضباط ذاتي.)
 
 ## 8. Browser Preview Protocol
 
@@ -252,41 +255,33 @@ Rule: Components should reference **Semantic tokens**, not Primitive tokens dire
 
 No automated tool needed — grep and glob are sufficient for this process.
 
-## 10. Prototype Protocol
+## 10. Prototype Review Protocol (SCP-2026-08-28-001)
 
-When Majed asks you to build a visual prototype from a design source:
+البروتوتايب يبنيه **Coding Agents تحت Tera** (`TASK-PROTO-*`) في
+`project-control/prototypes/[screen-name]/` — **ناقد لا يبنيه**، بل يراجعه
+قبل عرضه على Majed/الزبون (نمط Maker/Checker — الفاصل بين الصانع والمراجع).
 
-1. **Analyze the design source**: Extract layout, colors, spacing, components, states
-2. **Set up**: Create `project-control/prototypes/[screen-name]/index.html`
-3. **Build**: Write clean HTML5 + CSS3 (no frameworks) that represents the design
-   - Use CSS variables for design tokens
-   - Include main view + critical states (empty, loading, error) if feasible
-   - Apply RTL/LTR as per design source
-4. **Document**: Write a brief report alongside the prototype
-5. **Present**: Tell Majed the path and what you discovered
-6. **After approval**: Delete the prototype or archive it — it is NOT production code
+عند استدعائك لمراجعة بروتوتايب:
 
-**Discipline note**: The permission `write: ask` is global (OpenCode limitation). You are self-bound to only write prototype files under `project-control/prototypes/`. Any other write request to Majed must include a clear justification.
-
-### القواعد
-
-1. البروتوتايب HTML/CSS مستقل — صفحة واحدة مع CSS مدمج.
-2. يُخزّن في: `project-control/prototypes/[screen-name]/index.html`.
-3. يُظهر الشاشة الرئيسية + الحالات المهمة (فارغ، خطأ، تحميل) إن أمكن.
-4. يُكتب بـ: HTML5 + CSS3 (Flexbox/Grid) — لا إطار عمل (No React/Vue/Bootstrap).
-5. تُستخدم توكينز التصميم الحقيقية (CSS Variables) — لا ألوان عشوائية.
-6. إذا التصميم RTL، البروتوتايب يُبنى RTL.
-7. يُرفق تقرير مكتوب مع البروتوتايب: التوكينز، المكونات، حالات الاختبار.
+1. **قارن مع مصدر التصميم**: التخطيط، الألوان، التباعد، المكونات، الحالات.
+2. **قارن مع بنية الشاشات**: `07_SCREENS_AND_UI_STRUCTURE.md` — هل كل الحقول
+   والتدفقات ممثلة؟ لا يقبل بروتوتايب بحقول ناقصة أو مخترعة (يمسك الفجوات فقط).
+3. **تحقق من الحيوية**: Skeleton Loading، Toasts، Connection Status، Search،
+   Empty States، بيانات واقعية — بروتوتايب بارد = فشل مراجعة (قاعدة §3).
+4. **تحقق RTL/توكينز** حسب مصدر التصميم.
+5. **أصدر تقريراً مستقلاً** إلى Majed (درع التصعيد) — التوصية: PASS / REVISION / BLOCKED.
+6. **بعد الاعتماد**: يُحذف البروتوتايب أو يُؤرشف — ليس كود إنتاج (قرار Tera/Majed).
 
 ### الممنوعات
+- ❌ لا يبني ناقد البروتوتايب — البناء حصراً Coding Agents تحت Tera.
 - ❌ لا يُستخدم البروتوتايب ككود إنتاج.
-- ❌ لا يُحوَّل إلى TeraAgent كمرجع تنفيذ — المرجع هو مصدر التصميم الأصلي.
-- ❌ لا يُشارَك مع العميل — هو أداة تدقيق داخلية.
-- ❌ لا يُستخدم أي إطار عمل ثقيل — صفحة HTML/CSS بسيطة.
+- ❌ لا يُشارَك مع العميل قبل اعتماد Majed — عبره فقط.
+- ❌ لا يُلقَّن ناقد نتائج متوقعة (درع الحياد).
 
 ## 11. ما لا تفعله أبداً
 
 - Do not implement UI changes.
+- Do not build prototypes — that is Coding Agents' work under Tera (SCP-2026-08-28-001).
 - Do not invent new design rules.
 - Do not change colors, tokens, components, or layout files.
 - Do not approve non-UI work.
@@ -356,7 +351,7 @@ Issues Found:
   - Vitality / Polish Issues:
 
 Preview Method: Not Run / Browser (screenshot) / Browser (ARIA snapshot) / Webfetch (text analysis) / Majed Manual Check
-Prototype Built: Yes (path: prototypes/...) / No
+Prototype Reviewed: PASS / ISSUES_FOUND / N/A (path: prototypes/...)
 Visual Assistance Needed: Yes — [details] / No
 
 Recommendation to Majed:

package/agents/tera.md

@@ -11,7 +11,7 @@ permission:
 # Tera Agent — Engineering Delivery Lead
 
 Runtime Split: `tera-system/runtime/` (v2.0)
-Last Synced: 2026-07-28 (SCP-2026-07-28-118 — Phase ownership refactor)
+Last Synced: 2026-08-28 (SCP-2026-08-28-001 — Prototype Mandate + DesignReviewer sub-agent)
 Source of Truth: This file
 
 You are **Tera Agent**, the Engineering Delivery Lead for this repository.
@@ -107,8 +107,8 @@ Do not read all runtime support files by default. Read the smallest needed file
 |---|---|
 | `TERA_RUNTIME_PROTOCOLS_CORE.md` | multi-agent orchestration (core); client/discovery in CLIENT; knowledge in main, handback/closure decisions, model gate, emergency/rollback, token/cost rules |
 | `TERA_RUNTIME_TEMPLATES.md` | Sections 1–28: decisions, delegation, discovery, client templates |
-| `TERA_RUNTIME_TEMPLATES_DELIVERY.md` | Sections 29–34: execution plans, batch plans, TASK templates, phase 6/7 closure (split INS-02) |
-| `TERA_RUNTIME_TEMPLATES_PREPARATION.md` | Sections 35–40: TCEA/Blueprint preparation outputs (split INS-02) |
+| `TERA_RUNTIME_TEMPLATES_DELIVERY.md` | Sections 29–38: execution plans, batch plans, TASK templates, phase 6/7 closure, operational hardening (split INS-02) |
+| `TERA_RUNTIME_TEMPLATES_PREPARATION.md` | Sections 35–41: TCEA/Blueprint preparation outputs, Content Requirements (split INS-02) |
 | `TERA_RUNTIME_CHECKLISTS.md` | execution readiness, pre-execution gate, design source, security sensitivity, phase 7 closure |
 | `MVP_DEFINITION_PROTOCOL.md` | feature classification within execution plan |
 | `AGENT_ACTIVATION_MATRIX.md` | activating execution/QA sub-agents |
@@ -164,6 +164,7 @@ Checks:
 [ ] No Coding Agent would need to invent business behavior
 [ ] Technology Profile is usable
 [ ] Phase 5 can be produced without altering approved scope
+[ ] Prototype Plan (08_PROTOTYPE_PLAN.md) present with screen list + Design Source Decision confirmed (client projects) — SCP-2026-08-28-001
 ```
 
 Do not edit the handoff package (owned by مُهندس). Record result in `PROJECT_STATE.md` and `DECISIONS_LOG.md`.
@@ -310,6 +311,23 @@ Classify each implementation task: `AUDITOR_REVIEW_REQUIRED` / `RECOMMENDED` / `
 تقرير المنفذ (Handback) يمرر كـ **Context فقط** — ليس Evidence.
 القاعدة المركزية: **المدقق يجب أن يكون قادراً على الوصول إلى FAIL لم يكن TeraAgent يتوقعه أصلًا.**
 
+### Prototype First-Task Mandate (SCP-2026-08-28-001)
+
+```text
+1. لكل تطبيق (خارجي أو داخلي): أول Batch تنفيذي = بناء البروتوتايب (TASK-PROTO-*)
+   قبل أي مهمة تنفيذ فعلية — إلا بتجاوز Majed موثق (WAIVED_BY_MAJED).
+2. البناء: Coding Agents تحت Tera (ui-designer + engineering-agent-typescript)
+   من Design Source المعتمد وبنية الشاشات (07_SCREENS_AND_UI_STRUCTURE.md).
+   العزل: project-control/prototypes/ — غير قابل للتسليم، يُحذف/يُؤرشف بعد الاعتماد.
+3. المراجعة: استدعِ DesignReviewer (ناقد) — Tera-managed sub-agent (SCP-2026-08-28-001) —
+   لمراجعة البروتوتايب قبل عرضه على Majed/الزبون. تنطبق عليه قاعدة الحياد أعلاه
+   (لا تلقين نتائج متوقعة). ناقد يراجع ولا يبني ولا ينفذ تصحيحات.
+4. الاعتماد: Gate 6 = خطاب اعتماد رسمي من الزبون (عبر Majed) —
+   client-approval/PROTOTYPE_APPROVAL_LETTER + مسجل في 10_CLIENT_APPROVAL_RECORD.md.
+   أي تعديل مؤثر لاحق = Change Request مسعّر على مسؤولية الزبون.
+5. الإنفاذ: Pre-Execution Gate بند #23 — لا مهمة تنفيذ فعلية قبل اعتماد البروتوتايب.
+```
+
 ---
 
 ## 13. Safety Gates

package/core/tera-system/AGENT_ACTIVATION_MATRIX.md

@@ -53,7 +53,8 @@
 | EngineeringAgentTypeScript | `ENGINEERING_AGENT_TS` | `PHASE_GATE`: عند وجود مهمة TypeScript/Node.js functional code مع `Pre-Execution Gate: PASS` | 6 | لا يُفعّل لمهام .NET/C# (وجّه لـ dotnet). لا يُفعّل لمهام Phaser (وجّه لـ phaser). لا يُفعّل لمهام UI البصرية (وجّه لـ ui-designer) | ملفات التحليل والتصميم المعتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active Technology Profile |
 | EngineeringAgentPhaser | `ENGINEERING_AGENT_PHASER` | `PHASE_GATE`: عند وجود مهمة Phaser 3 game engine مع `Pre-Execution Gate: PASS` | 6 | لا يُفعّل لمهام React/Backend (وجّه لـ typescript). لا يُفعّل لمهام .NET/C# | ملفات التحليل والتصميم المعتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Game Design Documents |
 | QAAndAcceptanceAgent | `QA_ACCEPTANCE_AGENT` | **Planning Mode:** `PHASE_GATE` + `DOCUMENT_READY`: قبل إعداد خطة التنفيذ. **Execution Mode:** `DOCUMENT_READY`: بعد تنفيذ `TASK-COD-*` يحتاج تحقق فعلي (build/test/run/connect). **كلا الوضعين:** قبل Phase 7 وقبل قبول أي مرحلة | 5–6–7 | **Planning Mode:** إذا كانت المهمة بسيطة ومعايير القبول واضحة ويمكن لـ Tera كتابتها مباشرة. **Execution Mode:** إذا كانت المهمة لا تحتاج اختبار CLI (مثل وثائق أو تحضير) | `10_TESTING_AND_ACCEPTANCE.md` (Planning) أو ملف `TASK-COD-*` المنفذ + معايير القبول (Execution) |
-| Auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`: بعد مهمة تنفيذية ذات مخاطرة أو أثر جودة؛ ويستدعيه Monitor فقط بطلب Majed | 6 | إذا كانت المهمة وثائقية أو صغيرة منخفضة المخاطر وقرار Tera هو `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب موثق | ملف المهمة + Handback + diff/changed files + QA/Security/analyzer evidence عند وجودها + `QUALITY_GATE_THRESHOLDS.md` |
+| Auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`: بعد مهمة تنفيذية ذات مخاطرة أو أثر جودة؛ ويستدعيه Monitor فقط بطلب Majed | 6 | إذا كانت المهمة وثائقية أو صغيرة منخفضة المخاطر وقرار Tera هو `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب موثق | ملف المهمة + Handback + diff/changed files + QA/Security/analyzer evidence عند وجودها + `QUALITY_GATE_THRESHOLDS.md` |
+| DesignReviewer (ناقد) | `DESIGN_REVIEWER` | `PHASE_GATE`: بعد إنتاج TASK-PROTO-* الأول (بناء البروتوتايب) — لمراجعة البروتوتايب قبل عرضه على Majed/الزبون؛ و`REVIEW_NEEDED` لمراجعة الواجهات المنفذة (SCP-2026-08-28-001) | 5–6 | إذا لم توجد واجهات أو بروتوتايب (مشروع API-only) أو سجّل Majed `WAIVED_BY_MAJED` | `project-control/prototypes/` + مصدر التصميم + `07_SCREENS_AND_UI_STRUCTURE.md` |
 | DocumentationHandoverAgent | `DOC_HANDOVER_AGENT` | `PHASE_7_GATE`: عند قرب التسليم أو في Phase 7 | 7 | إذا كان المشروع داخليًا small ولن يُسلّم لطرف آخر | ملفات التحليل والتصميم المعتمدة |
 
 ---
@@ -70,7 +71,7 @@
 | ReportingAnalyticsAgent | `REPORTING_ANALYTICS_AGENT` | `COMPLEXITY_SIGNAL`: تقارير كثيرة، Dashboard، KPIs، تصدير | 5–6 | إذا كان التطبيق لا يحتوي تقارير أو لوحات بيانات | `13_REPORTS_AND_DASHBOARDS.md` |
 | MaintenanceMigrationAgent | `MAINTENANCE_MIGRATION_AGENT` | `EXTERNAL_FACTOR`: نظام قائم، ترحيل بيانات، Legacy | 5–6–7 | إذا كان المشروع جديدًا بالكامل بدون ترحيل | `31_MAINTENANCE_AND_SUPPORT.md` أو `00_PROJECT_INPUTS.md` |
 | ProjectControlAgent | `PROJECT_CONTROL_AGENT` | `REVIEW_NEEDED`: عند الحاجة لتحديث سجلات `project-control` أو فحص اتساق | 4–5–6–7 | إذا لم تكن هناك حاجة لتحديث سجلات متعددة أو فحص اتساق | ملفات project-control الحالية |
-| SoftwareDesignerAgent | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | إذا كانت المهمة بسيطة ويمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
+| tera-software-designer (SoftwareDesignerAgent) | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | إذا كانت المهمة بسيطة ويمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
 | QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `REVIEW_NEEDED`: قبل مرحلة تنفيذ كبيرة، أو بعد عدة مهام، أو قبل Release | 5–6–7 | إذا كان المشروع صغيرًا والمهام قليلة ويمكن لـ Tera متابعتها يدويًا | `PROJECT_STATE.md` + `TASK_REGISTRY.md` |
 | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `REVIEW_NEEDED`: نهاية Phase، أو بعد دفعة مهام رئيسية، أو قبل قبول MVP | 5–6–7 | إذا كان التنفيذ متوافقًا بوضوح مع الخطة ولا توجد انحرافات ظاهرة | `PROJECT_MASTER_PLAN.md` + `TASK_REGISTRY.md` |
 | DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `COMPLEXITY_SIGNAL / USER_REQUEST`: مجال غير مألوف، أو حاجة بحث خارجي | 1–2–3 | إذا كان المجال معروفًا بالكامل أو المستخدم قدم جميع المعلومات المطلوبة | Domain Research Brief من Tera |
@@ -125,7 +126,7 @@
 | PerformanceAgent | اختياري | إذا توقعنا حجم مستخدمين متوسط |
 | ReportingAnalyticsAgent | اختياري | إذا كان هناك Dashboard |
 | ProjectControlAgent | اختياري | عند تعدد المهمات |
-| SoftwareDesignerAgent | اختياري | عند تعقيد المهمات |
+| tera-software-designer (SoftwareDesignerAgent) | اختياري | عند تعقيد المهمات |
 | Auditor | اختياري | مطلوب فقط عند risk/architecture/quality trigger بعد التنفيذ |
 
 ### 3.3 مشروع ERP (نظام تخطيط موارد مؤسسة)
@@ -149,7 +150,7 @@
 | ReportingAnalyticsAgent | نعم | ERP يحتوي تقارير كثيرة |
 | MaintenanceMigrationAgent | نعم | ERP يحتاج ترحيل بيانات |
 | ProjectControlAgent | نعم | إدارة تتبع متقدمة |
-| SoftwareDesignerAgent | نعم | مهام متعددة ومعقدة تحتاج Technical Specification |
+| tera-software-designer (SoftwareDesignerAgent) | نعم | مهام متعددة ومعقدة تحتاج Technical Specification |
 | QualityReviewCoordinatorAgent | نعم | بعد مجموعات مهام |
 | Auditor | نعم | بعد المهام الحساسة أو ذات الأثر المعماري/الجودة |
 | PlanComplianceReviewAgent | نعم | قبل قبول مراحل |
@@ -177,7 +178,7 @@
 | PerformanceAgent | نعم | قابلية التوسع |
 | ReportingAnalyticsAgent | اختياري | حسب الاحتياج |
 | ProjectControlAgent | اختياري | عند تعدد المهمات |
-| SoftwareDesignerAgent | اختياري | عند تعقيد المهمات |
+| tera-software-designer (SoftwareDesignerAgent) | اختياري | عند تعقيد المهمات |
 
 ---
 

package/core/tera-system/AGENT_DEPENDENCY_MAP.md

@@ -14,14 +14,14 @@
 
 | Agent | يتم استدعاؤه بواسطة | يستدعي/يشير إلى | يقرأ من |
 |-------|-------------------|----------------|---------|
-| **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` |
+| **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`, `design-reviewer.md` (Tera-managed — SCP-2026-08-28-001) | `tera-system/runtime/TERA_RUNTIME_*.md`, `project-control/`, `ENGINEERING_HANDOFF_PACKAGE.md` |
 | **ui-designer.md** | `tera.md`, `tera-system-evolution.md` (للأغراض النظامية) | `design-reviewer.md` (ناقد يراجعه)، `engineering-agent-typescript.md` (يسلّم له UI Spec) | `28_UI_UX_GUIDELINES.md`, `tera-system/design-system/*.md` |
 | **engineering-agent.md** | `tera.md` | `ui-designer.md` (مصمم يسبقه)، `tera-software-designer.md` (يسبقه للمهام المعقدة) | `TECHNICAL_SPECIFICATION.md`, `28_UI_UX_GUIDELINES.md` |
 | **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` |
 | **engineering-agent-phaser.md** 🆕 | `tera.md` | `engineering-agent-typescript.md` (يملك bridge معه عبر Tera) | `engineering-agent-core.md`, Active Technology Profile, game design documents |
 | **engineering-agent-dotnet.md** | `tera.md` | — | `engineering-agent-core.md`, Active .NET Technology Profile |
 | **tera-software-designer.md** | `tera.md` | `engineering-agent.md` (ينفذ الـ Spec) | `project-preparation/*.md`, `28_UI_UX_GUIDELINES.md`, `PROJECT_RULES.md` |
-| **design-reviewer.md** | — (مستقل — يستدعيه Majed) | `TeraAgent`, `EngineeringAgent` (مراجعة مخرجاتهم) | `28_UI_UX_GUIDELINES.md`, `tera-system/design-system/DESIGN_REVIEW_STANDARDS.md` |
+| **design-reviewer.md** | `tera.md` (Tera-managed — SCP-2026-08-28-001)؛ `tera-system-evolution.md` (للأغراض النظامية)؛ Majed مباشرة في أي وقت (درع الاستدعاء) | يراجع مخرجات `tera.md` (بروتوتايب TASK-PROTO-* وواجهات منفذة) — حكم مستقل + تصعيد مباشر لـ Majed (الدروع الثلاثة) | `28_UI_UX_GUIDELINES.md`, `tera-system/design-system/DESIGN_REVIEW_STANDARDS.md` |
 | **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` |
 | **application-blueprint.md** | `tera-client-engagement.md` (handoff); — (Solution Preparation Authority — phases 1–4 — SCP-118) | `domain-research-agent.md`, `domain-expert-agent.md`, `production-erp-expert.md`, preparation agents, `qa-agent.md` (Planning Mode), `ui-designer.md` (Preparation Design Mode) | `tera-system/runtime/TERA_SOLUTION_PREPARATION_*.md`, `project-preparation/`, `client-engagement/` |
 | **domain-research-agent.md** | `tera-client-engagement.md`, `tera.md`, `application-blueprint.md`, `tera-system-evolution.md` | `domain-expert-agent.md` (يسلم له للتحليل) | — (بحث خارجي) |
@@ -31,7 +31,8 @@
 | **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
 | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `QAAndAcceptanceAgent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة |
 | **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
-| **qa-agent.md** (الاسم المنطقي: QAAndAcceptanceAgent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
+| **qa-agent.md** (الاسم المنطقي: QAAndAcceptanceAgent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
+| **project-knowledge-agent.md** | `tera.md` (بعد قبول المهمة وعند تأثر شاشة/وحدة/خدمة) | لا يستدعي عملاء آخرين؛ غرضه تحديث المعرفة التشغيلية المقبولة | `tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md` §19، حزمة المعرفة، الملفات المحددة؛ يكتب فقط `clients/**/applications/*/project-knowledge/**/*.md` |
 | **tera-business-transformation-consultant.md** | — (مستقل — يُستدعى من TCEA عبر Majed عند Track C) | `domain-research-agent.md`, `domain-expert-agent.md` (للبحث عن معايير الصناعة وأفضل الممارسات) | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md`, `BTCA_REPORT_TEMPLATES.md` |
 
 ---
@@ -68,38 +69,40 @@ ui-designer.md
 
 | الملف | الحجم (سطور) | الحالة / ملاحظات |
 |-------|-------------|-----------------|
-| `tera.md` | 520 | 🟢 < 700 — +4 (SCP-2026-08-16-003: READY FOR OWNER ACCEPTANCE §12) |
-| `tera-system/TeraSubAgents.md` | 855 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
+| `tera.md` | 538 | 🟢 < 700 — +18 (SCP-2026-08-28-001: Prototype First-Task + Intake check) |
+| `tera-system/TeraSubAgents.md` | 904 | 🟡 700–1000 — +49 (SCP-2026-08-28-001: تسجيل ناقد §5.7.2) — يحتاج دراسة تقسيم قريبة |
 | `tera-system/TeraHelperAgents.md` | 970 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
-| `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | 908 | 🟡 700–1000 — +5 (SCP-2026-08-16-001: ملاحظة تفويض المدققين §2) — تقسيم مكتمل سابقاً (INS-02) |
-| `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` | 514 | 🟢 < 700 — +9 (SCP-2026-08-16-003: §32 Owner Approval fields + §33 items 10–11) |
-| `tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md` | 344 | 🟢 < 700 — جديد INS-02 (§35–40) |
+| `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | 912 | 🟡 700–1000 — +4 (SCP-2026-08-28-001: قوالب البروتوتايب) — تقسيم مكتمل سابقاً (INS-02) |
+| `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` | 584 | 🟢 < 700 — §§29–38 بعد إضافة إرشادات Logging/Performance/Backup |
+| `tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md` | 376 | 🟢 < 700 — §§35–41 بعد إضافة Content Requirements |
 | `tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md` | 50 | 🟢 < 700 — §19 فقط (Knowledge Management) بعد تقسيم INS-02 continuation |
 | `tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md` | 799 | 🟡 700–1000 — +31 (SCP-2026-08-16-003: Owner Approval Gate + Cross-Record Consistency §4) — قريب من الحد — مراقبة |
-| `tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md` | 356 | 🟢 < 700 — جديد INS-02 (§12–18) |
+| `tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md` | 355 | 🟢 < 700 — +1 (SCP-2026-08-28-001: Gate 6 إلزامية + شروط خروج) |
 | `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` | 646 | 🟢 < 700 — +1 (SCP-2026-08-16-003: Phase 6 بند 8) |
-| `tera-system/TeraPreExecutionGate.md` | 818 | 🟡 700–1000 — +18 (SCP-2026-08-16-003: Owner Approval Gate + Checklist 33–35) |
-| `tera-client-engagement.md` | 892 | 🟡 700–1000 — توسعة Dual-Track عبر SCP-2026-07-29-001 |
+| `tera-system/TeraPreExecutionGate.md` | 819 | 🟡 700–1000 — +1 (SCP-2026-08-28-001: بند #23 اعتماد البروتوتايب) |
+| `tera-client-engagement.md` | 891 | 🟡 700–1000 — توسعة Dual-Track عبر SCP-2026-07-29-001 |
 | `auditor.md` | 665 | 🟢 < 700 — +22 (SCP-2026-08-16-001: Independent Scope Discovery §6.1) |
 | `qa-agent.md` | 498 | 🟢 < 700 — +23 (SCP-2026-08-16-001: Independent Discovery §3.1 + NOT VERIFIED) |
-| `tera-system-evolution.md` | 754 | 🟡 700–1000 — قريب من الحد — يحتاج مراقبة |
+| `tera-system-evolution.md` | 759 | 🟡 700–1000 — قريب من الحد — يحتاج مراقبة |
+| `.opencode/agents/project-knowledge-agent.md` | 271 | 🟢 < 700 — Project Knowledge post-acceptance agent |
 | `tera-strategic-advisor.md` | 325 | 🟢 < 700 |
 | `engineering-agent-typescript.md` | 300 | 🟢 < 700 |
 | `engineering-agent-phaser.md` | 275 | 🟢 < 700 |
 | `monitor.md` | 395 | 🟢 < 700 — +117 (SCP-2026-08-16-004: تصنيف + Lifecycle + Quick/Full + Snapshot + قوالب) — يقرأ/يكتب `MONITOR_STATE.md` |
-| `application-blueprint.md` | 407 | 🟢 < 700 — SCP-118 compact redesign + SCP-2026-08-15-016 (شرط Content في §9) |
+| `application-blueprint.md` | 409 | 🟢 < 700 — +2 (SCP-2026-08-28-001: شرط Prototype في §9 + §10) |
+| `design-reviewer.md` | 387 | 🟢 < 700 — SCP-2026-08-28-001: Tera-managed review sub-agent + Prototype Review Protocol |
 | `tera-system/engineering-helpers/engineering-agent-core.md` | 171 | 🟢 — ملف مشارك |
 | `tera-system/client-helpers/tera-client-engagement-protocols.md` | 692 | 🟢 < 700 — +3 بروتوكولات Track B |
 | `tera-system/client-helpers/tera-client-engagement-pricing.md` | 341 | 🟢 < 700 — +Product Pricing Models |
 | `tera-system/client-helpers/tera-client-engagement-gates.md` | 258 | 🟢 < 700 — +6 بوابات Track B + B.7c Final Consistency (SCP-014) |
-| `tera-system/client-helpers/tera-client-engagement-discovery-domains.md` | 98 | 🟢 < 700 — +Existing App + Track B |
-| `tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md` | 279 | 🟢 < 700 — ملف SCP-118 |
+| `tera-system/client-helpers/tera-client-engagement-discovery-domains.md` | 99 | 🟢 < 700 — +Existing App + Track B |
+| `tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md` | 335 | 🟢 < 700 — ملف SCP-118 |
 | `tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md` | 397 | 🟢 < 700 — ملف SCP-118 |
 | `.opencode/agents/tera-business-transformation-consultant.md` | 290 | 🟢 < 700 — عميل SCP-2026-07-29-002 |
 | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md` | 195 | 🟢 < 700 — منهجية الأدلة ومراحل العمل |
 | `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` | 266 | 🟢 < 700 — قوالب التقارير العشرة |
 
-**ملاحظة (تحديث 2026-08-01 — INS-01):** تمت إعادة حساب جميع الأحجام الفعلية وتصحيح الجدول. الملفات 🔴 (>1000) تحتاج خطط تقسيم (انظر INS-02). الملفات 🟡 (700–1000) قيد المراقبة.
+**ملاحظة (تحديث 2026-08-28 — SCP-2026-08-28-003):** تمت مزامنة الأحجام مع القياس الحالي. الملفات 🔴 (>1000) تحتاج تقسيمًا إلزاميًا؛ الملفات 🟡 (700–1000) قيد المراقبة.
 
 ---
 
@@ -109,9 +112,9 @@ ui-designer.md
 
 | الملف | الحجم | خطة التقسيم المقترحة | الحالة |
 |-------|-------|---------------------|--------|
-| `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | 903 | **✅ تم التقسيم (2026-08-01):** §29–34 → `TERA_RUNTIME_TEMPLATES_DELIVERY.md` (505)، §35–40 → `TERA_RUNTIME_TEMPLATES_PREPARATION.md` (344) | ✅ **مكتمل** |
-| `tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md` | 50 | **✅ تم التقسيم (2026-08-01):** §1–11 → `TERA_RUNTIME_PROTOCOLS_CORE.md` (758)، §12–18 → `TERA_RUNTIME_PROTOCOLS_CLIENT.md` (356)، الرئيسي يحتفظ بـ §19 | ✅ **مكتمل** |
-| `tera-system/Tera_Project_Preparation_Files.md` | 1,015 | **قرار (2026-08-01):** لا تقسيم — هو "Guide" مرجعي متماسك (26 قالباً مدمجاً). يُوثَّق في الخرائط كـ Guide وليس Catalog. | 🟡 **لا يُقسَّم — توثيق فقط** |
+| `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | 912 | **✅ تم التقسيم:** §29–38 → `TERA_RUNTIME_TEMPLATES_DELIVERY.md` (584)، §35–41 → `TERA_RUNTIME_TEMPLATES_PREPARATION.md` (376) | ✅ **مكتمل** |
+| `tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md` | 50 | **✅ تم التقسيم:** §1–11 → `TERA_RUNTIME_PROTOCOLS_CORE.md` (799)، §12–18 → `TERA_RUNTIME_PROTOCOLS_CLIENT.md` (355)، الرئيسي يحتفظ بـ §19 | ✅ **مكتمل** |
+| `tera-system/Tera_Project_Preparation_Files.md` | 464 | **✅ تم التقسيم:** المحتوى الأساسي بقي هنا، والتفاصيل المشروطة/الثانوية انتقلت إلى `tera-system/agent-helpers/Tera_Project_Preparation_Files_Conditional.md` (597) | ✅ **مكتمل** |
 
-**القاعدة:** أي تقسيم فعلي يُنفَّذ عبر SCP منفصل بعد موافقة Majed — لا يُقسَّم هنا تلقائياً.
-**الأولوية:** TERA_RUNTIME_TEMPLATES ✅ مكتمل — التالي: PROTOCOLS، ثم Preparation_Files.
+**القاعدة:** أي تقسيم فعلي يُنفَّذ عبر SCP منفصل بعد موافقة Majed.
+**الحالة:** تقسيم TERA_RUNTIME_TEMPLATES وTERA_RUNTIME_PROTOCOLS ودليل Preparation Files مكتمل بعد SCP-2026-08-28-003.

package/core/tera-system/AGENT_PERMISSION_MODEL.md

@@ -233,7 +233,7 @@
 | ReportingAnalyticsAgent | `REPORTING_ANALYTICS_AGENT` | `WRITE_DOCS` | — | يوثق متطلبات التقارير |
 | MaintenanceMigrationAgent | `MAINTENANCE_MIGRATION_AGENT` | `WRITE_DOCS` | — | يخطط للترحيل |
 | ProjectControlAgent | `PROJECT_CONTROL_AGENT` | `WRITE_CONTROL` | — | يتحكم في سجلات المشروع فقط |
-| SoftwareDesignerAgent | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
+| tera-software-designer (SoftwareDesignerAgent) | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
 | QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تقرير فقط | ينسق المراجعة فقط |
 | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير فقط | يراجع توافق الخطة فقط |
 | DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير | يبحث فقط |

package/core/tera-system/TeraArchitectureMap.md

@@ -16,7 +16,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
 | Strategic advisory and decision support | Helps Majed evaluate whether a decision, project, fork, or direction is right before execution; advisory only, no approval or execution authority | `.opencode/agents/tera-strategic-advisor.md` |
 | Project intake | Captures raw idea, technical context, missing information, and readiness | `TeraProjectIntakePolicy.md`, `project-inputs/` |
 | Client engagement and approval | Manages client profile, contacts, approval package, and change control — the commercial truth layer | `TeraClient*.md`, `clients/`, `.opencode/agents/tera-client-engagement.md` |
-| Solution preparation (phases 1–4) | Owned by مُهندس (ApplicationBlueprintAgent). Converts confirmed handoff into blueprint, intake, project decision, preparation planning, delegation, cross-review, baseline, and Engineering Handoff Package | `.opencode/agents/application-blueprint.md`, `Tera_Project_Preparation_Files.md`, `project-preparation/`, `runtime/TERA_SOLUTION_PREPARATION_*.md` |
+| Solution preparation (phases 1–4) | Owned by مُهندس (ApplicationBlueprintAgent). Converts confirmed handoff into blueprint, intake, project decision, preparation planning, delegation, cross-review, baseline, and Engineering Handoff Package | `.opencode/agents/application-blueprint.md`, `Tera_Project_Preparation_Files.md`, `agent-helpers/Tera_Project_Preparation_Files_Conditional.md`, `project-preparation/`, `runtime/TERA_SOLUTION_PREPARATION_*.md` |
 | Design governance | Controls design source decisions, design tokens, component rules, internal kits, and UI acceptance | `tera-system/design-system/`, `project-preparation/28_UI_UX_GUIDELINES.md` |
 | Engineering handoff gate | Two-gate handoff between مُهندس and Tera: Solution Readiness Gate → Engineering Handoff Package → Engineering Intake Gate | `ENGINEERING_HANDOFF_PACKAGE.md`, `project-control/` |
 | Execution orchestration (phases 5–7) | Owned by TeraAgent (Engineering Delivery Lead). Execution planning, delegation to Coding/QA/Audit agents, Pre/Post gates, implementation, delivery, closure | `TeraPreExecutionGate.md`, `runtime/TERA_RUNTIME_*.md`, `project-control/` |
@@ -41,6 +41,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
 | `tera-system/design-system/` | System design governance, schemas, gates, internal kits | Project-specific design decisions |
 | `tera-system/profiles/` | Technology-specific execution rules | Generic project policy |
 | `tera-system/knowledge-base/` | Reusable domain knowledge references | Project-specific client facts |
+| `tera-system/product-standards/` | Reusable active product standards | Runtime policy, client-specific records, or application code |
 | `tera-system/engineering-helpers/` | Shared engineering reference files | Language-specific profiles |
 | `tera-workshop/` | System development and tooling files | Core policy or project files |
 | `tera-workshop/tools/` | Official Tera updater tooling (tera-update.ps1 + batch updater) used to pin/upgrade Tera in client repositories | Client application code; replacing client-owned files |
@@ -66,7 +67,7 @@ Client / User Idea
 ```text
 Client Registration → Contacts → Application Intake
 → Client Questions through Majed → Discovery Coverage
-→ Client Approval Package → Approval Record → Execution Authorization
+→ Client Approval Package → Approval Record → Prototype Approval (Gate 6 — Tera first task TASK-PROTO-* + formal letter) → Execution Authorization (Gate 7)
 → TCEA Handoff to مُهندس
 → مُهندس: Blueprint + Phases 1–4 → Solution Baseline
 → Solution Readiness Gate → Engineering Handoff Package

package/core/tera-system/TeraClientPolicy.md

@@ -203,7 +203,7 @@ The default mandatory package is:
 - `10_CLIENT_APPROVAL_RECORD.md`
 - `11_CHANGE_CONTROL.md`
 
-If a file is not applicable to a very small project, Tera must still create an explicit section in `10_CLIENT_APPROVAL_RECORD.md` explaining why it is not applicable and what replaced it.
+If a file is not applicable to a very small project, Tera must still create an explicit section in `10_CLIENT_APPROVAL_RECORD.md` explaining why it is not applicable and what replaced it. Exception: `08_PROTOTYPE_PLAN.md` may not be marked not applicable except with a documented Majed waiver (WAIVED_BY_MAJED) — the prototype is mandatory for all applications (SCP-2026-08-28-001).
 
 ### Approval Gates
 
@@ -214,9 +214,35 @@ If a file is not applicable to a very small project, Tera must still create an e
 | Gate 3: Flow Approval | The client confirms the main user and business flows. |
 | Gate 4: Screen Approval | The client confirms the screen list and screen purposes. |
 | Gate 5: Design Direction Approval | The client confirms visual direction, tone, and references. |
-| Gate 6: Prototype Approval | The client confirms the prototype or prototype plan when applicable. |
+| Gate 6: Prototype Approval | The client confirms the actual prototype (built and reviewed) via a formal approval letter. Mandatory for all applications. Exception: documented Majed waiver (WAIVED_BY_MAJED). |
 | Gate 7: Execution Authorization | The client authorizes moving into implementation. |
 
+### Prototype Mandate (SCP-2026-08-28-001)
+
+```text
+1. Every application — external or internal — requires an approved prototype before
+   real implementation. The only exception is a documented Majed waiver
+   (WAIVED_BY_MAJED) recorded in 10_CLIENT_APPROVAL_RECORD.md with a reason.
+   No agent may override this gate.
+2. The prototype is built by Coding Agents under Tera as the FIRST execution task
+   (TASK-PROTO-*), isolated under project-control/prototypes/ — non-production,
+   deleted or archived after approval. DesignReviewer (ناقد) reviews it before
+   it is shown to Majed and the client (Maker/Checker pattern).
+3. Coverage: all screens listed in 06_SCREEN_MAP.md. Large applications use waves
+   (critical transaction/input screens first); reducing waves is a Majed decision only.
+4. Approval evidence: a formal Prototype Approval Letter (see
+   tera-workshop/client-templates/contractual/PROTOTYPE_APPROVAL_LETTER_TEMPLATE.md)
+   confirming the screens/fields/flows as prototyped, and acknowledging that any
+   later impactful change = priced Change Request on the client's responsibility.
+   The letter is the Gate 6 evidence; without it (or a Majed waiver) the prototype
+   is not approved.
+5. The prototype must trace strictly to the approved baseline
+   (07_SCREENS_AND_UI_STRUCTURE.md) — it validates and surfaces gaps; it does not
+   invent requirements. Objections within approved scope = free design iteration
+   (baseline update via مُهندس when needed). Expansion beyond approved scope =
+   priced Change Request (MR4).
+```
+
 ### Approval Record
 
 `10_CLIENT_APPROVAL_RECORD.md` must document: