agent-enderun 0.7.1 → 0.7.5

package/.enderun/memory-graph/agent-contexts/mobile.json

@@ -0,0 +1 @@
+{ "agent": "@mobile", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }

package/.enderun/memory-graph/agent-contexts/native.json

@@ -0,0 +1 @@
+{ "agent": "@native", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }

package/.enderun/memory-graph/agent-contexts/orchestrator.json

@@ -0,0 +1 @@
+{ "agent": "@orchestrator", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }

package/.enderun/memory-graph/agent-contexts/qa.json

@@ -0,0 +1 @@
+{ "agent": "@qa", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }

package/.enderun/memory-graph/agent-contexts/security.json

@@ -0,0 +1 @@
+{ "agent": "@security", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }

package/.enderun/memory-graph/graph.json

@@ -0,0 +1,26 @@
+{
+  "version": "1.0.0",
+  "description": "Agent Enderun Army Memory Graph. Tracks all agent interactions, delegations, and communication edges across the entire army.",
+  "generatedAt": "2026-05-25T17:00:00Z",
+  "updatedAt": "2026-05-25T17:00:00Z",
+  "nodes": [
+    { "id": "@manager", "state": "IDLE", "lastAction": "Framework initialized", "activeTrace": null, "healthScore": 9.5, "totalActionsThisSession": 0 },
+    { "id": "@orchestrator", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.8, "totalActionsThisSession": 0 },
+    { "id": "@backend", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.2, "totalActionsThisSession": 0 },
+    { "id": "@frontend", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.0, "totalActionsThisSession": 0 },
+    { "id": "@security", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.3, "totalActionsThisSession": 0 },
+    { "id": "@qa", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.1, "totalActionsThisSession": 0 },
+    { "id": "@devops", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.0, "totalActionsThisSession": 0 },
+    { "id": "@analyst", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.6, "totalActionsThisSession": 0 },
+    { "id": "@explorer", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.4, "totalActionsThisSession": 0 },
+    { "id": "@git", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.1, "totalActionsThisSession": 0 },
+    { "id": "@mobile", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 8.8, "totalActionsThisSession": 0 },
+    { "id": "@native", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 8.9, "totalActionsThisSession": 0 }
+  ],
+  "edges": [],
+  "schema": {
+    "nodeFields": ["id", "state", "lastAction", "activeTrace", "healthScore", "totalActionsThisSession"],
+    "edgeFields": ["id", "from", "to", "type", "traceId", "timestamp", "metadata"],
+    "edgeTypes": ["DELEGATED", "ESCALATED", "BLOCKED_BY", "UNBLOCKED_BY", "BROADCAST", "COLLABORATED", "REVIEWED"]
+  }
+}

package/.enderun/memory-graph/shared-facts.json

