agent-enderun 0.6.1 → 0.6.6

package/README.md

@@ -1,7 +1,9 @@
-# 🏛️ Agent Enderun (v0.6.1) — The Supreme AI Governance Framework
+# 🏛️ Agent Enderun (v0.6.6) — The Supreme AI Governance & Orchestration Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
+**Author:** Yusuf BEKAR
+
 [English](#english) | [Türkçe](#türkçe)
 
 ---
@@ -10,757 +12,230 @@
 
 ## Executive Summary
 
-Agent Enderun, yazılım ekipleri için tasarlanmış, **Anayasal Yönetişim (Constitutional Governance)** ve **Çoklu Ajan Orkestrasyonu (Multi-Agent Orchestration)** sağlayan kurumsal düzeyde bir framework'tür. 
-
-### 🚀 v0.5.9: Adaptive Discovery & Token Economy Protocol
-
-- **Architecture Discovery Protocol (ADP):** Seamlessly ingest and adapt to existing (legacy) projects without rigid directory requirements.
-- **Token Economy & Context Management:** Advanced rules to optimize AI context usage, reducing token costs by up to 40%.
-- **Choice-Based Scaffolding:** Empowering users with consent-driven project setup and architectural blueprints.
-- **Modular MCP Ecosystem:** 30+ enterprise-grade intelligence tools for AST-based analysis and security.
-- **Zero Temporary Storage:** All task logs, plans, and state are strictly saved in persistent workspace directories; OS temp directories are completely forbidden.
-- **Session Memory Recovery:** Non-negotiable automatic first-turn state restoration and role initialization across all adapters.
+**Agent Enderun** is a production-grade constitutional governance and multi-agent orchestration framework designed for engineering teams that need to use AI assistants at scale while maintaining control, traceability, auditability, and professional discipline.
 
-### 🚀 v0.5.3: Zero-Config & Auto-Wiring
-- **Auto-Wiring:** CLI automatically configures `gemini-extension.json` for MCP.
-- **Automated Build:** Framework now compiles itself during initialization.
-- **Smart Directory Logic:** Enhanced separation between framework and project docs.
+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.5.1: The Academy & Hermes Upgrade
+### v0.6.6 Strategic Focus (May 2026)
 
-Bu sürümle birlikte Agent Enderun, basit bir yönetişim aracından otonom bir **Ajan Akademisi**'ne dönüşmüştür:
+This release focuses on **professionalization and language standardization**:
 
-- **📡 Hermes Messaging Protocol:** Ajanlar arası kategorize edilmiş (Action/Delegation/Info) ve önceliklendirilmiş iletişim bus'ı.
-- **📚 Obsidian-Style LLM Wiki:** YAML metadata destekli, ilişkisel ve graf tabanlı teknik bilgi bankası yönetimi.
-- **🛡️ Contract-First Automation:** API ve tip kontratlarının SHA-256 ile otomatik doğrulanması.
-- **🤖 MCP Intelligence:** Bilgi grafiği üretme, inbox istatistikleri ve anlık sistem sağlığı denetimi sağlayan gelişmiş MCP araçları.
+- 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.
 
-Agent Enderun is a **production-grade AI governance framework** designed for engineering teams that must maintain control, traceability, and discipline when using AI assistants for code generation. It transforms chaotic AI output into structured, auditable, enterprise-ready deliverables through:
-
-- **Agent-Led Orchestration**: 8 specialized AI agent roles with defined responsibilities
-- **Contract-First Development**: Shared TypeScript types as the single source of truth
-- **Phase-Based Execution**: Strict workflow progression (PHASE_0 → PHASE_4)
-- **Enterprise Auditability**: Every decision, action, and commit is logged and traceable
-- **Modular MCP Intelligence**: 40+ tools across 12 categories for code analysis, security, and automation
+> **📋 Full Risk Tracking Dashboard & Roadmap**  
+> See the live status of all active risks: [docs/roadmap.md](docs/roadmap.md)
 
 ---
 
-## ⚡ 5-Minute Quick Start
-
-### Prerequisites
-- **Node.js**: 20+ (LTS recommended)
-- **npm**: 9+
-- **Git**: Initialized in your project root
-- **Any AI Adapter**: Gemini, Claude, Cursor, or Codex (optional but recommended)
-
-### Installation Steps
+## 🎯 Core Philosophy
 
-#### Step 1: Clone or Initialize
-```bash
-# Option A: Clone this framework repository
-git clone https://github.com/ybekar/agent-enderun.git
-cd agent-enderun
-
-# Option B: Or use as npm package (when published)
-npx agent-enderun init gemini
-```
+Agent Enderun is built on four non-negotiable principles:
 
-#### Step 2: Install Dependencies
-```bash
-npm install
-```
-
-#### Step 3: Build Framework
-```bash
-npm run enderun:build
-```
-
-#### Step 4: Verify Setup
-```bash
-agent-enderun check
-```
-
-Expected output:
-```
-✅ Framework active (v0.5.8)
-✅ MCP Server ready
-✅ Shared types compiled
-✅ Agent logs initialized
-✅ PROJECT_MEMORY.md found
-```
+1. **Single Point of Authority** — In enterprise projects, `@manager` is the only authorized entry point. No specialist agent may act without an official 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.
 
 ---
 
-## 🤖 Adapter Automation Levels
+## 📊 Active Risk Tracking Dashboard (May 2026)
 
-Choose your AI adapter when running `init`. Each has a different automation level:
+We are actively managing the following critical risks with dedicated improvement programs:
 
-| Adapter | Command | Automation | Notes |
-| :--- | :--- | :---: | :--- |
-| **Gemini** | `init gemini` | ✅ Full | MCP auto-wired into `gemini-extension.json`. One command, done. |
-| **Cursor** | `init cursor` | ✅ Full | `cursor.md` auto-synced to `.cursorrules`. One command, done. |
-| **Codex** | `init codex` | ✅ Full | Framework files placed in `.enderun/`. One command, done. |
-| **Claude** | `init claude` | ⚠️ Semi | After init, run one extra command shown in the terminal to register MCP tools. |
+| 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  |
 
-> **Claude Note:** Claude Code requires explicit user approval for MCP tools due to its security model.
-> After `init claude`, copy and run the `claude config add ...` command shown in the terminal output.
+Each risk has a dedicated knowledge file and a clear improvement roadmap.
 
 ---
 
-## 🎯 What You Can Do Right Now
-
-### Initialize Your Project
-```bash
-# Creates {{FRAMEWORK_DIR}}/ directory with governance files
-npx agent-enderun init gemini
-```
-
-### Check Project Health
-```bash
-# Runs security audit, compliance check, and dependency analysis
-agent-enderun check
-
-# Just security
-agent-enderun check:security
-
-# Just compliance
-agent-enderun check:compliance
-```
-
-### View Project Status
-```bash
-# Shows current phase, active agents, and blockers
-agent-enderun status
-```
-
-### Create a New Task
-```bash
-# Creates a ULID-based trace for a new feature
-agent-enderun trace:new "Implement User Authentication" backend P1
-```
-
-### Verify API Contracts
-```bash
-# Ensures shared-types and API docs are synchronized
-agent-enderun verify-contract
-```
-
----
-
-## 🏗️ Core Architecture
-
-Agent Enderun consists of **4 integrated layers**:
-
-### Layer 1: Governance ({{FRAMEWORK_DIR}}/)
-```
-{{FRAMEWORK_DIR}}/
-├── ENDERUN.md              ← The "Supreme Law" (read this first!)
-├── PROJECT_MEMORY.md       ← Single source of truth for state
-├── STATUS.md               ← Agent status dashboard
-├── cli-commands.json       ← CLI ownership mapping
-├── agents/                 ← 8 agent role definitions
-├── logs/                   ← Audit trail (agent.json files)
-├── knowledge/              ← 16+ technical knowledge articles
-└── docs/api/               ← API contract specifications
-```
-
-### Layer 2: Framework Core (bin/ + framework-mcp/)
-```
-bin/cli.js                 ← CLI bootstrapper
-framework-mcp/             ← 40+ MCP tools (13 categories) including Scaffolding
-```
-
-### Layer 3: Documentation (docs/)
-```
-docs/
-├── tech-stack.md          ← Approved technology stack
-├── project-docs.md        ← Product requirements (template)
-└── [your project files]   ← Your documents (agents will read these)
-```
-
-### Layer 4: Application (apps/) — YOURS
-```
-apps/
-├── backend/               ← Your backend app (create this)
-├── web/                   ← Your frontend app (create this)
-└── [other apps]/          ← Mobile, desktop, etc.
-```
-
----
+## 🤖 Agent Maturity Program (Target: All Agents ≥ 8.0)
 
-## 🎓 The Agent Academy — 8 Specialized Roles
+We run a structured professionalization program. Current maturity levels (May 2026):
 
-Each agent has a defined **Standard Operating Procedure (SOP)** and reads the constitution before every action.
+| 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 | Specialty | What They Do |
-|---|---|---|
-| **@manager** | Orchestration | Runs the phase machine, creates trace IDs, delegates tasks, updates PROJECT_MEMORY |
-| **@analyst** | Quality Control | Security audits, compliance checks, documentation debt, code review |
-| **@backend** | Data Architecture | Database schema, API contracts, shared-types integrity, Kysely standards |
-| **@frontend** | UI Development | React components, Panda CSS styling, Zero-UI Library enforcement, responsive design |
-| **@explorer** | Code Intelligence | Dependency graphs, complexity analysis, dead code detection, legacy code mapping |
-| **@git** | Repository Master | Semantic commits, branch management, conflict resolution, merge strategies |
-| **@mobile** | Mobile Apps | React Native, Expo, iOS/Android specifics, performance optimization |
-| **@native** | Native Apps | Tauri, Electron, native performance, IPC protocols, system integration |
+Full weekly plans are maintained in the Risk Tracking Dashboard.
 
 ---
 
-## 🛠️ MCP Tools Reference
+## 🛡️ Key Governance Innovations (v0.6.6)
 
-The framework provides **40+ tools** organized in 12 categories. Agents use these automatically.
+### 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.
 
-### Framework Tools
-- `get_framework_status` — Check framework health
-- `get_project_gaps` — Identify missing files/structure
-- `get_memory_insights` — Analyze PROJECT_MEMORY
-- `bootstrap_legacy_memory` — Auto-detect existing projects
+### 2. Hermes Live Test Program
+Four mandatory real-world scenarios to move the Hermes protocol from “defined on paper” to “proven in practice”.
 
-### Codebase Tools
-- `search_codebase` — Find code patterns
-- `analyze_dependencies` — Map imports/exports
-- `analyze_codebase_intelligence` — Find complexity & dead code
-- `generate_dependency_graph` — Mermaid diagrams
+### 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.
 
-### Security & Compliance
-- `security_audit_scan` — Check for secrets, SQL injection, console.log
-- `analyze_constitution_compliance` — Enforce ENDERUN.md rules
+### 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.
 
-### Contract Management
-- `verify_api_contract` — Hash verification
-- `verify_contract_integrity` — Type synchronization
-- `update_contract_hash` — Sync shared-types
-
-### Git & Commits
-- `generate_semantic_commit_message` — Auto-generate commit messages
-
-### Academy Intelligence
-- `get_academy_performance` — Agent success rates
-- `generate_strategic_briefing` — High-level reports
-- `log_agent_action` — Structured logging
-
-### Repository Health
-- `validate_repository_health` — Run lint/test/build
-- `analyze_documentation_debt` — Find missing JSDoc/READMEs
-
-### Agent Collaboration
-- `send_agent_message` — Inter-agent communication
-- `read_agent_messages` — Check agent inbox
-
-### Database & Knowledge
-- `analyze_database_schema` — Extract ER diagrams
-- `search_knowledge_base` — Find technical guides
-- `update_knowledge_base` — Add knowledge entries
+### 5. English-First Standardization (v0.6.6)
+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.
 
 ---
 
-## 📖 How Agents Read Your Project
+## 🏗️ Architecture Overview
 
-When you add documentation to `docs/`, agents automatically discover and use it:
+Agent Enderun is built on four layers:
 
-```
-docs/
-├── project-docs.md        ← Agents read here for requirements
-├── tech-stack.md          ← Technology decisions
-├── design-system.md       ← (optional) UI patterns
-├── api-guide.md           ← (optional) API examples
-└── architecture.md        ← (optional) System design
-```
-
-Agents use the `search_knowledge_base` tool to find answers to common questions.
+- **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)
 
 ---
 
