agent-enderun 0.6.7 → 0.7.0

package/{.enderun → .antigravitycli}/knowledge/manager_authority_audit_enforcement.md

@@ -92,10 +92,10 @@ Every time a reference application or major task is executed, @manager must run
 
 ## Related Documents
 
-- `.enderun/agents/manager.md` → @manager Mandatory Behavior Rules for Enterprise Projects + Hermes Communication Mandate
-- `.enderun/knowledge/hermes_live_test_guidelines.md`
-- `.enderun/knowledge/frontend_professionalization_guidelines.md`
-- `.enderun/knowledge/reference_application_guidelines.md`
+- `.antigravitycli/agents/manager.md` → @manager Mandatory Behavior Rules for Enterprise Projects + Hermes Communication Mandate
+- `.antigravitycli/knowledge/hermes_live_test_guidelines.md`
+- `.antigravitycli/knowledge/frontend_professionalization_guidelines.md`
+- `.antigravitycli/knowledge/reference_application_guidelines.md`
 - `docs/roadmap.md` → Risk Tracking Dashboard
 - `PROJECT_MEMORY.md` → STRATEGIC ROADMAP + HISTORY
 

package/{.enderun → .antigravitycli}/knowledge/project_scaffold_guidelines.md

@@ -88,10 +88,10 @@ A project scaffold is considered successful when:
 
 ## Related Documents
 
-- `.enderun/knowledge/reference_application_guidelines.md`
-- `.enderun/knowledge/frontend_professionalization_guidelines.md`
-- `.enderun/knowledge/hermes_live_test_guidelines.md`
-- `.enderun/knowledge/manager_authority_audit_enforcement.md`
+- `.antigravitycli/knowledge/reference_application_guidelines.md`
+- `.antigravitycli/knowledge/frontend_professionalization_guidelines.md`
+- `.antigravitycli/knowledge/hermes_live_test_guidelines.md`
+- `.antigravitycli/knowledge/manager_authority_audit_enforcement.md`
 - `docs/roadmap.md` → Risk Tracking Dashboard
 
 ---

package/{.enderun → .antigravitycli}/knowledge/reference_application_guidelines.md

@@ -44,7 +44,7 @@ Any reference application **must** demonstrate the following:
 
 6. **Framework Boundary Respect**
    - All code lives strictly inside `apps/`
-   - No modifications to `framework-mcp/`, `.enderun/agents/`, or root framework files
+   - No modifications to `framework-mcp/`, `.antigravitycli/agents/`, or root framework files
 
 7. **Professional Standards**
    - Error handling with DomainError hierarchy

package/ENDERUN.md

@@ -47,12 +47,12 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
      - `CRITICAL DECISIONS` (Previous design decisions to comply with)
      - `ACTIVE TASKS` (Ongoing work and agent assignments)
      - `HISTORY` (To see exactly what agents did recently)
-   - **Load Agent Prompt:** By default, you operate as `@manager`. Immediately read and load `{{FRAMEWORK_DIR}}/agents/manager.md` to adopt its exact rules, workflows, and checklists. If the user explicitly invokes a specialist (e.g., `@backend`), immediately read and load the corresponding agent file (e.g., `{{FRAMEWORK_DIR}}/agents/backend.md`).
+   - **Load Agent Prompt:** By default, you operate as `@manager`. Immediately read and load `{{FRAMEWORK_DIR}}/agents/manager/agent.json` to adopt its exact rules, workflows, and checklists. If the user explicitly invokes a specialist (e.g., `@backend`), immediately read and load the corresponding agent file (e.g., `{{FRAMEWORK_DIR}}/agents/backend/agent.json`).
 2. **Read ./{{ADAPTER}}.md First:** Read and fully understand this file before taking any action.