@@ -0,0 +1,52 @@
+{
+  "version": "1.0.0",
+  "description": "Shared facts available to ALL agents in the Enderun Army. This is the single source of truth for project-wide knowledge that every agent must know.",
+  "updatedAt": "2026-05-25T17:00:00Z",
+  "updatedBy": "@manager",
+  "techStack": {
+    "backend": "Node.js 20+ + Fastify (RCSR Architecture)",
+    "frontend": "React 19 + Vite + Panda CSS",
+    "mobile": "React Native CLI",
+    "database": "PostgreSQL (Multi-Tenant RLS + PostGIS)",
+    "orm": "Kysely",
+    "testing": "Vitest",
+    "typeSystem": "TypeScript 5 (strict mode, no any, branded types)",
+    "monorepo": "npm workspaces",
+    "cicd": "GitHub Actions (to be configured by @devops)"
+  },
+  "criticalDecisions": [
+    { "date": "2026-05-21", "decision": "No Docker Support", "rationale": "Direct system execution for performance", "decidedBy": "@manager" },
+    { "date": "2026-05-21", "decision": "Zero Mock Policy", "rationale": "All analytical and management UIs connected to real APIs", "decidedBy": "@manager" },
+    { "date": "2026-05-23", "decision": "PostgreSQL Unlogged Table Cache instead of Redis", "rationale": "Minimize external infrastructure dependencies", "decidedBy": "@manager" }
+  ],
+  "activePolicies": [
+    "Zero Mock Policy — no fake data anywhere in the codebase",
+    "Branded Types Law — all IDs must use branded types",
+    "Shared Component First — no UI elements defined in page files",
+    "Contract-First — @backend defines types before @frontend starts",
+    "No any Type — TypeScript strict mode enforced across all packages",
+    "No console.log in production code",
+    "Audit Log Mandatory — every agent action must be logged"
+  ],
+  "activeContracts": {
+    "contractVersionFile": "apps/backend/contract.version.json",
+    "currentVersion": "latest — check file",
+    "sharedTypesLocation": "apps/backend/src/types/"
+  },
+  "agentCapabilityRoster": [
+    { "agent": "@manager", "capability": 9.5, "primaryDomain": "governance" },
+    { "agent": "@orchestrator", "capability": 9.8, "primaryDomain": "orchestration" },
+    { "agent": "@analyst", "capability": 9.6, "primaryDomain": "analysis" },
+    { "agent": "@explorer", "capability": 9.4, "primaryDomain": "exploration" },
+    { "agent": "@security", "capability": 9.3, "primaryDomain": "security" },
+    { "agent": "@backend", "capability": 9.2, "primaryDomain": "backend" },
+    { "agent": "@git", "capability": 9.1, "primaryDomain": "git" },
+    { "agent": "@qa", "capability": 9.1, "primaryDomain": "qa" },
+    { "agent": "@frontend", "capability": 9.0, "primaryDomain": "frontend" },
+    { "agent": "@devops", "capability": 9.0, "primaryDomain": "devops" },
+    { "agent": "@native", "capability": 8.9, "primaryDomain": "native" },
+    { "agent": "@mobile", "capability": 8.8, "primaryDomain": "mobile" }
+  ],
+  "frameworkVersion": "1.0.0-alpha",
+  "constitutionFile": "ENDERUN.md"
+}

package/.enderun/queue/README.md

@@ -0,0 +1,36 @@
+# .enderun/queue — Agent Görev Kuyruğu
+
+Bu dizin, Agent Enderun Army'nin file-based asenkron görev kuyruğunu içerir.
+
+## Alt Dizinler
+
+| Dizin | İçerik |
+|---|---|
+| `pending/` | Atanmış ama henüz başlatılmamış görevler (`{traceId}.json`) |
+| `processing/` | Aktif olarak yürütülen görevler |
+| `completed/` | Başarıyla tamamlanan görevler (arşiv) |
+| `failed/` | Başarısız görevler (retry logic ile yönetilir) |
+| `pipelines/` | `create_execution_pipeline` MCP tool tarafından oluşturulan pipeline JSON dosyaları |
+
+## Görev Dosyası Formatı
+
+```json
+{
+  "id": "T001",
+  "traceId": "ENR-ARMY-001",
+  "assignedAgent": "@backend",
+  "priority": "HIGH",
+  "briefing": "...",
+  "createdAt": "ISO-8601",
+  "deadline": "ISO-8601",
+  "retryCount": 0,
+  "maxRetries": 3,
+  "status": "PENDING | RUNNING | COMPLETED | FAILED"
+}
+```
+
+## Kilitleme Protokolü
+
+Bir dosyaya yazmadan önce `.lock` dosyasını kontrol et.
+Varsa 500ms bekle, max 3 retry.
+3 retry sonrası stale lock sayılır ve @manager'a bildirilir.

package/ENDERUN.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.6.6)
+# Agent Enderun (v0.7.5)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
@@ -52,7 +52,7 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 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. **Respect Boundaries:** Always distinguish between the user's project code and the Agent Enderun framework internals. Read `{{FRAMEWORK_DIR}}/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.
@@ -89,9 +89,9 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 
 - **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 `.antigravitycli/knowledge/`, `{{FRAMEWORK_DIR}}/agents/`, or any framework folder.