-## ✅ Complete Installation Checklist
-
-- [ ] **Node.js 20+** installed (`node --version`)
-- [ ] **npm 9+** installed (`npm --version`)
-- [ ] **Git** initialized (`git init`)
-- [ ] **Framework installed** (`npm install && npm run enderun:build`)
-- [ ] **Health check passed** (`agent-enderun check` shows ✅)
-- [ ] **First task created** (`agent-enderun trace:new "Your task" backend P1`)
-- [ ] **Docs created** (add files to `docs/` for agents to read)
-- [ ] **MCP connected** (agents can now use tools)
-
----
-
-## 🚀 First Real Task
-
-Once everything is installed, try this:
+## ⚡ Quick Start
 
 ```bash
-# Step 1: Create a real project requirement
-echo "# User Authentication
-
-Implement JWT-based authentication with refresh tokens.
-- Email/password login
-- Logout endpoint
-- Token refresh mechanism
-" > docs/requirements.md
-
-# Step 2: Create a task
-agent-enderun trace:new "Implement Auth Module" backend P1
-
-# Step 3: Agents read requirements and build
-# (They will automatically read docs/requirements.md)
-```
-
----
-
-## 📁 Project Structure
-
-```
-agent-enderun/
-├── README.md                          ← This file
-├── package.json                       ← Root npm config
-├── bin/
-│   └── cli.js                         ← CLI entry point
-├── docs/                              ← Your project docs (agents read these)
-├── framework-mcp/                     ← MCP server (40+ tools)
-│   └── src/tools/
-│       ├── scaffold.ts                ← Blueprint construction
-│       ├── academy.ts
-│       ├── codebase.ts
-│       └── [10 more...]
-├── apps/                              ← Your applications (start here)
-│   ├── backend/
-│   │   ├── src/types/                 ← App-local contract types
-│   │   └── contract.version.json      ← SHA-256 integrity hash
-│   └── web/
-│       └── src/types/                 ← Frontend mirrors of backend types
-└── {{FRAMEWORK_DIR}}/                          ← Framework governance
-    ├── ENDERUN.md                     ← Constitution (MANDATORY READ)
-    ├── PROJECT_MEMORY.md              ← State machine
-    ├── STATUS.md                      ← Agent dashboard
-    ├── cli-commands.json              ← Command ownership
-    ├── config.json                    ← Configuration
-    ├── agents/                        ← 8 agent role docs
-    │   ├── manager.md
-    │   ├── analyst.md
-    │   ├── backend.md
-    │   ├── frontend.md
-    │   ├── explorer.md
-    │   ├── git.md
-    │   ├── mobile.md
-    │   └── native.md
-    ├── logs/                          ← Audit trail
-    │   ├── manager.json
-    │   ├── backend.json
-    │   ├── frontend.json
-    │   ├── analyst.json
-    │   ├── explorer.json
-    │   ├── git.json
-    │   ├── mobile.json
-    │   └── native.json
-    ├── knowledge/                     ← 16+ technical guides
-    │   ├── branded_types_pattern.md
-    │   ├── async_error_handling.md
-    │   ├── security_scanning.md
-    │   ├── contract_versioning.md
-    │   ├── git_commit_strategy.md
-    │   ├── testing_standards.md
-    │   └── [12 more...]
-    ├── messages/                      ← Inter-agent communication
-    └── docs/
-        ├── api/                       ← API contracts
-        │   ├── auth.md
-        │   ├── errors.md
-        │   └── README.md
-        └── [other docs]
-```
-
----
-
-## 💡 Frequently Asked Questions
-
-### Q: What does "contract-first" mean?
-**A:** All API shapes and domain models are defined in `packages/shared-types/src/index.ts` **before** any code is written. Frontend and backend must both use these types, ensuring perfect alignment.
-
-### Q: Do agents actually understand all this?
-**A:** Yes. Before every action, agents read:
-1. `ENDERUN.md` (the constitution)
-2. `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` (project state)
-3. `docs/` files (your requirements)
-4. `{{FRAMEWORK_DIR}}/knowledge/` (technical guidelines)
+# 1. Initialize the framework (creates .enderun/ structure)
+npx agent-enderun init
 