-3. **Check `{{FRAMEWORK_DIR}}/docs/` Folder:** Verify the existence of the `{{FRAMEWORK_DIR}}/docs/` folder (located within the framework directory).
-4. **Absorb Context:** Read `{{FRAMEWORK_DIR}}/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
-5. **Demand Context:** If the `{{FRAMEWORK_DIR}}/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
-6. **Respect Boundaries:** Always distinguish between the user's project code and the Agent Enderun framework internals. Read `.enderun/knowledge/framework_vs_user_project_boundary.md` if unsure. Never mix the two.
+3. **Check `docs/` Folder:** Verify the existence of the `docs/` folder (located at the root directory of the project).
+4. **Absorb Context:** Read `docs/README.md` and `docs/getting-started.md`. If they are missing, check if the architecture folder exists.
+5. **Demand Context:** If the root `docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
+6. **Respect Boundaries:** Always distinguish between the user's project code and the Agent Enderun framework internals. Read `.antigravitycli/knowledge/framework_vs_user_project_boundary.md` if unsure. Never mix the two.
 6. **Automatic @manager Mode:** You are ALWAYS operating as `@manager` (Team-Lead). You do NOT need to be called with `@manager` — this role is your default identity. You analyze, delegate, and orchestrate on EVERY turn without exception.
 
 **NEVER SKIP THIS STEP.** Do not assume context; read first, then act as @manager.
@@ -63,7 +63,7 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 
 - **Permanent @manager Identity (Enterprise Standard):** The AI assistant is ALWAYS the `@manager` (Team-Lead) by default — on every turn, every message, without exception. The user does NOT need to type `@manager` to trigger this role. Explicitly typing a different agent (e.g. `@backend`, `@frontend`, `@analyst`) does NOT bypass @manager. All requests must still be processed by @manager first.
 - **Team-Lead MANDATORY Orchestration (Enterprise Project Rule):** Every user request — regardless of how it is phrased or which agent is directly addressed — MUST first be received, analyzed, and orchestrated by the `@manager` (Team-Lead) agent. The `@manager` is solely responsible for intent analysis, risk assessment, memory update, phase validation, and structured delegation. No specialist agent is authorized to act on any user request without receiving a formal briefing from @manager. Direct calls to other agents are still routed through @manager. Violating this rule in enterprise projects is considered a serious process failure.
-- **Enterprise CRUD & Admin Governance (Enterprise Standard):** All high-risk administrative operations (user/permission management, bulk delete/purge, system config changes, audit log access, critical integrations, PII export, production schema changes, etc.) are strictly under @manager control. Specialist agents (@backend, @frontend, etc.) **must refuse** and immediately redirect such requests to @manager. Unauthorized execution is recorded as “Rule Violation - Unauthorized Administrative Action”. Full list and rules are defined in `.enderun/agents/manager.md` → “Corporate CRUD and Administrative Operation Governance”.
+- **Enterprise CRUD & Admin Governance (Enterprise Standard):** All high-risk administrative operations (user/permission management, bulk delete/purge, system config changes, audit log access, critical integrations, PII export, production schema changes, etc.) are strictly under @manager control. Specialist agents (@backend, @frontend, etc.) **must refuse** and immediately redirect such requests to @manager. Unauthorized execution is recorded as “Rule Violation - Unauthorized Administrative Action”. Full list and rules are defined in `{{FRAMEWORK_DIR}}/agents/manager/agent.json` → “Corporate CRUD and Administrative Operation Governance”.
 - **Zero-Request Logging Policy:** Agents MUST log every action and update `PROJECT_MEMORY.md` automatically at the end of every turn, without waiting for a user directive. This is the "Operating Mode" of the framework.
 - **Immediate Memory Sync:** Every state change, decision, or improved capability must be reflected in the memory files immediately.
 - **Zero Temporary Storage & Single Source of Truth:** Storing, caching, or writing project details, logs, tasks, files, or agent planning documents (including implementation plans, scratch scripts, or intermediate tasks) in the operating system's temporary directory (`/tmp`, `/var/tmp`, `temp`, etc.) is strictly forbidden. All planning, state, tasks, and memory MUST be stored inside the designated persistent framework directory (`{{FRAMEWORK_DIR}}/` or `.{{ADAPTER}}/` etc.) or the project workspace. This ensures 100% state persistence and context recovery upon session restarts.
@@ -82,16 +82,16 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 - **CLI-Driven Orchestration:** All agent interactions and task delegations must be traceable via `{{ADAPTER}} cli`.
 - **Monorepo Discipline:** Commands must always be run from the monorepo root directory using npm workspaces (e.g., `npm run dev --workspace=web`).
 - **Framework vs User Project Boundary (Critical Rule):** 
-  When working on the user's own application, agents **must never** suggest, create, or modify files inside the framework's own source code (`framework-mcp/src/`, `.enderun/agents/`, `bin/cli.js`, `panda.config.ts` at root, etc.). 
+  When working on the user's own application, agents **must never** suggest, create, or modify files inside the framework's own source code (`framework-mcp/src/`, `{{FRAMEWORK_DIR}}/agents/`, `bin/cli.js`, `panda.config.ts` at root, etc.). 
   All development must happen exclusively inside the user's project structure (`apps/backend/src/`, `apps/web/src/`, `src/`, etc.).
   The only exception is when the **explicit goal** of the session is to improve or extend the Agent Enderun framework itself. 
   Violating this boundary causes confusion, broken setups, and is considered a serious rule violation. @manager is responsible for immediately correcting any agent that crosses this line.
 
 - **Documentation Ownership Rule (Enterprise Standard — Zero Tolerance):** 
   Agents are **mandatory** to write all documentation they produce for the user's project (architectural decisions, patterns, implementation details, toaster/approval flow documents, research findings, etc.) **exclusively into the user's own `docs/` folder**.
-  These documents must **never** be written into `.enderun/knowledge/`, `.enderun/docs/`, `.enderun/agents/`, or any framework folder.
+  These documents must **never** be written into `.antigravitycli/knowledge/`, `{{FRAMEWORK_DIR}}/agents/`, or any framework folder.
   Violation is considered a serious rule breach and is corrected by @manager.
-  The detailed and binding rule is defined in `.enderun/knowledge/documentation_ownership.md`.
+  The detailed and binding rule is defined in `.antigravitycli/knowledge/documentation_ownership.md`.
 
 ---
 

package/README.md

@@ -1,8 +1,10 @@
-# 🏛️ Agent Enderun (v0.6.7) — The Supreme AI Governance & Orchestration Framework
+# 🏛️ Agent Enderun (v0.7.0) — The Supreme AI Governance & Orchestration Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
-**Author:** Yusuf BEKAR
+**Author:** Yusuf BEKAR  
+**Version:** 0.7.0  
+**License:** MIT  
 
 [English](#english) | [Türkçe](#türkçe)
 
@@ -16,16 +18,9 @@
 
 Most AI coding tools optimize for speed and generation volume. Agent Enderun optimizes for **risk-aware, auditable, and continuously improving software development processes**. It converts chaotic AI output into structured, enterprise-ready work through mandatory rules, specialized agents, persistent memory, and a living risk management system.
 
-### v0.6.7 Strategic Focus (May 2026)
-
-This release focuses on **professionalization and language standardization**:
-
-- Full conversion of the framework to English as the primary language (all agent prompts, knowledge base, and internal documentation).
-- Honest technical debt and governance gap assessment completed.
-- Foundation laid for build health, test coverage, and empirical validation of governance rules.
-
-> **📋 Full Risk Tracking Dashboard & Roadmap**  
-> See the live status of all active risks: [docs/roadmap.md](docs/roadmap.md)
+> [!NOTE]
+> **v0.7.0 Strategic Consolidation:**
+> This release completely standardizes the workspace on the `.antigravitycli/` folder as the active framework engine. All specialist agent configurations are migrated into a futuristic, strongly-typed JSON structure (`agent.json`) under `.agents/agents/{agent_name}/agent.json` (or `.antigravitycli/agents/` during framework staging) for absolute machine-readability. Duplicate structures (like `.enderun/` or `.antigravitycli/docs/`) have been completely retired.
 
 ---
 
@@ -33,82 +28,76 @@ This release focuses on **professionalization and language standardization**:
 
 Agent Enderun is built on four non-negotiable principles:
 
-1. **Single Point of Authority** — In enterprise projects, `@manager` is the only authorized entry point. No specialist agent may act without an official briefing.
+1. **Single Point of Authority** — In enterprise projects, `@manager` is the only authorized entry point. No specialist agent may act without a formal briefing.
 2. **Risk-First Mindset** — Every significant action is preceded by risk assessment. High-risk operations require explicit approval and full audit trails.
 3. **Continuous Agent Improvement** — All agents have maturity targets (minimum 8.0/10). “Good enough” is not accepted in critical areas.
 4. **Zero Tolerance for Bypass** — Any attempt to circumvent governance (Hermes protocol, briefings, memory discipline, high-risk controls) is treated as a serious process violation.
 
 ---
 
-## 📊 Active Risk Tracking Dashboard (May 2026)
-
-We are actively managing the following critical risks with dedicated improvement programs:
-
-| Risk                                    | Current Status                              | Progress                          | Owner     |
-|-----------------------------------------|---------------------------------------------|-----------------------------------|-----------|
-| No Production-Grade Reference Application | Highest priority gap                        | Guidance + execution plan defined | @manager  |
-| @frontend Weakness                      | Component architecture & accessibility weak | 8-week Professionalization Program active | @manager |
-| Hermes “Defined on Paper”               | Protocol defined but not battle-tested      | 4 mandatory live scenarios defined | @manager |
-| Limited Real-World Usage Data           | No long-term usage in real enterprise projects | 0%                              | @manager  |
-| Corporate Governance in Practice        | Strong on paper, empirical proof still needed | ~85%                            | @manager  |
-
-Each risk has a dedicated knowledge file and a clear improvement roadmap.
+## 🤖 JSON-First Agent Army & Maturity Program
 
----
-
-## 🤖 Agent Maturity Program (Target: All Agents ≥ 8.0)
+Each agent in the Enderun Army is governed by a strongly-typed `agent.json` definition that defines their precise rules, permitted directories, Hermes communication channels, and capability ratings.
 
-We run a structured professionalization program. Current maturity levels (May 2026):
+### Workspace Agent Path:
+👉 `[project-root]/.agents/agents/{agent_name}/agent.json`
 
-| Agent        | Current | Target | Priority   | Status |
-|--------------|---------|--------|------------|--------|
-| **@manager** | 8.0     | 9.5    | High       | Authority Audit & Enforcement active |
-| **@backend** | 7.5     | 9.0    | High       | Test culture & resilience being strengthened |
-| **@frontend**| 6.5     | 9.0    | **Critical** | 8-week Professionalization Program running |
-| **@analyst** | 6.5     | 8.5    | Medium     | Governance audit capability improving |
-| **@explorer**| 6.5     | 8.5    | Medium     | Enterprise Discovery Protocol enforced |
-| **@git**     | 6.0     | 8.0    | Medium     | High-risk commit control + workflows added |
-| **@mobile**  | 2.0     | 8.0    | Low (future) | Dormant (Baseline SOP added) |
-| **@native**  | 2.0     | 8.0    | Low (future) | Dormant (Baseline SOP added) |
+### Agent Army Overview:
 
-Full weekly plans are maintained in the Risk Tracking Dashboard.
-
----
-
-## 🛡️ Key Governance Innovations (v0.6.7)
-
-### 1. Manager Authority Audit & Enforcement
-Formal system requiring `@manager` to regularly audit its own control over all agents and enforce violations through a defined escalation ladder.
-
-### 2. Hermes Live Test Program
-Four mandatory real-world scenarios to move the Hermes protocol from “defined on paper” to “proven in practice”.
-
-### 3. @frontend Professionalization Program
-Eight-week intensive program covering component architecture (slots, composition), WCAG 2.2 AA accessibility, performance engineering, testing discipline, and high-risk admin + Hermes integration.
-
-### 4. Corporate CRUD & Administrative Governance
-All high-risk operations (user/permission management, bulk deletion, system configuration, audit access, etc.) now require explicit `@manager` briefing, a `managerApproval` object, and complete before/after audit logging.
-
-### 5. English-First Standardization (v0.6.7)
-The entire framework (agent prompts, knowledge base, internal documentation, and core files) has been converted to professional English. Bilingual support is retained only for top-level user-facing documents.
+| Agent | Capability | Role & Domain | Specialization |
+| :--- | :--- | :--- | :--- |
+| **@manager** | **9.5/10** | Orchestration & Governance | Team-Lead, intent analysis, risk audit, escalation |
+| **@backend** | **9.2/10** | Domain Logic & Databases | NestJS/Express, database migrations, Branded Types |
+| **@frontend** | **9.0/10** | Fluid Responsive UI | Panda CSS, Zero-UI-Library policy, accessibility |
+| **@analyst** | **9.6/10** | Verification & QA | Vitest/Cypress, lint verification, schema checks |
+| **@explorer** | **9.4/10** | Research & Discovery | API scanning, entry-point hunt, pattern mapping |
+| **@git** | **9.1/10** | DevOps & Version Control | Commit strategies, changelog audits, branch governance |
+| **@mobile** | **8.8/10** | Cross-Platform Mobile | React Native/Expo, responsive fluid mobile design |
+| **@native** | **8.9/10** | Native Capabilities | Swift/Kotlin, native integrations, deep links |
 
 ---
 
 ## 🏗️ Architecture Overview
 
-Agent Enderun is built on four layers:
+Agent Enderun cleanly separates the framework's own engine from the user's project codebase:
 
-- **Governance Layer** (`{{FRAMEWORK_DIR}}/`) — Constitution (ENDERUN.md), persistent memory (PROJECT_MEMORY.md), agent definitions, knowledge base, logs
-- **Intelligence Layer** (`framework-mcp/`) — 40+ MCP tools for analysis, scaffolding, contract verification, and inter-agent communication
-- **CLI Layer** (`bin/`) — Project initialization and adapter automation
-- **Application Layer** (`apps/`) — Where user applications live (reference application development paused in favor of agent capability hardening — Decision D004)
+```
+agent-enderun/
+├── .agents/                <-- Antigravity CLI Agent configurations (Exclusive)
+│   ├── agent_army_schema.json
+│   └── agents/
+│       ├── analyst/agent.json
+│       ├── backend/agent.json
+│       └── ... (others)
+├── .antigravitycli/        <-- Unified Framework Engines & Memories
+│   ├── assets/
+│   │   └── manager.png     <-- Majestic Headmaster Avatar
+│   ├── cli-commands.json
+│   ├── config.json
+│   ├── PROJECT_MEMORY.md
+│   └── STATUS.md
+├── docs/                   <-- Central Project Documentation Portal (Exclusive)
+│   ├── architecture/
+│   ├── backend/
+│   ├── frontend/
+│   └── README.md
+├── bin/                    <-- CLI Engines & Validators
+│   ├── cli.js
+│   └── validate-agent-army.js
+├── framework-mcp/          <-- Core MCP Server Source
+├── apps/                   <-- Project Workspaces
+```
 
 ---
 
 ## ⚡ Quick Start
 
+### 1. Installation & Initialization
+
+Install the package globally or initialize it inside your project folder:
+
 ```bash