+  These documents must **never** be written into `{{FRAMEWORK_DIR}}/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 `.antigravitycli/knowledge/documentation_ownership.md`.
+  The detailed and binding rule is defined in `{{FRAMEWORK_DIR}}/knowledge/documentation_ownership.md`.
 
 ---
 

package/README.md

@@ -1,10 +1,10 @@
-# 🏛️ Agent Enderun (v0.7.0) — The Supreme AI Governance & Orchestration Framework
+# 🏛️ Agent Enderun (v0.7.5) — The Supreme AI Governance & Orchestration Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
-**Author:** Yusuf BEKAR  
-**Version:** 0.7.0  
-**License:** MIT  
+**Author:** Yusuf BEKAR
+**Version:** 0.7.5
+**License:** MIT
 
 [English](#english) | [Türkçe](#türkçe)
 
@@ -20,27 +20,39 @@ Most AI coding tools optimize for speed and generation volume. Agent Enderun opt
 
 > [!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.
+> The active runtime folder in user projects is `.gemini/`. The framework ships its templates from `.enderun/`. All specialist agent configurations live as strongly-typed `agent.json` under `.gemini/agents/{agent_name}/agent.json`. Duplicate or staging structures have been retired.
 
 ---
 
-## 🎯 Core Philosophy
+## 🎯 Core Philosophy & Key Concepts
 
-Agent Enderun is built on four non-negotiable principles:
+Agent Enderun is built on a set of non-negotiable principles enforced by its core components.
 
-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.
+### 1. The Constitution (`ENDERUN.md`)
+This is the supreme law of the framework, dictating mandatory rules and protocols for all agents. Key principles include:
+- **Single Point of Authority:** In enterprise projects, `@manager` is the only authorized entry point. No specialist agent may act without a formal briefing.
+- **Contract-First Development:** The `@backend` agent MUST define and document API contracts and types before the `@frontend` agent begins implementation.
+- **Zero UI Library & Zero Mock Policy:** The `@frontend` agent MUST build components from scratch using the project's design system (Panda CSS) and MUST NOT use mock data. This ensures originality and quality.
+- **Procedural Continuity:** All agents MUST adhere to the existing architectural and stylistic patterns of the project.
+
+### 2. Project Memory (`PROJECT_MEMORY.md`)
+This file, located in `.gemini/`, is the **Single Source of Truth (SSOT)** for the project's state. It is a human-readable Markdown file that all agents read at the start of a session and update at the end. Its key sections are:
+- **`CURRENT STATUS`:** Tracks the active phase, Trace ID, and any blockers.
+- **`CRITICAL DECISIONS`:** A log of important architectural choices to ensure consistency.
+- **`ACTIVE TASKS`:** A table of all ongoing tasks, their status, priority, and assigned agent.
+- **`HISTORY`:** A persistent log of all actions taken by agents.
+
+### 3. Traceability (Trace ID)
+Every task or logical unit of work is assigned a unique **Trace ID** (a 26-character ULID). This ID is used in commit messages, logs, and task tables, providing an unbroken chain of traceability from the initial request to the final code.
 
 ---
 
-## 🤖 JSON-First Agent Army & Maturity Program
+## 🤖 The Agent Army
 
-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.
+Each agent in the Enderun Army is governed by a strongly-typed `agent.json` definition that defines their precise rules, permitted directories, and capability ratings.
 
 ### Workspace Agent Path:
-👉 `[project-root]/.agents/agents/{agent_name}/agent.json`
+👉 `[project-root]/.gemini/agents/{agent_name}/agent.json`
 
 ### Agent Army Overview:
 
@@ -57,77 +69,73 @@ Each agent in the Enderun Army is governed by a strongly-typed `agent.json` defi
 
 ---
 
-## 🏗️ Architecture Overview
+## ⚡ Quick Start & Workflow
 
-Agent Enderun cleanly separates the framework's own engine from the user's project codebase:
+### 1. Installation
 
-```
-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
+Install the package and initialize the framework inside your project folder:
+
+```bash
+# 1. Initialize the framework for Gemini CLI
+npx agent-enderun init gemini
+
+# 2. Install dependencies (as prompted)
+npm install
+
+# 3. Build the framework's internal tools (as prompted)
+npm run enderun:build
+
+# 4. Verify installation and project health
+npx agent-enderun check
 ```
 