-### Q: What if I don't use an AI adapter?
-**A:** The framework still works as a **collaborative development platform**. You and your team use it to enforce:
-- Phase progression
-- Audit logging
-- Shared type discipline
-- API contract verification
-
-### Q: Can I extend the MCP tools?
-**A:** Yes. Add new tool files in `packages/framework-mcp/src/tools/`, define the schema, and export the handler. The CLI will automatically discover them.
-
-### Q: How do I add my own agents?
-**A:** Create a markdown file in `{{FRAMEWORK_DIR}}/agents/your-agent.md`, define the SOP, and add a CLI mapping in `{{FRAMEWORK_DIR}}/cli-commands.json`.
-
-### Q: Is this production-ready?
-**A:** The **framework** is production-ready. Individual features (like `apps/`) depend on what you build. Start with `apps/backend` or `apps/web`.
-
----
-
-## 🔗 Key Files to Read First
-
-1. **`{{FRAMEWORK_DIR}}/ENDERUN.md`** — The constitution (rules all agents must follow)
-2. **`{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md`** — Current project state and history
-3. **`docs/tech-stack.md`** — Technology decisions
-4. **`packages/shared-types/src/index.ts`** — The contract (types)
-5. **`README.md`** (this file) — How to use the framework
-
----
-
-## 📞 Support & Contribution
-
-### Report Issues
-File issues with clear reproduction steps and framework version.
-
-### Contribute
-1. Read `{{FRAMEWORK_DIR}}/ENDERUN.md`
-2. Follow the agent role guidelines
-3. Submit PRs with semantic commit messages
-4. Ensure tests pass: `npm run enderun:build`
-
-### License
-MIT © 2026 Yusuf BEKAR
-
----
-
-# Türkçe
-
-## Genel Özet
-
-Agent Enderun, **kurumsal-grade bir yapay zeka yönetim çerçevesidir** ve yapay zeka asistanlarını kontrol altında tutmanız, izlenebilir olmasını sağlamanız ve disiplinli kod üretimini garantilamanız için tasarlanmıştır.
-
-- **Ajan Orkestrasyonu**: 8 uzmanlaşmış yapay zeka rolü
-- **Sözleşme-İlk Geliştirme**: Paylaşılan TypeScript türleri
-- **Faz Tabanlı Yürütme**: Sıkı iş akışı (PHASE_0 → PHASE_4)
-- **Kurumsal Denetim**: Her karar, işlem ve commit kaydedilir
-- **Modüler MCP Zekası**: 40+ araç, 12 kategori
-
----
-
-## ⚡ 5 Dakikalık Hızlı Başlangıç
-
-### Gereksinimler
-- **Node.js**: 20+ (LTS önerilir)
-- **npm**: 9+
-- **Git**: Proje kökünde başlatılmış
-- **AI Adaptörü** (opsiyonel): Gemini, Claude, Cursor veya Codex
-
-### Kurulum Adımları
-
-#### Adım 1: Clone veya İnit
-```bash
-# Seçenek A: Framework repository'sini klonla
-git clone https://github.com/ybekar/agent-enderun.git
-cd agent-enderun
-
-# Seçenek B: veya npm paketi olarak kullan
-npx agent-enderun init gemini
-```
-
-#### Adım 2: Bağımlılıkları Yükle
-```bash
+# 2. Install dependencies
 npm install
-```
 
