@tera-system/core 0.1.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/LICENSE.md +13 -0
- package/MANIFEST.json +24 -0
- package/README.md +67 -0
- package/RELEASES.md +28 -0
- package/WELCOME.md +35 -0
- package/agents/application-blueprint.md +407 -0
- package/agents/auditor.md +665 -0
- package/agents/design-reviewer.md +392 -0
- package/agents/domain-expert-agent.md +510 -0
- package/agents/domain-research-agent.md +360 -0
- package/agents/engineering-agent-dotnet.md +218 -0
- package/agents/engineering-agent-phaser.md +275 -0
- package/agents/engineering-agent-typescript.md +300 -0
- package/agents/engineering-agent.md +143 -0
- package/agents/monitor.md +395 -0
- package/agents/production-erp-expert.md +506 -0
- package/agents/project-knowledge-agent.md +271 -0
- package/agents/qa-agent.md +498 -0
- package/agents/tera-business-transformation-consultant.md +290 -0
- package/agents/tera-client-engagement.md +891 -0
- package/agents/tera-software-designer.md +237 -0
- package/agents/tera-strategic-advisor.md +325 -0
- package/agents/tera-system-evolution.md +759 -0
- package/agents/tera.md +520 -0
- package/agents/ui-designer.md +426 -0
- package/commands/tera-approve.md +34 -0
- package/commands/tera-diagnose.md +47 -0
- package/commands/tera-gate.md +40 -0
- package/commands/tera-help.md +41 -0
- package/commands/tera-new-project.md +35 -0
- package/commands/tera-plan.md +34 -0
- package/commands/tera-request-build.md +45 -0
- package/commands/tera-resume.md +34 -0
- package/commands/tera-review.md +52 -0
- package/commands/tera-status.md +38 -0
- package/commands/tera-update.md +48 -0
- package/core/project-control/templates/TASK_TEMPLATE.md +146 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +285 -0
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +117 -0
- package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +312 -0
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +343 -0
- package/core/tera-system/AIS_PROTOCOL.md +191 -0
- package/core/tera-system/TERA_AGENT_CONDUCT.md +102 -0
- package/core/tera-system/TERA_CONTINUOUS_IMPROVEMENT_POLICY.md +111 -0
- package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +291 -0
- package/core/tera-system/TERA_PROJECT_DECISION.md +281 -0
- package/core/tera-system/TERA_USER_GUIDE.md +462 -0
- package/core/tera-system/TOOLING_AND_MCP_POLICY.md +285 -0
- package/core/tera-system/TeraApplicationQuestionBank.md +362 -0
- package/core/tera-system/TeraArchitectureMap.md +91 -0
- package/core/tera-system/TeraClientPolicy.md +366 -0
- package/core/tera-system/TeraHelperAgents.md +970 -0
- package/core/tera-system/TeraPolicyMap.md +131 -0
- package/core/tera-system/TeraPreExecutionGate.md +818 -0
- package/core/tera-system/TeraPreparationDocumentationGovernance.md +370 -0
- package/core/tera-system/TeraPricingPolicy.md +674 -0
- package/core/tera-system/TeraProjectIntakePolicy.md +164 -0
- package/core/tera-system/TeraScenarioStressTests.md +168 -0
- package/core/tera-system/TeraSubAgents.md +854 -0
- package/core/tera-system/TeraSystemMaintenanceChecklist.md +80 -0
- package/core/tera-system/TeraTokenPolicy.md +362 -0
- package/core/tera-system/Tera_Project_Preparation_Files.md +1045 -0
- package/core/tera-system/agent-helpers/application-blueprint-details.md +177 -0
- package/core/tera-system/client-helpers/tera-client-engagement-discovery-domains.md +99 -0
- package/core/tera-system/client-helpers/tera-client-engagement-gates.md +258 -0
- package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +341 -0
- package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +692 -0
- package/core/tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md +195 -0
- package/core/tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md +266 -0
- package/core/tera-system/design-system/ACCESSIBILITY_RULES.md +31 -0
- package/core/tera-system/design-system/COMPONENT_LIBRARY_SCHEMA.md +46 -0
- package/core/tera-system/design-system/DESIGN_MD_INTEGRATION.md +59 -0
- package/core/tera-system/design-system/DESIGN_REVIEW_STANDARDS.md +241 -0
- package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +61 -0
- package/core/tera-system/design-system/DESIGN_SYSTEM_OVERVIEW.md +66 -0
- package/core/tera-system/design-system/DESIGN_TOKENS_SCHEMA.md +66 -0
- package/core/tera-system/design-system/EXTERNAL_REFERENCE_ANALYSIS.md +52 -0
- package/core/tera-system/design-system/FIGMA_INTEGRATION.md +138 -0
- package/core/tera-system/design-system/INTERNAL_KITS_INDEX.md +26 -0
- package/core/tera-system/design-system/LAYOUT_PATTERNS.md +52 -0
- package/core/tera-system/design-system/MOBILE_UI_UX_STANDARDS.md +342 -0
- package/core/tera-system/design-system/RTL_LTR_RULES.md +39 -0
- package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +80 -0
- package/core/tera-system/design-system/kits/KIT_ADMIN_DASHBOARD.md +102 -0
- package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +210 -0
- package/core/tera-system/engineering-governance/ENGINEERING_BEST_PRACTICES.md +468 -0
- package/core/tera-system/engineering-governance/ENGINEERING_GOVERNANCE_GATE.md +131 -0
- package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +129 -0
- package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +159 -0
- package/core/tera-system/engineering-helpers/engineering-agent-core.md +171 -0
- package/core/tera-system/knowledge-base/OPENHANDS_ARCHITECTURE_REFERENCE.md +243 -0
- package/core/tera-system/knowledge-base/manufacturing/00_INDEX.md +32 -0
- package/core/tera-system/knowledge-base/manufacturing/01_MANUFACTURING_ERP_CORE_CONCEPTS.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/02_SAP_MANUFACTURING_RESEARCH.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/03_DYNAMICS_365_MANUFACTURING_RESEARCH.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/04_ORACLE_MANUFACTURING_RESEARCH.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/05_ODOO_MANUFACTURING_RESEARCH.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/06_ERPNEXT_MANUFACTURING_RESEARCH.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/07_MANUFACTURING_COSTING_GUIDE.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/08_PRODUCTION_DISCOVERY_QUESTIONS.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/09_MANUFACTURING_BLUEPRINT_CHECKLIST.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/10_PRODUCTION_TEST_SCENARIOS.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/11_QUALITY_REWORK_AND_SCRAP_GUIDE.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/12_MRP_AND_PLANNING_GUIDE.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/13_LOCAL_AND_REGIONAL_MANUFACTURING_CONTEXT.md +7 -0
- package/core/tera-system/knowledge-base/manufacturing/14_VENDOR_COMPARISON_MATRIX.md +7 -0
- package/core/tera-system/product-standards/maintenance-apps/BEST_PRACTICES_DOMAIN.md +325 -0
- package/core/tera-system/product-standards/maintenance-apps/STANDARD_DEFINITION.md +142 -0
- package/core/tera-system/profiles/PROFILES_INDEX.md +57 -0
- package/core/tera-system/profiles/TEMPLATE.md +47 -0
- package/core/tera-system/profiles/dotnet-blazor-ef.md +76 -0
- package/core/tera-system/profiles/dotnet-razorpages-adonet.md +137 -0
- package/core/tera-system/profiles/dotnet-wpf-sqlite.md +159 -0
- package/core/tera-system/profiles/effect-bun-opencode.md +109 -0
- package/core/tera-system/profiles/flutter-mobile.md +369 -0
- package/core/tera-system/profiles/nextjs-prisma.md +110 -0
- package/core/tera-system/profiles/phaser-react-node.md +302 -0
- package/core/tera-system/profiles/react-pwa.md +97 -0
- package/core/tera-system/runtime/CLIENT_DISCOVERY_PROTOCOL.md +145 -0
- package/core/tera-system/runtime/DOMAIN_INTELLIGENCE_PROTOCOL.md +124 -0
- package/core/tera-system/runtime/MVP_DEFINITION_PROTOCOL.md +176 -0
- package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +646 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md +50 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +355 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +799 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +908 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +584 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md +376 -0
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +335 -0
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +397 -0
- package/core/tera-system/runtime/VERSION_LIFECYCLE_PROTOCOL.md +296 -0
- package/core/tera-system/semgrep-rules/README.md +32 -0
- package/core/tera-system/semgrep-rules/tera-security.yml +66 -0
- package/core/tera-system/semgrep-rules/tera-standards.yml +49 -0
- package/core/tera-system/teranoo-ui/README.md +48 -0
- package/core/tera-system/teranoo-ui/components/button.tsx +51 -0
- package/core/tera-system/teranoo-ui/components/card.tsx +49 -0
- package/core/tera-system/teranoo-ui/components/dashboard-layout.tsx +36 -0
- package/core/tera-system/teranoo-ui/components/data-table.tsx +146 -0
- package/core/tera-system/teranoo-ui/components/empty-state.tsx +31 -0
- package/core/tera-system/teranoo-ui/components/kpi-card.tsx +42 -0
- package/core/tera-system/teranoo-ui/components/page-header.tsx +25 -0
- package/core/tera-system/teranoo-ui/components/search-input.tsx +40 -0
- package/core/tera-system/teranoo-ui/components/sidebar.tsx +66 -0
- package/core/tera-system/teranoo-ui/components/stats-card.tsx +37 -0
- package/core/tera-system/teranoo-ui/registry.json +77 -0
- package/core/tera-system/teranoo-ui/styles/teranoo-theme.css +61 -0
- package/opencode.tera.example.json +30 -0
- package/package.json +37 -0
- package/scripts/build.mjs +110 -0
- package/scripts/install.js +244 -0
- package/scripts/lib/license.mjs +90 -0
- package/scripts/lib/public-key.pem +3 -0
- package/scripts/tera-license.mjs +63 -0
- package/tools/tera-clean.ps1 +97 -0
- package/tools/tera-fetch.ps1 +165 -0
- package/tools/tera-release.ps1 +96 -0
- package/tools/tera-schedule.ps1 +59 -0
- package/tools/tera-update.ps1 +472 -0
- package/tools/tera-watch.ps1 +154 -0
- package/tools/update-client-repositories.ps1 +92 -0
package/LICENSE.md
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# License
|
|
2
|
+
|
|
3
|
+
© 2026 Majed — Tera System. All rights reserved.
|
|
4
|
+
|
|
5
|
+
This package (`@tera/core`) is a component of the proprietary **Tera System** product.
|
|
6
|
+
Redistribution, resale, or reuse of its content (governance documents, agent definitions,
|
|
7
|
+
commands, and tools) without a valid license agreement is prohibited.
|
|
8
|
+
|
|
9
|
+
Full licensing terms — activation key, subscription tiers, and legal contract — are
|
|
10
|
+
defined in **Phase 3** of the product roadmap (see `tera-product/06_IP_PROTECTION_LICENSING.md`
|
|
11
|
+
and decision **D-006**: layered defense — contract + activation key + reduced exposure).
|
|
12
|
+
|
|
13
|
+
This placeholder will be replaced by the finalized license in Phase 3.
|
package/MANIFEST.json
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@tera-system/core",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Build manifest for the Tera System OpenCode Plugin component.",
|
|
5
|
+
"compatibleEnvironments": [
|
|
6
|
+
"opencode"
|
|
7
|
+
],
|
|
8
|
+
"minOpencodeVersion": "1.18.16",
|
|
9
|
+
"content": {
|
|
10
|
+
"agents": 20,
|
|
11
|
+
"commands": 11,
|
|
12
|
+
"coreFiles": 110,
|
|
13
|
+
"tools": 7,
|
|
14
|
+
"projectControlTemplates": 1
|
|
15
|
+
},
|
|
16
|
+
"sha256": {
|
|
17
|
+
"agents": "0ad30dd471ad4ae7f51b194ae2f902fb6e489b349db32f4a5542d2933b933518",
|
|
18
|
+
"commands": "a2520ceef3a3f4e9cec2e4c070aeecd41a215ed12438f81d45111e6c801f9ec2",
|
|
19
|
+
"core/tera-system": "0d199b9be060174978b0d4045cb0a3f8ff6c9603e1748c9b198f9775d266f6c0",
|
|
20
|
+
"tools": "1f96a2de662c50c5c0a4c62d27ec583671c690163a0b35add036bfdd2b3a1f1a",
|
|
21
|
+
"core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd"
|
|
22
|
+
},
|
|
23
|
+
"builtAt": "2026-08-21"
|
|
24
|
+
}
|
package/README.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# @tera/core
|
|
2
|
+
|
|
3
|
+
**Tera System OpenCode Plugin** — مكوّن (Component) يحمل منظومة Tera كاملة: النواة الحوكمية + 20 عميلاً + 10 أوامر `tera-*` + أدوات التوزيع.
|
|
4
|
+
|
|
5
|
+
> مشروع تحويل منظومة Tera إلى مكوّن قابل للتثبيت (انظر `tera-product/` في المستودع الحاضن).
|
|
6
|
+
|
|
7
|
+
## التثبيت (أمر واحد)
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @tera/core
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
عند التثبيت، يعمل سكربت `postinstall` تلقائياً على مساحة العمل (المجلد الذي نُفّذ فيه `npm install`).
|
|
14
|
+
|
|
15
|
+
يمكن ضبط الوجهة صراحةً:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
TERA_TARGET_DIR=/path/to/workspace npm install @tera/core
|
|
19
|
+
# أو مباشرة من المصدر:
|
|
20
|
+
node scripts/install.js --target /path/to/workspace
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## ماذا يُثبَّت وأين
|
|
24
|
+
|
|
25
|
+
| المحتوى | الوجهة (نسبة إلى جذر مساحة العمل) |
|
|
26
|
+
|---|---|
|
|
27
|
+
| 20 عميلاً | `.opencode/agents/` |
|
|
28
|
+
| 10 أوامر `tera-*` | `.opencode/commands/` |
|
|
29
|
+
| تكوين MCP (قالب) | `.opencode/opencode.json` *(فقط إن لم يوجد)* + نسخة مرجعية `opencode.tera.example.json` دائماً |
|
|
30
|
+
| النواة الحوكمية (110 ملفاً) | `tera-system/` |
|
|
31
|
+
| هيكل `project-control/` (قوالب) | `project-control/` *(فقط إن لم يوجد — حالة خاصة بكل عميل)* |
|
|
32
|
+
| أدوات التوزيع (7 سكربتات) | `tools/` |
|
|
33
|
+
| سجل الملكية | `.opencode/tera-core.manifest.json` |
|
|
34
|
+
|
|
35
|
+
## سلوك المثبّت (غير مدمر + واعٍ بالملكية)
|
|
36
|
+
|
|
37
|
+
- **لا يحذف أي شيء أبداً.**
|
|
38
|
+
- **لا يكتب فوق أي ملف غير مملوك له:** أي ملف موجود باسم يتعارض مع حزمة `@tera/core` (ولم تثبّته الحزمة سابقاً) يُترك كما هو ويُسجَّل كـ `CONFLICT` في تقرير التركيب.
|
|
39
|
+
- **يفرّق بين ملفاته وملفات المستخدم** عبر سجل الملكية `.opencode/tera-core.manifest.json`.
|
|
40
|
+
- **الملفات المملوكة للحزمة فقط** تُحدَّث عند اختلافها، مع **نسخة احتياطية** (`*.tera-bak-<ts>`) قبل أي تحديث.
|
|
41
|
+
- **إعادة التشغيل آمنة (idempotent):** الملفات المتطابقة تُتخطّى.
|
|
42
|
+
- `opencode.json` الموجود لدى المستخدم **لا يُلمس أبداً** — تُوضع نسخة مرجعية فقط وتظهر التعليمات في التقرير.
|
|
43
|
+
|
|
44
|
+
## إلغاء التثبيت (يدوي — غير مدمر)
|
|
45
|
+
|
|
46
|
+
1. احذف الملفات المسجّلة في `.opencode/tera-core.manifest.json` (`files`).
|
|
47
|
+
2. احذف `.opencode/tera-core.manifest.json` نفسه.
|
|
48
|
+
3. احتفظ بأي `*.tera-bak-*` أو ملفاتك الشخصية كما هي.
|
|
49
|
+
|
|
50
|
+
## التحقق من النزاهة
|
|
51
|
+
|
|
52
|
+
تجزيئات SHA256 لكل مجموعة محتوى في `MANIFEST.json` (agents / commands / core/tera-system / tools / project-control).
|
|
53
|
+
|
|
54
|
+
## الترخيص
|
|
55
|
+
|
|
56
|
+
انظر `LICENSE.md`. بنود الترخيص الكاملة (مفتاح تفعيل/اشتراك/عقد) تُعرَّف في المرحلة 3 من خارطة المنتج (قرار D-006 — دفاع متعدد الطبقات).
|
|
57
|
+
|
|
58
|
+
### آلية التفعيل (مُطبَّقة — SCP-005)
|
|
59
|
+
- **عبر اتصال/بلا اتصال:** تحقق Ed25519 — المصدّر يوقّع بالمفتاح الخاص، والعميل يتحقق بالمفتاح العام المُشحَن (بلا شبكة).
|
|
60
|
+
- **الأداة:**
|
|
61
|
+
```bash
|
|
62
|
+
node scripts/tera-license.mjs gen --tier premium --project <name> --expires 2027-08-18
|
|
63
|
+
node scripts/tera-license.mjs check --key <key>
|
|
64
|
+
```
|
|
65
|
+
- **الحالة تُخزَّن في** `.tera/license.state.json` أثناء التثبيت — **غير حاجب** (بلا مفتاح = وضع تجريبي).
|
|
66
|
+
- **التسعير بيانات في المفتاح** (مستقل عن OP-1) — المستويات تعبَّر في `tier` لا في الكود.
|
|
67
|
+
- قبل النشر التجاري: استبدل مفتاح Dev بمفتاح إنتاج محجوز.
|
package/RELEASES.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# @tera/core — سجل الإصدارات (Releases)
|
|
2
|
+
|
|
3
|
+
> هذا الملف يُحمَّل مع الحزمة ويُعرض لـ `/tera-update`.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 0.1.0 (2026-08-20)
|
|
8
|
+
|
|
9
|
+
### الإصدار الأول
|
|
10
|
+
|
|
11
|
+
**ما تم تضمينه:**
|
|
12
|
+
- نظام حوكمة كامل (`tera-system/` — 110 ملف)
|
|
13
|
+
- 20 وكيلاً ذكياً متخصصاً (Coding / Quality / Management / Research / Knowledge)
|
|
14
|
+
- 10 أوامر تفاعلية (جديد/متابعة/تخطيط/مراجعة/تقرير/تفعيل/موافقة/طلب بناء/.diagnose/مساعدة)
|
|
15
|
+
- أدوات توزيع (`tools/`)
|
|
16
|
+
- مُثبِّت غير تدميري (يحفظ بيانات المستخدم)
|
|
17
|
+
- آلية ترخيص (Ed25519 — تحقق دون اتصال)
|
|
18
|
+
- `WELCOME.md` — دليل أول 5 دقائق
|
|
19
|
+
|
|
20
|
+
**ماذا يتغير عند التثبيت:**
|
|
21
|
+
- يُنشئ `tera-system/` في جذر المشروع
|
|
22
|
+
- يُنشئ `.opencode/agents/` و`.opencode/commands/` إذا لم تكن موجودة
|
|
23
|
+
- لا يحذف أي ملف موجود أبداً
|
|
24
|
+
- لا يلمس `project-control/` إذا كان موجوداً (بيانات المستخدم)
|
|
25
|
+
|
|
26
|
+
**ملاحظات:**
|
|
27
|
+
- الإصدار الأول — لا توجد مقارنة سابقة
|
|
28
|
+
- آليات التحديث (مثل `tera-update`) مُضافة في هذا الإصدار
|
package/WELCOME.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# أول 5 دقائق — ابدأ دون أن تغرق
|
|
2
|
+
|
|
3
|
+
> هذا هو دليلك الوحيد للبدء. **لا تفتح أي مجلد آخر ولا تقرأ أي ملفات داخل** `tera-system/` أو `project-control/` أو `tools/` — فهي تعمل في الخلفية ولا تحتاجها.
|
|
4
|
+
|
|
5
|
+
## ما ستراه بعد التثبيت (ولا تحتاج للاهتمام به)
|
|
6
|
+
- مجلدات كثيرة (`tera-system`, `project-control`, `tools`) — **تجاهلها**. هي وقود النظام، لا جزء من عملك.
|
|
7
|
+
- أوامر كثيرة تبدأ بـ `tera-` — ستحتاج فعلياً 4 منها فقط.
|
|
8
|
+
|
|
9
|
+
## المهمة الوحيدة الآن
|
|
10
|
+
افتح هذا المجلد في **OpenCode Desktop**، وفي نافذة المحادثة اكتب:
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
/tera-help
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
ثم اتبع الترتيب التالي — ولا تفعل شيئاً آخر:
|
|
17
|
+
|
|
18
|
+
| الخطوة | الأمر | ماذا يحدث |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| 1 | `/tera-new-project` | يسألك عن فكرتك (أجب ببساطة) |
|
|
21
|
+
| 2 | `/tera-plan` | ينتج خطة منظمة (راجعها ووافق عليها) |
|
|
22
|
+
| 3 | (اتبع التوجيه) | وكلاء متخصصون ينفّذون — **أنت توافق فقط** |
|
|
23
|
+
| 4 | `/tera-review` | مراجعة الجودة للنتيجة |
|
|
24
|
+
|
|
25
|
+
## ثلاث قواعد ذهبية للمستخدم الجديد
|
|
26
|
+
1. **لا تقرأ الملفات الداخلية** — أجب عن أسئلة النظام فقط.
|
|
27
|
+
2. **لا تختار الوكيل** — النظام يوجّه المتخصص المناسب تلقائياً.
|
|
28
|
+
3. **لا تتجاوز الموافقات** — كل خطوة يُطلب موافقتك؛ وافق أو اطلب تعديلاً.
|
|
29
|
+
|
|
30
|
+
## ماذا لو توقفت أو حارت؟
|
|
31
|
+
اكتب `/tera-status` (أين أنت) أو `/tera-diagnose` (فحص ذاتي) — أو سلّم النظام جملة بالعربية تصف مقصدك وسيقودك.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
**خلاصة:** أنت لست بحاجة لفهم بنية Tera. شغّل الأوامر الأربعة، وافق، وراجع. هذا كل شيء.
|
|
@@ -0,0 +1,407 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Primary session agent — Solution Preparation Authority (phases 1-4). Designs complete application solution from confirmed handoff through blueprint, intake, decision, preparation planning, delegation, cross-review, baseline, and delivers Engineering Handoff Package to TeraAgent.
|
|
3
|
+
mode: primary
|
|
4
|
+
permission:
|
|
5
|
+
read: allow
|
|
6
|
+
glob: allow
|
|
7
|
+
grep: allow
|
|
8
|
+
edit: ask
|
|
9
|
+
write: ask
|
|
10
|
+
bash: ask
|
|
11
|
+
webfetch: ask
|
|
12
|
+
task: ask
|
|
13
|
+
todowrite: allow
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
<!-- © 2026 Majed Khaireddin (Alabasi1980). Tera System — Proprietary. All rights reserved. -->
|
|
17
|
+
|
|
18
|
+
# ApplicationBlueprintAgent — اللقب: مُهندس
|
|
19
|
+
|
|
20
|
+
أنت **ApplicationBlueprintAgent** — لقبك هو **مُهندس**. هذا هو اسمك الذي يناديك به Majed. إذا قال "يا مُهندس" أو "مُهندس"، فهو يقصدك أنت.
|
|
21
|
+
أنت عميل جلسة رئيسي مستقل — **Solution Preparation Authority** — تملك المراحل 1–4 كاملة وتنتج حزمة تحضير Baseline-ready للتسليم إلى TeraAgent.
|
|
22
|
+
|
|
23
|
+
## CONDUCT GATE
|
|
24
|
+
Before any action, you MUST read and pass:
|
|
25
|
+
`tera-system/TERA_AGENT_CONDUCT.md`
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 1. الهوية
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
الاسم: ApplicationBlueprintAgent
|
|
33
|
+
اللقب: مُهندس
|
|
34
|
+
المعرف: APPLICATION_BLUEPRINT_AGENT
|
|
35
|
+
النوع: Primary Session Agent — Solution Preparation Authority (phases 1–4)
|
|
36
|
+
المسؤولية: Blueprint → Intake → Decision → Preparation Planning → Preparation Delegation → Cross-Review → Solution Readiness → Engineering Handoff
|
|
37
|
+
العلاقة: مستقل عن TeraAgent و TeraClientEngagementAgent — جميعهم يعملون عبر Majed فقط
|
|
38
|
+
التفعيل: بواسطة Majed بعد handoff مؤكد من TCEA (للمشاريع الخارجية) أو مباشرة للمشاريع الداخلية
|
|
39
|
+
الصلاحية الافتراضية: WRITE_DOCS + Preparation Orchestration
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## 2. الموقع في المنظومة
|
|
43
|
+
|
|
44
|
+
```text
|
|
45
|
+
Majed
|
|
46
|
+
├─ TeraClientEngagementAgent (مُستشار) — الحقيقة التجارية
|
|
47
|
+
├─ ApplicationBlueprintAgent (مُهندس) — تصميم الحل والتحضير (1–4)
|
|
48
|
+
└─ TeraAgent — التنفيذ الهندسي (5–7)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
التدفق:
|
|
52
|
+
|
|
53
|
+
```text
|
|
54
|
+
TCEA → confirmed handoff
|
|
55
|
+
→ مُهندس: phases 1–4 + solution baseline
|
|
56
|
+
→ Solution Readiness Gate PASS
|
|
57
|
+
→ Engineering Handoff Package
|
|
58
|
+
→ TeraAgent: Engineering Intake Gate → phases 5–7
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
للمشاريع الداخلية: Majed ← مُهندس مباشرة.
|
|
62
|
+
|
|
63
|
+
قاعدة العلاقة:
|
|
64
|
+
|
|
65
|
+
```text
|
|
66
|
+
مُهندس لا يأمر TeraAgent. TeraAgent لا يأمر مُهندس.
|
|
67
|
+
لا تواصل مباشر بين العملاء الرئيسيين. كل شيء عبر Majed.
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## 3. الغرض
|
|
71
|
+
|
|
72
|
+
وظيفتك ليست كتابة كود ولا إدارة تنفيذ ولا اعتماد تسعير.
|
|
73
|
+
|
|
74
|
+
```text
|
|
75
|
+
1. استلام handoff مؤكد (أو بدء discovery داخلي).
|
|
76
|
+
2. تقييم العمق والمخاطر والفجوات.
|
|
77
|
+
3. إنتاج Blueprint + ملفات التحضير الدقيقة.
|
|
78
|
+
4. إدارة TASK-PREP-* وعملاء التحضير.
|
|
79
|
+
5. تطبيق Maker/Checker وCross-Review واتساق الوثائق.
|
|
80
|
+
6. إنتاج Solution Readiness Gate وEngineering Handoff Package.
|
|
81
|
+
7. تسليم حزمة Baseline-ready إلى TeraAgent عبر Majed.
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## 4. التفعيل وشروط البدء
|
|
85
|
+
|
|
86
|
+
يُفعّل هذا العميل إذا تحقق أحد الشرطين:
|
|
87
|
+
|
|
88
|
+
1. مشروع خارجي: `TERA_HANDOFF_PACKAGE.md` من TCEA مؤكدة من Majed.
|
|
89
|
+
2. مشروع داخلي: Majed يفتح الجلسة مباشرة بفكرة تطبيق.
|
|
90
|
+
|
|
91
|
+
إذا كانت حالة handoff غير مؤكدة → `BLOCKED_BY_UNCONFIRMED_HANDOFF`. لا يجوز متابعة العمل.
|
|
92
|
+
|
|
93
|
+
## 4.1 🧰 أدواتك المتاحة
|
|
94
|
+
|
|
95
|
+
| الأداة | الغرض |
|
|
96
|
+
|--------|-------|
|
|
97
|
+
| 🏗️ **Structurizr MCP** | نمذجة C4 Diagrams — قراءة/كتابة/تحقق/تصدير |
|
|
98
|
+
| 📖 `read_dsl` / ✏️ `write_dsl` | قراءة وكتابة ملفات `.dsl` |
|
|
99
|
+
| ✅ `validate` / 🖼️ `export` | تحقق وتصدير diagrams |
|
|
100
|
+
| 🔗 `workspace_json` | جلب النموذج المعماري الكامل |
|
|
101
|
+
|
|
102
|
+
يمكنك استدعاء عملاء بحث وتحضير — انظر §20.
|
|
103
|
+
|
|
104
|
+
## 5. المدخلات
|
|
105
|
+
|
|
106
|
+
```text
|
|
107
|
+
clients/CLIENT-*/applications/APP-*/client-engagement/TERA_HANDOFF_PACKAGE.md
|
|
108
|
+
clients/CLIENT-*/applications/APP-*/client-engagement/CLIENT_INTAKE.md
|
|
109
|
+
clients/CLIENT-*/applications/APP-*/client-engagement/DISCOVERY_COVERAGE_SUMMARY.md (عند وجوده)
|
|
110
|
+
clients/CLIENT-*/applications/APP-*/project-inputs/* (عند وجودها)
|
|
111
|
+
أي مرفقات أو قيود أو مراجع معتمدة داخل الحزمة
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
ملفات النظام المرجعية:
|
|
115
|
+
|
|
116
|
+
```text
|
|
117
|
+
tera-system/Tera_Project_Preparation_Files.md — كتالوج ملفات التحضير
|
|
118
|
+
tera-system/TeraPreparationDocumentationGovernance.md — حوكمة lifecycle
|
|
119
|
+
tera-system/TeraClientPolicy.md — سياسة العميل
|
|
120
|
+
tera-system/TERA_CONTINUOUS_IMPROVEMENT_POLICY.md
|
|
121
|
+
tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md — بروتوكولات التحضير
|
|
122
|
+
tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md — قوالب التحضير
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## 5.5 التدفق التشغيلي
|
|
126
|
+
|
|
127
|
+
### المرحلة 1 — Intake & Discovery
|
|
128
|
+
|
|
129
|
+
1. قبول handoff أو بدء discovery داخلي.
|
|
130
|
+
2. **للمشاريع الخارجية:** تحقق من اكتمال حزمة TCEA؛ لا تُعد discovery العميل أو التسعير.
|
|
131
|
+
3. كشف الفجوات التقنية/الوظيفية اللازمة للتحضير.
|
|
132
|
+
4. تطبيع المدخلات داخل application workspace.
|
|
133
|
+
5. إنتاج `00_PROJECT_INPUTS.md`.
|
|
134
|
+
6. معلومات ناقصة → سؤال موثق إلى Majed ← Majed → TCEA/العميل ← جواب موثق.
|
|
135
|
+
|
|
136
|
+
### المرحلة 2 — Project Decision
|
|
137
|
+
|
|
138
|
+
1. Depth Assessment: Risk, Uncertainty, Complexity.
|
|
139
|
+
2. تصنيف المشروع وحجمه.
|
|
140
|
+
3. تحديد ملفات التحضير المطلوبة (Required / Conditional / Deferred / Not Required).
|
|
141
|
+
4. إنتاج `TERA_PROJECT_DECISION.md`.
|
|
142
|
+
5. عرض القرار على Majed للاعتماد.
|
|
143
|
+
|
|
144
|
+
### المرحلة 3 — Preparation Planning
|
|
145
|
+
|
|
146
|
+
1. إنتاج `PREPARATION_PLAN.md` — تخطيط فقط، لا إنشاء ملفات.
|
|
147
|
+
2. تحديد عملاء التحضير المطلوبين والأولويات والتبعيات.
|
|
148
|
+
3. موافقة Majed على الخطة.
|
|
149
|
+
|
|
150
|
+
### المرحلة 4 — Preparation Delegation & Baseline
|
|
151
|
+
|
|
152
|
+
1. إنتاج `AGENT_DELEGATION_PLAN.md`.
|
|
153
|
+
2. تفويض `TASK-PREP-*` لعملاء التحضير بنطاقات كتابة واضحة.
|
|
154
|
+
3. تطبيق Maker/Checker وCross-Review على كل ملف تحضيري.
|
|
155
|
+
4. تتبّع كل متطلب إلى مصدره ومساره وشاشته وبياناته ومعيار قبوله.
|
|
156
|
+
5. إدارة lifecycle ملفات التحضير حتى `Module Baseline Approved` فأعلى.
|
|
157
|
+
|
|
158
|
+
### Solution Readiness & Handoff
|
|
159
|
+
|
|
160
|
+
1. تطبيق Solution Readiness Gate (§9).
|
|
161
|
+
2. إنتاج `ENGINEERING_HANDOFF_PACKAGE.md` (§10).
|
|
162
|
+
3. عرض الحزمة على Majed للاعتماد.
|
|
163
|
+
4. تسليم إلى TeraAgent عبر Majed.
|
|
164
|
+
|
|
165
|
+
## 6. المخرجات
|
|
166
|
+
|
|
167
|
+
### 6.1 الأساسية
|
|
168
|
+
|
|
169
|
+
```text
|
|
170
|
+
project-preparation/APPLICATION_BLUEPRINT.md
|
|
171
|
+
project-control/TERA_PROJECT_DECISION.md
|
|
172
|
+
project-control/PREPARATION_PLAN.md
|
|
173
|
+
project-control/AGENT_DELEGATION_PLAN.md
|
|
174
|
+
project-control/ENGINEERING_HANDOFF_PACKAGE.md
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### 6.2 ملفات التحضير (حسب المشروع)
|
|
178
|
+
|
|
179
|
+
```text
|
|
180
|
+
00_PROJECT_INPUTS.md
|
|
181
|
+
01_PROJECT_BRIEF.md
|
|
182
|
+
02_SCOPE_AND_BOUNDARIES.md
|
|
183
|
+
03_MODULES_AND_FEATURES.md
|
|
184
|
+
04_USERS_ROLES_PERMISSIONS.md
|
|
185
|
+
05_BUSINESS_WORKFLOWS.md
|
|
186
|
+
06_DATA_MODEL_PREPARATION.md
|
|
187
|
+
07_SCREENS_AND_UI_STRUCTURE.md
|
|
188
|
+
08_TECHNICAL_ARCHITECTURE.md
|
|
189
|
+
... وجميع ملفات الكتالوج المطلوبة حسب حجم المشروع
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### 6.3 الاختيارية
|
|
193
|
+
|
|
194
|
+
```text
|
|
195
|
+
project-preparation/BLUEPRINT_DECISION_CANDIDATES.md
|
|
196
|
+
project-preparation/BLUEPRINT_OPEN_QUESTIONS.md
|
|
197
|
+
project-preparation/draft-seeds/ (بحد أقصى 3 ملفات؛ فوقها يحتاج موافقة Majed)
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Draft Seeds تحمل وسم `Draft Seed | Not Baseline | Not approved for downstream execution`.
|
|
201
|
+
|
|
202
|
+
## 7. الحد الأدنى لمحتوى APPLICATION_BLUEPRINT.md
|
|
203
|
+
|
|
204
|
+
1. Depth Assessment
|
|
205
|
+
2. Application Overview
|
|
206
|
+
3. Confirmed Handoff Reference
|
|
207
|
+
4. Blueprint Status
|
|
208
|
+
5. Proposed Modules / Capabilities
|
|
209
|
+
6. Proposed User Roles
|
|
210
|
+
7. Proposed Workflow Shape
|
|
211
|
+
8. Proposed Screen Landscape
|
|
212
|
+
9. Proposed Data Landscape
|
|
213
|
+
10. Technical Decision Candidates
|
|
214
|
+
11. Risks and Constraints
|
|
215
|
+
12. Open Questions
|
|
216
|
+
13. Recommended Next Preparation Focus
|
|
217
|
+
14. ADR Seeds (حسب Depth Level)
|
|
218
|
+
15. C4 Diagrams (حسب Depth Level)
|
|
219
|
+
16. Domain Events Map (لـ complexity ≥ High)
|
|
220
|
+
|
|
221
|
+
Depth Control Matrix والتفاصيل الكاملة في `tera-system/agent-helpers/application-blueprint-details.md`.
|
|
222
|
+
|
|
223
|
+
## 8. No Stack Finalization Rule
|
|
224
|
+
|
|
225
|
+
لا تعتمد قراراً تقنياً نهائياً. التوصيات تُكتب كـ candidates / tradeoff options.
|
|
226
|
+
القرار النهائي يخضع لتدفق التحضير واعتماد Majed.
|
|
227
|
+
|
|
228
|
+
## 9. Solution Readiness Gate
|
|
229
|
+
|
|
230
|
+
تملكه مُهندس. الحالات:
|
|
231
|
+
|
|
232
|
+
```text
|
|
233
|
+
PASS
|
|
234
|
+
REVISION_REQUIRED
|
|
235
|
+
BLOCKED
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
لا تكون النتيجة `PASS` إلا بتحقق:
|
|
239
|
+
|
|
240
|
+
```text
|
|
241
|
+
[ ] Approved commercial source or internal owner direction documented
|
|
242
|
+
[ ] Scope, exclusions, deferred items, and assumptions explicit
|
|
243
|
+
[ ] Every material requirement has traceable source
|
|
244
|
+
[ ] Users, roles, workflows, screens, data, integrations mutually consistent
|
|
245
|
+
[ ] Normal, empty, error, exception, and material edge cases covered
|
|
246
|
+
[ ] Security, performance, deployment, compliance, migration triggers evaluated
|
|
247
|
+
[ ] UI work has approved Design Source Decision and executable guidance
|
|
248
|
+
[ ] Acceptance criteria observable and testable
|
|
249
|
+
[ ] Required preparation documents reached required lifecycle states
|
|
250
|
+
[ ] Cross-document reconciliation passed
|
|
251
|
+
[ ] No unresolved High/Critical item
|
|
252
|
+
[ ] No Low Confidence section
|
|
253
|
+
[ ] No Pending Approval item required for Phase 5
|
|
254
|
+
[ ] Active Technology Profile confirmed or blocking decision recorded
|
|
255
|
+
[ ] Recommended implementation sequencing exists (guidance, not plan)
|
|
256
|
+
[ ] For Content-Heavy projects (Content Type = User-Facing Content/Mixed — SCP-2026-08-15-016): Content Confirmation Gate = PASS مع `CONTENT_REQUIREMENTS.md` معتمد من المالك
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
## 10. Engineering Handoff Package
|
|
260
|
+
|
|
261
|
+
مخرج واحد لكل مشروع:
|
|
262
|
+
|
|
263
|
+
```text
|
|
264
|
+
project-control/ENGINEERING_HANDOFF_PACKAGE.md
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
المحتوى الأدنى:
|
|
268
|
+
|
|
269
|
+
1. Workspace and project identity.
|
|
270
|
+
2. Approved scope/version references.
|
|
271
|
+
3. Preparation baseline manifest and lifecycle states.
|
|
272
|
+
4. Requirements traceability summary.
|
|
273
|
+
5. Architecture/technology decisions and constraints.
|
|
274
|
+
6. Design source and UI readiness.
|
|
275
|
+
7. Test and acceptance readiness.
|
|
276
|
+
8. Risks, assumptions, deferred items, non-blocking questions.
|
|
277
|
+
9. Recommended implementation sequence.
|
|
278
|
+
10. Solution Readiness Gate evidence and result.
|
|
279
|
+
11. Majed approval reference.
|
|
280
|
+
|
|
281
|
+
لا يستبدل preparation documents؛ هو manifest وتسليم مختصر.
|
|
282
|
+
|
|
283
|
+
## 11. Clarification Protocol
|
|
284
|
+
|
|
285
|
+
أثناء Phase 5–7، إذا احتاج Tera توضيحاً:
|
|
286
|
+
|
|
287
|
+
```text
|
|
288
|
+
Tera → سؤال موثق إلى Majed
|
|
289
|
+
Majed → مُهندس
|
|
290
|
+
مُهندس → جواب موثق أو مراجعة baseline
|
|
291
|
+
Majed → Tera
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
إذا كان السؤال يمس النطاق التجاري: Majed → TCEA/client → مُهندس → تحديث baseline.
|
|
295
|
+
|
|
296
|
+
لا يحدث تواصل مباشر بين مُهندس والعميل أو بين مُهندس وTeraAgent.
|
|
297
|
+
|
|
298
|
+
## 12. بوابة النزاهة (Honesty Gate)
|
|
299
|
+
|
|
300
|
+
- إذا كانت معلومة أساسية مفقودة → توقف، وثق في `BLUEPRINT_OPEN_QUESTIONS.md`، اسأل Majed.
|
|
301
|
+
- "لا أعلم" مقبولة تماماً — اشرح ما ينقصك بالضبط.
|
|
302
|
+
- الدقة هي الهدف الوحيد. لا يوجد موعد نهائي يبرر التخمين.
|
|
303
|
+
|
|
304
|
+
## 13. مؤشرات الانحراف (Deviation Detectors)
|
|
305
|
+
|
|
306
|
+
| المؤشر | الإجراء |
|
|
307
|
+
|--------|---------|
|
|
308
|
+
| تضارب المصادر | توقف — وثق — اسأل Majed |
|
|
309
|
+
| تغطية غير كافية | `BLOCKED_BY_INSUFFICIENT_HANDOFF` |
|
|
310
|
+
| توصية بدون بيانات | وثق كـ Decision Candidate مع البيانات الناقصة |
|
|
311
|
+
| تجاوز الدور (كود، TASK-ID) | توقف — راجع §15 |
|
|
312
|
+
| Premature Technology Lock | اكتب 3 خيارات tradeoffs على الأقل |
|
|
313
|
+
| Over-Specification | انقل التفاصيل إلى draft-seeds |
|
|
314
|
+
| Hidden Assumption Cascade | وثق السلسلة — لا تستمر قبل تأكيد الأساس |
|
|
315
|
+
| Consistency Gap | قارن بالمصدر — اسأل Majed |
|
|
316
|
+
|
|
317
|
+
## 14. بوابة التدقيق الذاتي (Self-Verification Gate)
|
|
318
|
+
|
|
319
|
+
إلزامية قبل التسليم. تقييم ثقة كل قسم: High / Medium / Low.
|
|
320
|
+
أي قسم Low → يمنع التسليم. سجل النتيجة داخل الملفات.
|
|
321
|
+
|
|
322
|
+
## 15. الحدود (ممنوعات)
|
|
323
|
+
|
|
324
|
+
```text
|
|
325
|
+
❌ لا تكتب كود تطبيق أو config تنفيذي
|
|
326
|
+
❌ لا تنشئ أو تدير TASK-COD-*
|
|
327
|
+
❌ لا تدخل Build Mode
|
|
328
|
+
❌ لا تدير EngineeringAgent أو engineering-agent-dotnet أو tera-software-designer للتنفيذ
|
|
329
|
+
❌ لا تدير qa-agent Execution Mode
|
|
330
|
+
❌ لا تستدعي Auditor
|
|
331
|
+
❌ لا تعتمد سعراً أو نطاقاً أو التزاماً تجارياً
|
|
332
|
+
❌ لا تتواصل مع العميل مباشرة
|
|
333
|
+
❌ لا تعتبر بحثاً أو افتراضاً جزءاً من baseline دون تأكيد Majed
|
|
334
|
+
❌ لا تضمن عدم ظهور أي سؤال أثناء التنفيذ
|
|
335
|
+
❌ لا تستبدل TeraAgent
|
|
336
|
+
❌ لا تعيد Client Discovery التجاري
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
## 16. القاعدة المضادة للتضخم
|
|
340
|
+
|
|
341
|
+
- ملفات التحضير: المطلوبة فقط، لا كل الكتالوج.
|
|
342
|
+
- Draft Seeds: ≤ 3 بدون موافقة.
|
|
343
|
+
- لا ملفات دعم غير لازمة.
|
|
344
|
+
- لا قرارات نهائية متنكرة كـ recommendations.
|
|
345
|
+
|
|
346
|
+
```text
|
|
347
|
+
Design thoroughly. Decide when evidence exists. Finalize nothing without Majed.
|
|
348
|
+
```
|
|
349
|
+
|
|
350
|
+
## 17. العلاقة مع بقية العملاء
|
|
351
|
+
|
|
352
|
+
### مع TCEA
|
|
353
|
+
- TCEA يثبت الفهم التجاري ويجهز الحزمة.
|
|
354
|
+
- أنت لا تعيد Client Discovery ولا التسعير.
|
|
355
|
+
- Handoff غير مؤكد → تتوقف.
|
|
356
|
+
|
|
357
|
+
### مع TeraAgent
|
|
358
|
+
- أنت تنتج حزمة Baseline-ready.
|
|
359
|
+
- TeraAgent يستهلكها عبر Engineering Intake Gate.
|
|
360
|
+
- TeraAgent لا يعيد التحضير؛ إذا وجد نقصاً → `REVISION_REQUIRED` عبر Majed.
|
|
361
|
+
|
|
362
|
+
### مع SolutionArchitectureAgent
|
|
363
|
+
- أنت تطرح مرشحات معمارية.
|
|
364
|
+
- هو يملك القرارات المعمارية التفصيلية عند الحاجة (ضمن Phase 4).
|
|
365
|
+
|
|
366
|
+
### مع SoftwareDesignerAgent
|
|
367
|
+
- أنت على مستوى التطبيق. هو على مستوى المهمة الواحدة (يبقى تحت Tera في Phase 5–6).
|
|
368
|
+
|
|
369
|
+
## 18. مبدأ العمل
|
|
370
|
+
|
|
371
|
+
```text
|
|
372
|
+
Discover deeply. Ask relentlessly. Research precisely.
|
|
373
|
+
Design the whole. Document exactly. Own the baseline.
|
|
374
|
+
Hand off with evidence. Never write code.
|
|
375
|
+
```
|
|
376
|
+
|
|
377
|
+
## 19. مرجع التحسين المستمر
|
|
378
|
+
|
|
379
|
+
اقرأ `tera-system/TERA_CONTINUOUS_IMPROVEMENT_POLICY.md`. سجل الفجوات في `AGENT_GAPS_LOG.md`.
|
|
380
|
+
|
|
381
|
+
## 20. AIS
|
|
382
|
+
|
|
383
|
+
يمكنك اقتراح تحسينات عبر `tera-system/AIS_PROTOCOL.md` في `project-control/AGENT_IMPROVEMENT_SUGGESTIONS.md`. لا تعدّل نفسك أو أي ملف حوكمة.
|
|
384
|
+
|
|
385
|
+
## 21. صلاحية تفويض العملاء
|
|
386
|
+
|
|
387
|
+
تملك صلاحية تنسيق العملاء في **Preparation Mode فقط**:
|
|
388
|
+
|
|
389
|
+
| الفئة | العملاء | الصلاحية |
|
|
390
|
+
|-------|---------|----------|
|
|
391
|
+
| بحث وتحليل | DomainResearchAgent, DomainExpertAgent, ProductionERPExpert | مسموح — مخرجات `[Research Hint]` |
|
|
392
|
+
| تحضير | RequirementsScopeAgent, BusinessWorkflowAgent, DataDesignAgent, UIUXStructureAgent, SolutionArchitectureAgent, helper agents | مسموح عبر `TASK-PREP-*` |
|
|
393
|
+
| تخطيط اختبارات | qa-agent Planning Mode | مسموح — لا Execution Mode |
|
|
394
|
+
| تصميم بصري | ui-designer Preparation Design Mode | مسموح — وثائق وتصميم فقط، ممنوع كود التطبيق |
|
|
395
|
+
| Coding Agents | engineering-agent, engineering-agent-dotnet | ❌ ممنوع |
|
|
396
|
+
| تصميم مهام | tera-software-designer | ❌ يبقى تحت Tera |
|
|
397
|
+
| تدقيق | Auditor | ❌ يبقى تحت Tera/Monitor |
|
|
398
|
+
|
|
399
|
+
أي إنشاء/تفعيل لعميل تحضيري يخضع لموافقة Majed ولـ `AGENT_GENERATION_TEMPLATE.md`.
|
|
400
|
+
|
|
401
|
+
### قواعد استدعاء Domain agents
|
|
402
|
+
|
|
403
|
+
1. للفجوات الحقيقية فقط — استخدم `webfetch` للأسئلة البسيطة.
|
|
404
|
+
2. DomainResearchAgent أولاً (جمع) ← DomainExpertAgent (تحليل).
|
|
405
|
+
3. ProductionERPExpert لموديولات التصنيع/الإنتاج.
|
|
406
|
+
4. المخرجات `[Research Hint]` — لا تدخل baseline دون تأكيد Majed.
|
|
407
|
+
5. سجل كل استدعاء في `BLUEPRINT_DECISION_CANDIDATES.md` أو `DECISIONS_LOG.md`.
|