----
+### 2. Example Workflow: Adding a New Feature
 
-## ⚡ Quick Start
+Here’s how to use Agent Enderun to develop a new feature:
 
-### 1. Installation & Initialization
+**Step 1: Define the Task**
+Create a new file in your project's `docs/` folder (e.g., `docs/new-feature-request.md`) describing the feature you want.
 
-Install the package globally or initialize it inside your project folder:
+**Step 2: Create a New Trace**
+Use the CLI to create a new task in `PROJECT_MEMORY.md`. This generates a unique Trace ID.
 
 ```bash
-# 1. Initialize the framework (creates .antigravitycli/ and .agents/ structures)
-npx agent-enderun init
+npx agent-enderun trace:new "Implement user profile page based on docs/new-feature-request.md" @manager P1
+```
 
-# 2. Install dependencies
-npm install
+**Step 3: Agent Orchestration (Automatic)**
+The `@manager` agent (the default AI persona) will:
+1.  Read `PROJECT_MEMORY.md` and see the new task.
+2.  Analyze the request from `docs/new-feature-request.md`.
+3.  Create a plan and issue formal "briefings" to specialist agents like `@explorer`, `@backend`, and `@frontend`.
 
-# 3. Build the framework
-npm run enderun:build
+**Step 4: Development & Verification (Automatic)**
+- The specialist agents execute their tasks according to the constitutional rules (e.g., `@backend` creates the API and types, then `@frontend` builds the UI).
+- `@analyst` automatically verifies the work against project standards.
+- `@git` creates atomic commits tagged with the Trace ID.
 