-#### Adım 3: Framework'ü Derle
-```bash
+# 3. Build the framework
 npm run enderun:build
-```
-
-#### Adım 4: Kurulumu Doğrula
-```bash
-agent-enderun check
-```
-
-Beklenen çıktı:
-```
-✅ Framework aktif (v0.5.8)
-✅ MCP Sunucu hazır
-✅ Paylaşılan türler derlenmiş
-✅ Agent logları başlatılmış
-✅ PROJECT_MEMORY.md bulundu
-```
-
----
 
-## 🎯 Şu Anda Yapabileceğiniz İşler
-
-### Projeyi Başlat
-```bash
-npx agent-enderun init gemini
+# 4. Verify installation
+npx agent-enderun check
 ```
 
-### Sağlık Durumunu Kontrol Et
-```bash
-agent-enderun check                 # Tam kontrol
-agent-enderun check:security        # Sadece güvenlik
-agent-enderun check:compliance      # Sadece uyum
-```
+**Custom Adapter Option:**  
+You can also initialize with a specific AI assistant/editor adapter:  
+`npx agent-enderun init [antigravity | claude | cursor | codex | gemini]`
 
-### Proje Durumunu Görüntüle
-```bash
-agent-enderun status
-```
-
-### Yeni Görev Oluştur
-```bash
-agent-enderun trace:new "Kullanıcı Doğrulama Uygulaması" backend P1
-```
-
-### API Kontratlarını Doğrula
-```bash
-agent-enderun verify-contract
-```
+For the complete step-by-step guide, see: [docs/getting-started.md](docs/getting-started.md)
 
 ---
 