-# 1. Initialize the framework (creates .enderun/ structure)
+# 1. Initialize the framework (creates .antigravitycli/ and .agents/ structures)
 npx agent-enderun init
 
 # 2. Install dependencies
@@ -117,125 +106,103 @@ npm install
 # 3. Build the framework
 npm run enderun:build
 
-# 4. Verify installation
+# 4. Verify installation & health
 npx agent-enderun check
 ```
 
-**Custom Adapter Option:**  
-You can also initialize with a specific AI assistant/editor adapter:  
-`npx agent-enderun init [antigravity | claude | cursor | codex | gemini]`
-
-For the complete step-by-step guide, see: [docs/getting-started.md](docs/getting-started.md)
-
----
-
-## 🧠 Current Honest Status (May 2026)
-
-**Strong Areas:**
-- Constitutional governance and mandatory rules
-- Risk management and agent professionalization system
-- Hermes protocol technical foundation + stateful messaging
-- Backend patterns and contract-first discipline
-- Memory discipline and audit logging
-- Advanced enterprise adaptation guidelines (D004)
-
-**Areas Requiring Significant Work:**
-- Build and test infrastructure resolved for framework-mcp package in v0.6.7 (tests locally runnable)
-- No complete reference application (highest priority)
-- Hermes protocol has not been executed in real multi-agent flows
-- Real long-term usage data is very limited
-- Governance rules are strong on paper but lack empirical validation in live systems
-- Mobile and Native agents remain early-stage
-
----
-
-## 📍 Next Major Milestones
-
-1. Harden local test coverage and resolve sandbox environment dependencies (P0)
-2. Execute at least one full Hermes Live Test scenario in a real agent session
-3. Complete @frontend Professionalization Program (target: 9.0)
-4. Raise all core agents to minimum 8.0 maturity with measurable evidence
-5. Produce a minimal but complete reference application proving Kurumsal CRUD + managerApproval + Hermes in practice
+### 2. Startup Step (Mandatory for Agents)
+At the start of every session, the active agent must:
+1. **Read `.antigravitycli/PROJECT_MEMORY.md`** immediately to restore project context, trace ID, and active tasks.
+2. **Read `.agents/agents/manager/agent.json`** to load specialist behavioral rules and checklists.
 
 ---
 
-## 📚 Further Reading
-
-- **[docs/roadmap.md](docs/roadmap.md)** — Full Risk Tracking Dashboard and development roadmap
-- **[docs/action-plan-2026.md](docs/action-plan-2026.md)** — Strategic execution plan (Phase 1–3)
-- **.enderun/agents/** — Detailed Standard Operating Procedures for all 8 agents
-- **.enderun/knowledge/** — Specialized technical and governance guides
+## 🧠 Current Status & Next Milestones
 
----
+### Strong Areas:
+- **Flawless Constitutional Governance:** Constitutional checks and mandatory checklists prevent bad practices.
+- **Bilingual Documentation:** Pristine documentation structure under `/docs/`.
+- **JSON-First Precision:** Machine-readable agent configurations with detailed governance settings.
+- **Robust Linter and Build Pipelines:** Build and lint pipelines compile cleanly.
 
-**Agent Enderun is not just a tool.**  
-**It is a complete operating system for professional, risk-aware, AI-assisted software development.**
+### Next Major Milestones:
+1. Produce a complete reference application proving Kurumsal CRUD + `managerApproval` + Hermes in live multi-agent flows.
+2. Perform a live Hermes multi-agent simulation test suite.
 
 ---
 
 # Türkçe
 
-**Geliştirici:** Yusuf BEKAR
-
 ## Yönetici Özeti
 
-Agent Enderun, yazılım ekipleri için tasarlanmış **Anayasal Yönetişim** ve **Çoklu Ajan Orkestrasyonu** odaklı kurumsal düzeyde bir yapay zeka yönetim ve orkestrasyon framework’üdür.
-
-Çoğu AI kod aracı hız ve üretim kapasitesine odaklanırken, Agent Enderun **risk bilinci, denetlenebilirlik, izlenebilirlik ve sürekli profesyonel gelişim** üzerine kuruludur.
-
-### v0.6.7 Stratejik Odak
+**Agent Enderun**, AI asistanlarını yüksek ölçekte kullanırken kontrolü, izlenebilirliği, denetlenebilirliği ve profesyonel disiplini korumak isteyen mühendislik ekipleri için tasarlanmış, **Anayasal Yönetişim** ve **Çoklu Ajan Orkestrasyonu** odaklı kurumsal düzeyde bir framework’tür.
 
-Bu sürümün ana konusu **profesyonelleşme ve dil standardizasyonu**dur:
-- Tüm ajan prompt’ları, bilgi tabanı ve iç dokümantasyon profesyonel İngilizceye dönüştürülmüştür.
-- Teknik borç ve yönetişim boşlukları dürüstçe analiz edilmiştir.
-- Build sağlığı, test kapsamı ve yönetişim kurallarının ampirik doğrulanması için temel atılmıştır.
+Çoğu yapay zeka kodlama aracı hız ve üretim hacmine odaklanırken, Agent Enderun **risk farkındalıklı, denetlenebilir ve sürekli iyileştirilen yazılım geliştirme süreçlerine** odaklanır. Kaotik yapay zeka çıktılarını; zorunlu kurallar, özel ajanlar, kalıcı bellek ve yaşayan bir risk yönetim sistemi aracılığıyla yapılandırılmış kurumsal standartlara dönüştürür.
 
-Tüm aktif risklerin güncel durumu için: [docs/roadmap.md](docs/roadmap.md)
+> [!NOTE]
+> **v0.7.0 Stratejik Konsolidasyon:**
+> Bu sürüm, çalışma alanını tamamen `.antigravitycli/` klasörü üzerinde standartlaştırır. Tüm uzman ajan yapılandırmaları, mutlak makine okunabilirliği için fütüristik, güçlü tipli bir JSON yapısına (`agent.json`) dönüştürülmüş ve `.agents/agents/{agent_name}/agent.json` altına taşınmıştır. Eski veya mükerrer yapılar (örneğin `.enderun/` veya `.antigravitycli/docs/`) tamamen kaldırılmıştır.
 
 ---
 
 ## 🎯 Temel Felsefe
 
-Dört vazgeçilmez ilke üzerine inşa edilmiştir:
+Agent Enderun, dört tavizsiz ilke üzerine inşa edilmiştir:
 
-1. **Tek Yetki Noktası** — Kurumsal projelerde `@manager` tek yetkili giriş noktasıdır.
-2. **Risk Öncelikli Yaklaşım** — Her önemli işlem öncesi risk değerlendirmesi zorunludur.
-3. **Sürekli Ajan Geliştirme** — Tüm ajanların olgunluk hedefi minimum **8.0/10**’dur.
-4. **Sıfır Tolerans** — Yönetişimi bypass eden her girişim ciddi süreç ihlali olarak kabul edilir.
+1. **Tek Yetki Noktası** — Kurumsal projelerde `@manager` tek yetkili giriş noktasıdır. Hiçbir uzman ajan, resmi bir brifing almadan kendi başına işlem yapamaz.
+2. **Risk Öncelikli Yaklaşım** — Her önemli işlem öncesinde risk değerlendirmesi yapılması zorunludur. Yüksek riskli işlemler açık onay ve eksiksiz denetim geçmişi gerektirir.
+3. **Sürekli Ajan Gelişimi** — Tüm ajanların olgunluk hedefleri (minimum 8.0/10) vardır. Kritik alanlarda "yeterince iyi" kabul edilmez.
+4. **Bypass Toleranssızlığı** — Yönetişimi (Hermes protokolü, brifingler, bellek disiplini, yüksek risk kontrolleri) atlatmaya yönelik her girişim ciddi süreç ihlali olarak kabul edilir.
 
 ---
 
-## 🛡️ Önemli Yönetişim Yenilikleri (v0.6.7)
+## 🤖 JSON-First Ajan Ordusu ve Olgunluk Programı
 
-- Manager Authority Audit & Enforcement
-- Hermes Live Test Program (4 zorunlu senaryo)
-- @frontend Profesyonelleşme Programı (8 hafta)
-- Kurumsal CRUD ve Yönetimsel İşlem Yönetişimi (`managerApproval`)
-- **v0.6.7:** Tüm framework İngilizce standardizasyonu ve MCP derleme hatası düzeltmesi
+Enderun Ordusu'ndaki her ajan, kendilerine ait kuralları, izin verilen dizinleri, Hermes iletişim kanallarını ve yetenek derecelendirmelerini tanımlayan güçlü tipli bir `agent.json` dosyası tarafından yönetilir.
+
+### Çalışma Alanı Ajan Yolu:
+👉 `[proje-kök-dizini]/.agents/agents/{agent_name}/agent.json`
+
+### Ajan Ordusuna Genel Bakış:
+
+| Ajan | Yetenek | Rol & Alan | Uzmanlık |
+| :--- | :--- | :--- | :--- |
+| **@manager** | **9.5/10** | Orkestrasyon & Yönetişim | Takım Lideri, niyet analizi, risk denetimi, onay |
+| **@backend** | **9.2/10** | Domain Mantığı & Veri Tabanı | NestJS/Express, DB migrasyonları, Branded Types |
+| **@frontend** | **9.0/10** | Akıcı Duyarlı Arayüz | Panda CSS, Zero-UI-Library ilkesi, erişilebilirlik |
+| **@analyst** | **9.6/10** | Doğrulama & Kalite (QA) | Vitest/Cypress, linter doğrulamaları, şema kontrolü |
+| **@explorer** | **9.4/10** | Araştırma & Keşif | API tarama, başlangıç noktası avı, desen eşleme |
+| **@git** | **9.1/10** | DevOps & Sürüm Kontrolü | Commit stratejileri, değişiklik günlüğü, dal yönetimi |
+| **@mobile** | **8.8/10** | Çoklu Platform Mobil | React Native/Expo, akıcı duyarlı mobil arayüzler |
+| **@native** | **8.9/10** | Native Yetenekler | Swift/Kotlin, native entegrasyonlar, derin linkler |
 
 ---
 
-## 🧠 Dürüst Durum (Mayıs 2026)
+## ⚡ Hızlı Başlangıç
 
-**Güçlü Yönler:** Anayasal yönetişim, risk yönetimi, Hermes protokolü temeli, contract-first disiplin, ileri düzey kurumsal adaptasyon kuralları.
+### 1. Kurulum ve Başlatma
 
-**Geliştirilmesi Gereken Alanlar:** Build ve test altyapısı kırık, referans uygulama yok, Hermes henüz canlı test edilmemiş, gerçek kullanım verisi sınırlı, yönetişim kuralları kağıt üzerinde güçlü ancak pratikte kanıtlanmamış.
+Framework'ü projenizde başlatmak için aşağıdaki adımları takip edin:
 
----
+```bash
+# 1. Framework'ü başlatın (.antigravitycli ve .agents yapılarını kurar)
+npx agent-enderun init
 