-# 4. Verify installation & health
-npx agent-enderun check
-```
+**Step 5: Monitor Progress**
+You can check the progress at any time with the `status` command:
 
-### 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.
+```bash
+npx agent-enderun status
+```
+This will show the active phase, blockers, and the status of all active tasks.
 
 ---
 
-## 🧠 Current Status & Next Milestones
+## 🛠️ CLI Commands
 
-### 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 comes with a powerful set of CLI tools for managing the project.
 
-### 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.
+| Command | Description |
+| :--- | :--- |
+| `npx agent-enderun init [adapter]` | Initializes the framework in the current project. `gemini` is the default and recommended adapter. |
+| `npx agent-enderun check` | Runs a health check on the project to ensure all required files and configurations are present. |
+| `npx agent-enderun status` | Displays the current project status, active tasks, and blockers from `PROJECT_MEMORY.md`. |
+| `npx agent-enderun trace:new "<desc>" [agent] [priority]` | Creates a new task with a unique Trace ID and adds it to the `PROJECT_MEMORY.md`. |
+| `npx agent-enderun create-app "<desc>"` | (Aliases: `new`, `start`) Scaffolds a new full-stack application (backend + web) from a natural language description. |
+| `npx agent-enderun verify-contract` | Verifies the integrity of the shared backend types by comparing the current code against the stored hash in `contract.version.json`. |
 
 ---
 
@@ -141,27 +149,39 @@ At the start of every session, the active agent must:
 
 > [!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.
+> Çalışma zamanı klasörü kullanıcı projelerinde `.gemini/` olarak oluşturulur. Ajan yapılandırmaları `.gemini/agents/{agent_name}/agent.json` altında yer alır. Eski veya mükerrer yapılar tamamen kaldırılmıştır.
 
 ---
 
-## 🎯 Temel Felsefe
+## 🎯 Temel Felsefe ve Anahtar Kavramlar
 
-Agent Enderun, dört tavizsiz ilke üzerine inşa edilmiştir:
+Agent Enderun, temel bileşenleri tarafından uygulanan, tavizsiz ilkeler üzerine kurulmuştur.
 
-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.
+### 1. Anayasa (`ENDERUN.md`)
+Bu, tüm ajanlar için zorunlu kuralları ve protokolleri dikte eden, çerçevenin en üst yasasıdır. Temel ilkeler şunları içerir:
+- **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.
+- **Önce Sözleşme (Contract-First) ile Geliştirme:** `@backend` ajanı, `@frontend` ajanı uygulamaya başlamadan ÖNCE API sözleşmelerini ve tiplerini tanımlamak ve belgelemek ZORUNDADIR.
+- **Sıfır UI Kütüphanesi ve Sıfır Mock Veri Politikası:** `@frontend` ajanı, bileşenleri projenin tasarım sistemini (Panda CSS) kullanarak sıfırdan oluşturmalı ve mock (sahte) veri KULLANMAMALIDIR. Bu, özgünlüğü ve kaliteyi garanti eder.
+- **Prosedürel Devamlılık:** Tüm ajanlar, projenin mevcut mimari ve stilistik kalıplarına uymak ZORUNDADIR.
+
+### 2. Proje Hafızası (`PROJECT_MEMORY.md`)
+`.gemini/` içinde bulunan bu dosya, projenin durumu için **Tek Doğruluk Kaynağıdır (SSOT)**. Tüm ajanların bir oturumun başında okuduğu ve sonunda güncellediği, insan tarafından okunabilir bir Markdown dosyasıdır. Ana bölümleri şunlardır:
+- **`CURRENT STATUS`:** Aktif aşamayı, Trace ID'yi ve varsa engelleyicileri izler.
+- **`CRITICAL DECISIONS`:** Tutarlılığı sağlamak için önemli mimari seçimlerin bir kaydı.
+- **`ACTIVE TASKS`:** Devam eden tüm görevlerin, durumlarının, önceliklerinin ve atanan ajanın bir tablosu.
+- **`HISTORY`:** Ajanlar tarafından gerçekleştirilen tüm eylemlerin kalıcı bir kaydı.
+
+### 3. İzlenebilirlik (Trace ID)
+Her göreve veya mantıksal iş birimine benzersiz bir **Trace ID** (26 karakterlik bir ULID) atanır. Bu kimlik, commit mesajlarında, loglarda ve görev tablolarında kullanılarak ilk talepten nihai koda kadar kesintisiz bir izlenebilirlik zinciri sağlar.
 
 ---
 
-## 🤖 JSON-First Ajan Ordusu ve Olgunluk Programı
+## 🤖 Ajan Ordusu
 
-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.
+Enderun Ordusu'ndaki her ajan, kendilerine ait kuralları, izin verilen dizinleri 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`
+👉 `[proje-kök-dizini]/.gemini/agents/{agent_name}/agent.json`
 
 ### Ajan Ordusuna Genel Bakış:
 
@@ -178,31 +198,73 @@ Enderun Ordusu'ndaki her ajan, kendilerine ait kuralları, izin verilen dizinler
 
 ---
 
-## ⚡ Hızlı Başlangıç
+## ⚡ Hızlı Başlangıç ve İş Akışı
 
-### 1. Kurulum ve Başlatma
+### 1. Kurulum
 
-Framework'ü projenizde başlatmak için aşağıdaki adımları takip edin:
+Framework'ü projenize kurmak ve 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
+# 1. Framework'ü Gemini CLI için başlatın
+npx agent-enderun init gemini
 
-# 2. Bağımlılıkları yükleyin
+# 2. Bağımlılıkları yükleyin (istendiği gibi)
 npm install
 
-# 3. Çekirdek MCP sunucusunu derleyin
+# 3. Framework'ün dahili araçlarını derleyin (istendiği gibi)
 npm run enderun:build
 