-## 🤖 Adaptör Otomasyon Seviyeleri
-
-`init` komutunu çalıştırırken adaptörünüzü seçin. Her adaptörün otomasyon seviyesi farklıdır:
-
-| Adaptör | Komut | Otomasyon | Not |
-| :--- | :--- | :---: | :--- |
-| **Gemini** | `init gemini` | ✅ Tam | MCP `gemini-extension.json`'a otomatik yazılır. Tek komut, bitti. |
-| **Cursor** | `init cursor` | ✅ Tam | `cursor.md` otomatik olarak `.cursorrules`'a kopyalanır. Tek komut, bitti. |
-| **Codex** | `init codex` | ✅ Tam | Framework dosyaları `.enderun/` dizinine yerleştirilir. Tek komut, bitti. |
-| **Claude** | `init claude` | ⚠️ Yarı | Init sonrası terminalde gösterilen `claude config add ...` komutunu çalıştırmanız gerekir. |
-
-> **Claude Notu:** Claude Code, güvenlik modeli gereği MCP araçlarının kullanıcı tarafından açıkça onaylanmasını zorunlu kılar.
-> `init claude` sonrası terminal çıktısındaki `claude config add ...` komutunu kopyalayıp çalıştırın.
-
----
-
-## 🏗️ Temel Mimari
-
-Agent Enderun **4 entegre katmandan** oluşur:
+## 🧠 Current Honest Status (May 2026)
 