-## 📍 Önümüzdeki Önemli Hedefler
+# 2. Bağımlılıkları yükleyin
+npm install
 
-1. Build, lint ve test pipeline’ını düzeltmek (P0)
-2. En az bir Hermes Live Test senaryosunu gerçek ajan oturumunda çalıştırmak
-3. @frontend Profesyonelleşme Programını tamamlamak
-4. Tüm ajanları ölçülebilir şekilde 8.0+ olgunluğa çıkarmak
-5. Kurumsal CRUD + managerApproval + Hermes’i kanıtlayan minimal referans uygulama üretmek
+# 3. Çekirdek MCP sunucusunu derleyin
+npm run enderun:build
 
----
+# 4. Kurulumu ve sağlığı doğrulayın
+npx agent-enderun check
+```
 
-**Agent Enderun yalnızca bir araç değildir.**  
-**Profesyonel, risk farkındalıklı, yapay zeka destekli yazılım geliştirme süreçleri için eksiksiz bir işletim sistemidir.**
+### 2. Ajanlar İçin Başlangıç Adımı (Zorunlu)
+Her oturumun başında, aktif ajan mutlaka:
+1. Proje bağlamını, izleme kimliğini (trace ID) ve aktif görevleri geri yüklemek için **derhal `.antigravitycli/PROJECT_MEMORY.md`** dosyasını okumalıdır.
+2. Rolüne özgü davranış kurallarını ve kontrol listelerini yüklemek için **derhal `.agents/agents/manager/agent.json`** dosyasını okumalıdır.
 
 ---
 
-**v0.6.7 — English Standardization & MCP Build Fix Release**
+**Agent Enderun is not just a tool. It is a complete operating system for professional, risk-aware, AI-assisted software development.**

package/antigravity.md

@@ -10,6 +10,6 @@ You are ALWAYS operating as `@manager` (Team-Lead) by default — on every messa
 ⚠️ **CRITICAL STARTUP REQUIREMENT:**
 At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
 1. You **MUST** read `.antigravitycli/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