-# 4. Kurulumu ve sağlığı doğrulayın
+# 4. Kurulumu ve proje sağlığını doğrulayın
 npx agent-enderun check
 ```
 
-### 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.
+### 2. Örnek İş Akışı: Yeni Bir Özellik Ekleme
+
+Agent Enderun'u yeni bir özellik geliştirmek için nasıl kullanacağınız aşağıda açıklanmıştır:
+
+**Adım 1: Görevi Tanımlayın**
+Projenizin `docs/` klasöründe yeni bir dosya oluşturun (örn. `docs/yeni-ozellik-isteği.md`) ve istediğiniz özelliği tanımlayın.
+
+**Adım 2: Yeni Bir İz (Trace) Oluşturun**
+`PROJECT_MEMORY.md`'de yeni bir görev oluşturmak için CLI'yi kullanın. Bu, benzersiz bir Trace ID oluşturur.
+
+```bash
+npx agent-enderun trace:new "docs/yeni-ozellik-isteği.md'ye göre kullanıcı profili sayfasını uygula" @manager P1
+```
+
+**Adım 3: Ajan Orkestrasyonu (Otomatik)**
+`@manager` ajanı (varsayılan AI kişiliği) şunları yapacaktır:
+1.  `PROJECT_MEMORY.md`'yi okuyacak ve yeni görevi görecektir.
+2.  `docs/yeni-ozellik-isteği.md`'deki talebi analiz edecektir.
+3.  Bir plan oluşturacak ve `@explorer`, `@backend` ve `@frontend` gibi uzman ajanlara resmi "brifingler" verecektir.
+
+**Adım 4: Geliştirme ve Doğrulama (Otomatik)**
+- Uzman ajanlar, anayasal kurallara göre görevlerini yerine getirir (örneğin, `@backend` API'yi ve tipleri oluşturur, ardından `@frontend` kullanıcı arayüzünü oluşturur).
+- `@analyst`, yapılan işi proje standartlarına göre otomatik olarak doğrular.
+- `@git`, Trace ID ile etiketlenmiş atomik `commit`'ler oluşturur.
+
+**Adım 5: İlerlemeyi İzleyin**
+`status` komutuyla ilerlemeyi istediğiniz zaman kontrol edebilirsiniz:
+
+```bash
+npx agent-enderun status
+```
+Bu, aktif aşamayı, engelleri ve tüm aktif görevlerin durumunu gösterecektir.
+
+---
+
+## 🛠️ CLI Komutları
+
+Agent Enderun, projeyi yönetmek için güçlü bir komut satırı araç seti ile birlikte gelir.
 
+| Komut | Açıklama |
+| :--- | :--- |
+| `npx agent-enderun init [adapter]` | Framework'ü mevcut projede başlatır. `gemini` varsayılan ve önerilen adaptördür. |
+| `npx agent-enderun check` | Gerekli tüm dosyaların ve yapılandırmaların mevcut olduğundan emin olmak için projede bir sağlık kontrolü çalıştırır. |
+| `npx agent-enderun status` | `PROJECT_MEMORY.md`'den mevcut proje durumunu, aktif görevleri ve engelleri gösterir. |
+| `npx agent-enderun trace:new "<açıklama>" [ajan] [öncelik]` | Benzersiz bir Trace ID ile yeni bir görev oluşturur ve bunu `PROJECT_MEMORY.md`'ye ekler. |
+| `npx agent-enderun create-app "<açıklama>"` | (Takma adlar: `new`, `start`) Doğal dil tanımından yeni bir tam yığın uygulama (backend + web) oluşturur. |
+| `npx agent-enderun verify-contract` | `contract.version.json`'da saklanan `hash` ile mevcut kodu karşılaştırarak paylaşılan backend tiplerinin bütünlüğünü doğrular. |
 ---
 
 **Agent Enderun is not just a tool. It is a complete operating system for professional, risk-aware, AI-assisted software development.**