-### Katman 1: Yönetişim ({{FRAMEWORK_DIR}}/)
-- `ENDERUN.md` — Anayasa (bunu ilk oku!)
-- `PROJECT_MEMORY.md` — Proje durumu
-- `agents/` — 8 ajan rolü tanımları
-- `logs/` — Denetim kaydı
-- `knowledge/` — 16+ teknik rehberi
-- `docs/api/` — API sözleşmeleri
+**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)
 
-### Katman 2: Framework Çekirdeği
-- `packages/framework-mcp/` — 40+ MCP aracı
-- `packages/shared-types/` — Paylaşılan türler (sözleşme)
-- `bin/cli.js` — CLI başlatıcısı
-
-### Katman 3: Dokümantasyon
-- `docs/tech-stack.md` — Teknoloji kararları
-- `docs/project-docs.md` — Ürün gereksinimleri
-- Ajanlar bu dosyaları okurlar
-
-### Katman 4: Uygulamalarınız
-- `apps/backend/` — Backend uygulaması (siz oluşturun)
-- `apps/web/` — Frontend uyguması (siz oluşturun)
-
----
-
-## 🎓 Ajan Akademisi — 8 Uzman Rol
-
-| Ajan | Uzmanlık | Görev |
-|---|---|---|
-| **@manager** | Orkestrasyoun | Faz yönetimi, trace ID, görev delegasyonu |
-| **@analyst** | Kalite Kontrol | Güvenlik denetimi, uyum kontrolü, kod incelemesi |
-| **@backend** | Veri Mimarisi | Veritabanı, API kontratları, Kysely standartları |
-| **@frontend** | UI Geliştirme | React, Panda CSS, bileşen tasarımı |
-| **@explorer** | Kod Zekası | Bağımlılıklar, karmaşıklık, ölü kod |
-| **@git** | Repository Ustası | Semantik commit'ler, branch yönetimi |
-| **@mobile** | Mobil Uygulamalar | React Native, Expo, iOS/Android |
-| **@native** | Yerel Uygulamalar | Tauri, Electron, sistem entegrasyonu |
+**Areas Requiring Significant Work:**
+- Build and test infrastructure currently broken (critical P0)
+- 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
 
 ---
 