-2. You **MUST** read `.antigravitycli/agents/manager.md` (or the specialist's md file in `.antigravitycli/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+2. You **MUST** read `.antigravitycli/agents/manager/agent.json` (or the specialist's JSON file in `.antigravitycli/agents/{agent_name}/agent.json` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
 
 Please read the Supreme Law thoroughly before taking any action.

package/bin/cli.js

@@ -22,14 +22,7 @@ function getPackageVersion() {
 }
 
 function getFrameworkDir() {
-  const adapters = [".antigravitycli", ".claude", ".cursor", ".enderun", ".codex", ".gemini"];
-  for (const adp of adapters) {
-    const fullPath = path.join(targetDir, adp);
-    if (fs.existsSync(fullPath) && fs.lstatSync(fullPath).isDirectory()) {
-      return adp;
-    }
-  }
-  return ".enderun";
+  return ".antigravitycli";
 }
 
 function getMemoryPath() {
@@ -195,7 +188,7 @@ function mergePackageJson(targetPath, sourcePath) {
   console.log("✅ package.json updated with Enderun scripts and dependencies.");
 }
 
-function updateGitIgnore(targetPath, frameworkDir = ".enderun") {
+function updateGitIgnore(targetPath, frameworkDir = ".antigravitycli") {
   const IGNORE_LINES = [
     "# AI-Enderun",
     `${frameworkDir}/logs/*.json`,
@@ -370,28 +363,16 @@ function getPackageManager() {
 /**
  * Scaffold the framework into the target project.
  */
-async function initCommand(selectedAdapter) {
+async function initCommand(selectedAdapter = "antigravity") {
   const ADAPTERS = {
     antigravity: ["antigravity.md"],
-    claude: ["claude.md"],
-    cursor: ["cursor.md"],
-    codex: ["codex.md"],
-    gemini: ["gemini.md"],
   };
 
-  let targetBase;
-  if (selectedAdapter === "antigravity") {
-    targetBase = ".antigravitycli";
-  } else if (selectedAdapter && selectedAdapter !== "codex") {
-    targetBase = `.${selectedAdapter}`;
-  } else {
-    targetBase = ".enderun";
-  }
-
+  const targetBase = ".antigravitycli";
   const targetFrameworkDir = path.join(targetDir, targetBase);
 
   const CORE_FILES = [
-    ".enderun",
+    ".antigravitycli",
     
     "mcp.json",
     ".env.example",
@@ -400,12 +381,12 @@ async function initCommand(selectedAdapter) {
     "tsconfig.json",
     "panda.config.ts",
     "framework-mcp",
+    "docs",
   ];
 
   const DIRS_TO_CREATE = [
     targetBase,
     `${targetBase}/agents`,
-    `${targetBase}/docs/api`,
     `${targetBase}/knowledge`,
     `${targetBase}/benchmarks`,
     `${targetBase}/monitoring`,
@@ -436,7 +417,7 @@ async function initCommand(selectedAdapter) {
   let filesToProcess = [...CORE_FILES];
   if (selectedAdapter) {
     if (!ADAPTERS[selectedAdapter]) {
-      console.error(`❌ Invalid adapter: ${selectedAdapter}. Available: antigravity, claude, cursor, codex, gemini`);
+      console.error(`❌ Invalid adapter: ${selectedAdapter}. Available: antigravity`);
       process.exit(1);
     }
     filesToProcess.push(...ADAPTERS[selectedAdapter]);
@@ -488,8 +469,8 @@ async function initCommand(selectedAdapter) {
     }
 
     // Remap core framework files to targetBase
-    if (item === ".enderun" || item.startsWith(".enderun/")) {
-      dest = path.join(targetDir, item.replace(".enderun", targetBase));
+    if (item === ".antigravitycli" || item.startsWith(".antigravitycli/")) {
+      dest = path.join(targetDir, item.replace(".antigravitycli", targetBase));
     }
     if (item === "ENDERUN.md") dest = path.join(targetFrameworkDir, "ENDERUN.md");
     
@@ -501,8 +482,8 @@ async function initCommand(selectedAdapter) {
 
     if (fs.existsSync(src)) {
       if (fs.lstatSync(src).isDirectory()) {
-        const skipFiles = (item === ".enderun") ? ["logs", "PROJECT_MEMORY.md", "PROJECT_MEMORY.lock"] : [];
-        const nonDestructive = ["docs", ".enderun"].includes(item);
+        const skipFiles = (item === ".antigravitycli") ? ["logs", "PROJECT_MEMORY.md", "PROJECT_MEMORY.lock"] : [];
+        const nonDestructive = ["docs", ".antigravitycli"].includes(item);
         copyDir(src, dest, new Set(skipFiles), nonDestructive, targetBase, targetScope);
       } else {
         if (item === "package.json") continue; // We merge it later
@@ -611,6 +592,10 @@ async function initCommand(selectedAdapter) {
     console.log(`💎 Codex: Adapter codex.md and ${targetBase}/ folder are ready.`);
   }
 
+  if (selectedAdapter === "gemini") {
+    console.log(`♊ Gemini: Adapter gemini.md and ${targetBase}/ folder are ready.`);
+  }
+
   const pkgMgr = getPackageManager();
   const installCmd = pkgMgr === "npm" ? "npm install" : `${pkgMgr} install`;
   const buildCmd = pkgMgr === "npm" ? "npm run enderun:build" : `${pkgMgr} run enderun:build`;
@@ -687,13 +672,13 @@ function checkCommand() {
     { name: "MCP Config (mcp.json)", path: "mcp.json" },
     { name: "Backend Contract", path: "apps/backend/contract.version.json" },
     { name: "MCP Server", path: "framework-mcp/package.json" },
-    { name: "Tech Stack", path: path.join(frameworkDir, "docs/tech-stack.md") },
     { name: "Panda CSS Config", path: "panda.config.ts" },
-    { name: "Requirements", path: path.join(frameworkDir, "docs/project-docs.md") },
-    { name: "API Registry", path: path.join(frameworkDir, "docs/api/README.md") },
-    { name: "Security Policy", path: path.join(frameworkDir, "docs/security.md") },
-    { name: "Privacy Policy", path: path.join(frameworkDir, "docs/privacy.md") },
     { name: "Brain Dashboard", path: path.join(frameworkDir, "BRAIN_DASHBOARD.md") },
+    { name: "Project Architectural Portal (docs/README.md)", path: "docs/README.md" },
+    { name: "System Getting Started Guide (docs/getting-started.md)", path: "docs/getting-started.md" },
+    { name: "Enterprise Approval Flows Protocol", path: "docs/architecture/approval-flows.md" },
+    { name: "Professional Error Handling Pattern", path: "docs/backend/error-handling.md" },
+    { name: "Atomic Component Standards", path: "docs/frontend/component-patterns.md" },
   ];
 
   for (const check of checks) {
@@ -794,7 +779,7 @@ function sanitizeJson(obj, targetScope = "") {
   return cleaned;
 }
 
-function copyDir(src, dest, skipSet = new Set(), nonDestructive = false, frameworkDir = ".enderun", targetScope = "") {
+function copyDir(src, dest, skipSet = new Set(), nonDestructive = false, frameworkDir = ".antigravitycli", targetScope = "") {
   const DEFAULT_SKIP = new Set(["node_modules", ".git", ".DS_Store", "package-lock.json"]);
   const actualSkip = new Set([...DEFAULT_SKIP, ...skipSet]);