-## ✅ Komple Kurulum Kontrol Listesi
+## 📍 Next Major Milestones
 
-- [ ] **Node.js 20+** yüklü (`node --version`)
-- [ ] **npm 9+** yüklü (`npm --version`)
-- [ ] **Git** başlatılmış (`git init`)
-- [ ] **Framework yüklü** (`npm install && npm run enderun:build`)
-- [ ] **Sağlık kontrolü geçti** (`agent-enderun check` ✅ gösteriyor)
-- [ ] **İlk görev oluşturuldu** (`agent-enderun trace:new "Görev" backend P1`)
-- [ ] **Doklar oluşturuldu** (`docs/` klasörüne dosya ekledim)
-- [ ] **MCP bağlandı** (ajanlar araçları kullanabiliyor)
+1. Fix build, lint, and test pipeline (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
 
 ---
 
-## 🚀 İlk Gerçek Görev
-
-Kurulum tamamlandıktan sonra bunu deneyin:
-
-```bash
-# Adım 1: Gerçek gereksinim yazın
-echo "# Kullanıcı Doğrulaması
-
-JWT tabanlı kimlik doğrulama sistemi kurun.
-- Email/şifre girişi
-- Oturumu kapat endpoint'i
-- Token yenileme mekanizması
-" > docs/requirements.md
-
-# Adım 2: Görev oluşturun
-agent-enderun trace:new "Auth Modülü Uygula" backend P1
+## 📚 Further Reading
 
-# Adım 3: Ajanlar sizin için çalışır
-# (Otomatik olarak docs/requirements.md okurlar)
-```
+- **[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
 
 ---
 
-## 📁 Proje Yapısı
-
-```
-agent-enderun/
-├── docs/                 ← Ajanların okuyacağı dokümantasyon
-├── framework-mcp/        ← MCP sunucusu (40+ araç)
-├── apps/                 ← Uygulamalarınız (siz oluşturun)
-├── {{FRAMEWORK_DIR}}/             ← Yönetişim dosyaları
-└── bin/
-    └── cli.js            ← CLI giriş noktası
-```
+**Agent Enderun is not just a tool.**  
+**It is a complete operating system for professional, risk-aware, AI-assisted software development.**
 
 ---
 
-## 💡 Sıkça Sorulan Sorular
-
-### S: "Sözleşme-ilk" ne demek?
-**C:** Tüm API şekilleri ve alan modelleri `packages/shared-types` içinde **kod yazılmadan önce** tanımlanır. Frontend ve backend aynı türleri kullanır.
-
-### S: Ajanlar bütün bunları anlıyor mu?
-**C:** Evet. Her işlem öncesi şunları okurlar:
-1. `ENDERUN.md` (anayasa)
-2. `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` (proje durumu)
-3. `docs/` dosyaları (gereksinimler)
-4. `{{FRAMEWORK_DIR}}/knowledge/` (teknik rehberler)
+# Türkçe
 
-### S: AI adaptörü kullanmak zorunlu mu?
-**C:** Hayır. Framework, AI'sız da işlev görür. Faz ilerleme, denetim kaydı ve tür disiplini zorunludur.
+**Geliştirici:** Yusuf BEKAR
 
-### S: MCP araçlarını genişletebilir miyim?
-**C:** Evet. `packages/framework-mcp/src/tools/` klasörüne yeni dosya ekleyin.
+## Yönetici Özeti
 
-### S: Kendi ajanlarımı ekleyebilir miyim?
-**C:** Evet. `{{FRAMEWORK_DIR}}/agents/` klasörüne `.md` dosyası oluşturun ve CLI mapping'ini güncelleyin.
+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.
 
-### S: Üretim için hazır mı?
-**C:** Framework hazır. `apps/` klasörü tamamen sizin.
+Ç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.6 Stratejik Odak
 
-## 🔗 Önce Okumanız Gereken Dosyalar
+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.
 
-1. **`{{FRAMEWORK_DIR}}/ENDERUN.md`** — Anayasa
-2. **`{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md`** — Proje durumu
-3. **`docs/tech-stack.md`** — Teknoloji kararları
-4. **`packages/shared-types/src/index.ts`** — Sözleşme (türler)
-5. **`README.md`** — Bu dosya
+Tüm aktif risklerin güncel durumu için: [docs/roadmap.md](docs/roadmap.md)
 
 ---
 
-## 📞 Destek & Katkı
-
-### Sorun Bildir
-Net adımlarla ve versiyon numarası ile sorun bildir.
-
-### Katkıda Bulun
-1. `{{FRAMEWORK_DIR}}/ENDERUN.md` oku
-2. Agent rolü yönergelerine uyun
-3. Semantik commit'ler gönder
-4. Testleri geç: `npm run enderun:build`
-
-### Lisans
-MIT © 2026 Yusuf BEKAR
-```bash
-agent-enderun status
-```
-
-### 4. Advanced Intelligence Commands
-```bash
-# Run Security Audit
-agent-enderun check:security
+## 🎯 Temel Felsefe
 
-# Generate Dependency Graph
-agent-enderun explorer:graph
+Dört vazgeçilmez ilke üzerine inşa edilmiştir:
 
-# Get Commit Suggestion
-agent-enderun git:commit [TRACE-ID]
-```
+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.
 
 ---
 
-## 📂 Consolidated Framework Structure (`{{FRAMEWORK_DIR}}/`)
-
-All governance and engineering assets are consolidated under the framework directory for a clean project root.
-
-```text
-.
-├── {{FRAMEWORK_DIR}}/
-│   ├── ENDERUN.md           # Supreme Law (Constitution)
-│   ├── PROJECT_MEMORY.md    # Working Memory & History
-│   ├── BRAIN_DASHBOARD.md   # Intelligence & Performance Stats
-│   ├── cli-commands.json    # Agent-to-CLI Mapping
-│   ├── agents/              # 8 Specialized Agent SOPs
-│   ├── knowledge/           # 17+ Enterprise Knowledge Articles
-│   ├── docs/                # API Contracts, Security, Privacy, Strategy
-│   ├── logs/                # Traceable structured JSON logs
-│   ├── benchmarks/          # Performance metrics
-│   └── monitoring/          # System health hooks
-├── bin/                     # CLI Entry Point
-├── packages/                # Shared Types & MCP Engine
-└── apps/                    # Production Modules (Backend, Web, Mobile)
-```
+## 🛡️ Önemli Yönetişim Yenilikleri (v0.6.6)
 
----
-
-## 🛡️ Engineering Standards
-
--   **Zero Mock Policy:** Placeholders are forbidden. Every line of code must be functional.
--   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
--   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
--   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+- 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.6:** Tüm framework İngilizce standardizasyonu
 
 ---
 
-## 📜 License
-MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
-unctional.
--   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
--   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
--   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+## 🧠 Dürüst Durum (Mayıs 2026)
 
----
+**Güçlü Yönler:** Anayasal yönetişim, risk yönetimi, Hermes protokolü temeli, contract-first disiplin, ileri düzey kurumsal adaptasyon kuralları.
 
-## 📜 License
-MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
-/                     # CLI Entry Point
-├── packages/                # Shared Types & MCP Engine
-└── apps/                    # Production Modules (Backend, Web, Mobile)
-```
+**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ış.
 
 ---
 
-## 🛡️ Engineering Standards
+## 📍 Önümüzdeki Önemli Hedefler
 
--   **Zero Mock Policy:** Placeholders are forbidden. Every line of code must be functional.
--   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
--   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
--   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+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
 
 ---
 
-## 📜 License
-MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
-lders are forbidden. Every line of code must be functional.
--   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
--   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
--   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+**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.**
 
 ---
 
-## 📜 License
-MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
+**v0.6.6 — English Standardization Release**