agent-enderun 0.6.1 → 0.6.5

package/docs/getting-started.md

@@ -0,0 +1,497 @@
+# 🚀 Getting Started — Sıfırdan Agent Enderun ile Proje Kurma Rehberi / Quickstart Guide
+
+[English](#english) | [Türkçe](#türkçe)
+
+---
+
+# English
+
+This guide is prepared for developers and engineering teams who want to set up Agent Enderun **from scratch** on a new project. It provides a step-by-step, practical walkthrough.
+
+> **Primary recommended installation command from v0.6.5:** **`npx agent-enderun init` (generic framework setup)**
+
+---
+
+## 1. Introduction
+
+Agent Enderun is a yapay zeka/AI governance framework that provides **control, discipline, and traceability** in software development processes.
+
+By completing this guide, you will:
+- Install the framework in your project
+- Configure the basic components and environment
+- Create your first tracked task and start working with specialist agents
+
+---
+
+## 2. Prerequisites
+
+- **Node.js** 20+ (LTS recommended)
+- **npm** 9+
+- **Git** (must be initialized in the project directory)
+
+To check your local environment:
+
+```bash
+node --version
+npm --version
+git --version
+```
+
+---
+
+## 3. Step-by-Step Installation
+
+### Step 1: Create a New Project Directory
+
+```bash
+mkdir my-new-project
+cd my-new-project
+git init
+```
+
+### Step 2: Initialize the Framework
+
+To initialize the core framework cleanly (without hardcoding any AI/adapter-specific files before installation):
+
+```bash
+npx agent-enderun init
+```
+
+This command:
+- Creates the `.enderun/` directory by default
+- Installs all core governance files (`ENDERUN.md`, `PROJECT_MEMORY.md`, agents, knowledge, etc.)
+- Adds the default framework configuration files
+
+#### 💡 Optional: Installing with a Specific Adapter
+If you want to configure the framework for a specific AI assistant or editor environment (e.g. Antigravity, Claude, Cursor, Codex, Gemini), you can specify it as an option:
+
+```bash
+npx agent-enderun init antigravity
+# or
+npx agent-enderun init claude
+# or
+npx agent-enderun init cursor
+# or
+npx agent-enderun init codex
+# or
+npx agent-enderun init gemini
+```
+
+- If you run `init antigravity`, it will create `.antigravitycli/` instead of `.enderun/` and place `antigravity.md` at the project root.
+- If you run `init claude`, it will create `.claude/` and automatically configure the Claude Desktop MCP settings.
+- If you run `init cursor`, it will create `.cursor/` and copy the cursor rules configuration.
+- If you run `init gemini`, it will create `.gemini/` and place `gemini.md` at the project root.
+
+---
+
+### Step 3: Install Dependencies and Build
+
+```bash
+npm install
+npm run enderun:build
+```
+
+### Step 4: Verify the Installation
+
+```bash
+npx agent-enderun check
+```
+
+Expected output:
+
+```
+✅ Framework active (v0.6.5)
+✅ MCP Server ready
+✅ Shared types compiled
+✅ Agent logs initialized
+✅ PROJECT_MEMORY.md found
+```
+
+---
+
+## 4. Basic Configuration (Most Critical Step)
+
+Once initialized, you **must** update the following files to describe your project. Ajanlar (agents) learn your technology stack and target domain from here.
+
+### 4.1 `docs/tech-stack.md`
+
+This file is **mandatory**. Agents rely on it to make technical decisions.
+
+Example:
+
+```markdown
+# TECH STACK
+
+## Platform
+- Web (React + Vite)
+- Backend (Node.js + Fastify)
+
+## Database
+- PostgreSQL + Kysely
+
+## Auth
+- JWT + Refresh Token
+
+## Deployment
+- Vercel (Frontend) + Railway (Backend)
+```
+
+> **Warning:** If this file is empty, the agents will not be able to operate.
+
+### 4.2 `docs/project-docs.md`
+
+Write your project's goals, business requirements, and primary features here.
+
+### 4.3 `.enderun/PROJECT_MEMORY.md`
+
+Automatically created during initial setup. Review its content. *(Note: If you initialized with a custom adapter, this file will be located inside your adapter's folder, e.g., `.antigravitycli/PROJECT_MEMORY.md`)*.
+
+---
+
+## 5. Creating Your First Task
+
+You are now ready to create your first real task:
+
+```bash
+npx agent-enderun trace:new "User Registration and Login System" backend P1
+```
+
+This command:
+- Generates a unique Trace ID
+- Updates the **ACTIVE TASKS** section in `PROJECT_MEMORY.md`
+- Assigns the `@manager` agent to lead the task
+
+---
+
+## 6. Basics of Working with Agents
+
+### Automatic @manager Behavior
+
+At the start of every session (when a conversation begins), agents will automatically:
+
+1. Read `ENDERUN.md`
+2. Read `PROJECT_MEMORY.md`
+3. Load the active phase and current Trace ID
+
+### How to Direct Specialist Agents
+
+- Normally, **`@manager`** coordinates the process.
+- If you need to address a specialist agent directly, include their tag:
+
+```markdown
+@backend Implement the user model and auth services using Kysely.
+```
+
+### Critical Rules
+
+- Keep `docs/tech-stack.md` updated at all times.
+- When new key decisions are made, update the **CRITICAL DECISIONS** table in `PROJECT_MEMORY.md`.
+- Use a unique Trace ID for every task.
+
+---
+
+## 7. First Real-World Scenario Example
+
+Try this quick workflow:
+
+1. Populate `docs/tech-stack.md`
+2. Write a simple requirement in `docs/project-docs.md`
+3. Run the following command:
+
+```bash
+npx agent-enderun trace:new "User Registration and Login" backend P1
+```
+
+4. Then write to the assistant:
+
+> @manager Please analyze this requirement and propose the backend architecture.
+
+The agents will automatically:
+- Scan your codebase
+- Propose type contracts
+- Scaffold code using blueprints if necessary
+
+---
+
+## 8. Common Mistakes and Tips
+
+| Mistake | Consequence | Solution |
+| :--- | :--- | :--- |
+| Leaving `docs/tech-stack.md` empty | Agents will not know how to proceed | Ensure it is populated immediately |
+| Prompting for direct code generation | Messy and unmonitored code | Always have `@manager` plan first |
+| Not using Trace ID | Chaos and lost traceability | Use `trace:new` for every new feature |
+| Not updating `PROJECT_MEMORY.md` | Agents remember old state | Update memory with every key decision |
+
+---
+
+## 9. Next Steps
+
+After completing the guide, explore:
+
+- **Contract-First Development** → Check `apps/backend/src/types`
+- **Blueprint Scaffolding** → Look inside `.enderun/blueprints/`
+- **Security & Compliance** → Run `npx agent-enderun check:security`
+- **Inter-Agent Communication** → Hermes protocol (`messages/` directory)
+
+---
+
+## 10. Help and Support
+
+If you encounter issues:
+
+1. Run `npx agent-enderun status`
+2. Check `PROJECT_MEMORY.md`
+3. Inspect the error logs and the last 3 HISTORY entries
+
+---
+
+**Congratulations!** You can now develop software with discipline, structure, and governance using Agent Enderun.
+
+As a next step, we recommend defining **the core contracts of your first real project**.
+
+---
+
+# Türkçe
+
+Bu rehber, Agent Enderun'u **sıfırdan** yeni bir projeye kurmak isteyen geliştiriciler ve ekipler için hazırlanmıştır. Adım adım, net ve uygulanabilir şekilde anlatılmaktadır.
+
+> **v0.6.5 itibarıyla önerilen birincil başlatma komutu:** **`npx agent-enderun init` (genel framework kurulumu)**
+
+---
+
+## 1. Giriş
+
+Agent Enderun, yapay zeka destekli yazılım geliştirme süreçlerinde **kontrol, disiplin ve izlenebilirlik** sağlayan bir yönetişim framework'üdür.
+
+Bu rehberi tamamladığınızda:
+- Framework'ü projenize kurmuş olacaksınız
+- Temel yapılandırmayı yapmış olacaksınız
+- İlk görevinizi oluşturmuş ve ajanlarla çalışmaya başlamış olacaksınız
+
+---
+
+## 2. Ön Gereksinimler
+
+- **Node.js** 20+ (LTS önerilir)
+- **npm** 9+
+- **Git** (proje klasöründe başlatılmış olmalı)
+
+Kontrol etmek için:
+
+```bash
+node --version
+npm --version
+git --version
+```
+
+---
+
+## 3. Adım Adım Kurulum
+
+### Adım 1: Yeni Proje Klasörü Oluştur
+
+```bash
+mkdir my-new-project
+cd my-new-project
+git init
+```
+
+### Adım 2: Framework'ü Başlat
+
+Temel framework yapısını temiz bir şekilde kurmak için (kurulumdan önce herhangi bir yapay zeka veya adaptör adı hardcode edilmeden):
+
+```bash
+npx agent-enderun init
+```
+
+Bu komut:
+- Varsayılan olarak `.enderun/` klasörünü oluşturur
+- Tüm yönetişim dosyalarını (`ENDERUN.md`, `PROJECT_MEMORY.md`, ajanlar, knowledge vb.) kurar
+- Temel framework yapısını projenize ekler
+
+#### 💡 İsteğe Bağlı: Özel Bir Adaptör ile Kurulum
+Eğer belirli bir yapay zeka asistan ortamını veya adaptörünü (örneğin Antigravity, Claude, Cursor, Codex, Gemini) yapılandırmak istiyorsanız, bunu parametre olarak belirtebilirsiniz:
+
+```bash
+npx agent-enderun init antigravity
+# veya
+npx agent-enderun init claude
+# veya
+npx agent-enderun init cursor
+# veya
+npx agent-enderun init codex
+# veya
+npx agent-enderun init gemini
+```
+
+- Eğer `init antigravity` çalıştırırsanız, `.enderun/` yerine `.antigravitycli/` klasörünü oluşturur ve proje köküne `antigravity.md` ekler.
+- Eğer `init claude` çalıştırırsanız, `.enderun/` yerine `.claude/` klasörünü oluşturur ve Claude Desktop MCP ayarlarını otomatik yapılandırır.
+- Eğer `init cursor` çalıştırırsanız, `.cursor/` klasörünü oluşturur ve cursor kurallarını kopyalar.
+- Eğer `init gemini` çalıştırırsanız, `.enderun/` yerine `.gemini/` klasörünü oluşturur ve proje köküne `gemini.md` ekler.
+
+---
+
+### Adım 3: Bağımlılıkları Yükle ve Derle
+
+```bash
+npm install
+npm run enderun:build
+```
+
+### Adım 4: Kurulumu Doğrula
+
+```bash
+npx agent-enderun check
+```
+
+Beklenen çıktı:
+
+```
+✅ Framework active (v0.6.5)
+✅ MCP Server ready
+✅ Shared types compiled
+✅ Agent logs initialized
+✅ PROJECT_MEMORY.md found
+```
+
+---
+
+## 4. Temel Yapılandırma (En Kritik Adım)
+
+Framework kurulduktan sonra **mutlaka** aşağıdaki dosyaları doldurmalısınız.
+
+### 4.1 `docs/tech-stack.md`
+
+Bu dosya **zorunludur**. Ajanlar projenizin hangi teknolojileri kullandığını buradan öğrenir.
+
+Örnek doldurma:
+
+```markdown
+# TECH STACK
+
+## Platform
+- Web (React + Vite)
+- Backend (Node.js + Fastify)
+
+## Database
+- PostgreSQL + Kysely
+
+## Auth
+- JWT + Refresh Token
+
+## Deployment
+- Vercel (Frontend) + Railway (Backend)
+```
+
+> **Uyarı:** Bu dosya boş bırakılırsa ajanlar çalışamaz.
+
+### 4.2 `docs/project-docs.md`
+
+Projenizin amacını, hedef kitlesini ve ana gereksinimleri buraya yazın.
+
+### 4.3 `.enderun/PROJECT_MEMORY.md`
+
+İlk kurulumda otomatik oluşturulur. İçeriğini inceleyin. *(Not: Özel bir adaptör ile kurulum yaptıysanız bu dosya o adaptörün klasöründe olacaktır, örn. `.antigravitycli/PROJECT_MEMORY.md`)*
+
+---
+
+## 5. İlk Görev Oluşturma
+
+Artık ilk gerçek görevinizi oluşturabilirsiniz:
+
+```bash
+npx agent-enderun trace:new "User Registration and Login System" backend P1
+```
+
+Bu komut:
+- Yeni bir Trace ID üretir
+- `PROJECT_MEMORY.md` içindeki **ACTIVE TASKS** bölümünü günceller
+- @manager ajanını göreve atar
+
+---
+
+## 6. Ajanlarla Çalışma Temelleri
+
+### Otomatik @manager Davranışı
+
+Her yeni oturumda (sohbet başladığında) ajanlar otomatik olarak:
+
+1. `ENDERUN.md` dosyasını okur
+2. `PROJECT_MEMORY.md` dosyasını okur
+3. Aktif fazı ve görevi öğrenir
+
+### Ajanlara Nasıl Yönlendirilir?
+
+- Normalde **@manager** her şeyi yönetir.
+- İsterseniz doğrudan bir uzmana hitap edebilirsiniz:
+
+```markdown
+@backend Implement the user model and auth services using Kysely.
+```
+
+### Önemli Kurallar
+
+- Her zaman `docs/tech-stack.md` dosyasını güncel tutun.
+- Yeni kararlar aldığınızda `PROJECT_MEMORY.md` içindeki **CRITICAL DECISIONS** bölümünü güncelleyin.
+- Her görev için Trace ID kullanın.
+
+---
+
+## 7. İlk Gerçek Senaryo Örneği
+
+Aşağıdaki akışı deneyebilirsiniz:
+
+1. `docs/tech-stack.md` dosyasını doldurun
+2. `docs/project-docs.md` içine basit bir gereksinim yazın
+3. Şu komutu çalıştırın:
+
+```bash
+npx agent-enderun trace:new "User Registration and Login" backend P1
+```
+
+4. Sonra şunu yazın:
+
+> @manager Lütfen bu gereksinimi analiz et ve gerekli backend yapısını öner.
+
+Ajanlar otomatik olarak:
+- Kod analizi yapacak
+- Kontrat önerecek
+- Gerekirse blueprint kullanacak
+
+---
+
+## 8. Sık Yapılan Hatalar ve İpuçları
+
+| Hata | Sonuç | Çözüm |
+| :--- | :--- | :--- |
+| `docs/tech-stack.md` dosyasını boş bırakmak | Ajanlar ne yapacağını bilemez | Mutlaka doldurun |
+| Doğrudan kod yazdırmak | Düzensiz ve denetimsiz kod | Önce @manager ile plan yaptırın |
+| Trace ID kullanmamak | İşler karışır | Her yeni özellik için `trace:new` kullanın |
+| PROJECT_MEMORY.md'yi güncellememek | Ajanlar eski durumu hatırlar | Yeni kararları mutlaka yazın |
+
+---
+
+## 9. Sonraki Adımlar
+
+Rehberi tamamladıktan sonra şu konuları inceleyin:
+
+- **Contract-First Geliştirme** → `apps/backend/src/types` yapısını inceleyin
+- **Blueprint Kullanımı** → `.enderun/blueprints/` klasörüne bakın
+- **Güvenlik ve Denetim** → `npx agent-enderun check:security`
+- **Ajanlar Arası İletişim** → Hermes protokolü (`messages/` klasörü)
+
+---
+
+## 10. Yardım ve Destek
+
+Sorun yaşarsanız:
+
+1. `npx agent-enderun status` komutunu çalıştırın
+2. `PROJECT_MEMORY.md` dosyasını kontrol edin
+3. Hata mesajlarını ve son 3 HISTORY girdisini inceleyin
+
+---
+
+**Tebrikler!** Artık Agent Enderun ile disiplinli ve yönetilebilir bir şekilde yazılım geliştirmeye başlayabilirsiniz.
+
+Bir sonraki adım olarak **ilk gerçek projenizin temel kontratlarını** tanımlamayı öneririz.

package/docs/roadmap.md

@@ -0,0 +1,200 @@
+# Agent Enderun — Development Roadmap (v0.6.5+) / Geliştirme Yol Haritası
+
+**Last Updated / Son Güncelleme:** 23 May 2026 / 23 Mayıs 2026  
+**Owner / Sorumlu:** @manager
+
+[English](#english) | [Türkçe](#türkçe)
+
+---
+
+# English
+
+This document outlines the development roadmap for the Agent Enderun framework **v0.6.5 and beyond**. All items are prioritized logically based on actual project needs and corporate governance principles.
+
+## Current Status (23 May 2026)
+
+- **Version:** v0.6.5 (ready for npm release)
+- **System Health:** 🟢 GREEN
+- **Key Accomplishments:**
+  - Full support for the Antigravity adapter (primary recommended adapter)
+  - Gemini adapter completely removed
+  - Lint technical debt resolved (reduced from 43 to 0 issues)
+  - Published `docs/getting-started.md` guide
+  - Updated memory structures and workspace hygiene
+
+- **Active Challenge:** Memory and task tracking need reinforcement (ACTIVE TASKS section is empty)
+
+---
+
+## Agent Maturity & Professionalization Program (Highest Strategic Initiative)
+
+To make Agent Enderun truly production-grade for enterprise use, agents must be professionalized to meet the standards of senior software engineers.
+
+This program systematically audits current agent maturity levels and runs structured improvements to elevate each agent to enterprise readiness.
+
+### Agent Maturity Targets
+
+| Agent Persona | Current Level | Target Level | Priority / Risk Status |
+| :--- | :--- | :--- | :--- |
+| **@manager** | 8.0 | 9.5 | High / Stable. Leadership and project management capabilities are excellent. |
+| **@backend** | 7.5 | 9.0 | High / Stable. Deeply understands Kysely and Fastify patterns; testing discipline needs reinforcement. |
+| **@frontend** | 6.5 | 9.0 | **Critical / High Risk**. Needs major reinforcement in component slots, composition patterns, WCAG 2.2 accessibility, and performance engineering. |
+| **@explorer** | 6.5 | 8.5 | High / Stable. Highly capable in dependency analysis and codebase intelligence. |
+| **@analyst** | 6.5 | 8.5 | Medium / Stable. Handles system health metrics and compliance audits. |
+| **@git** | 6.0 | 8.0 | Medium / Stable. Coordinates PRs, semantic commits, and version compliance. |
+| **@mobile & @native** | 2.0 | 7.5 | Low / Draft state. Currently stubbed and requires dedicated maturity runs. |
+
+> **Note:** `@frontend` is currently the highest risk to enterprise onboarding and is the top priority.
+
+---
+
+## Roadmap Overview
+
+| Phase | Timeline | Focus | Priority |
+| :--- | :--- | :--- | :--- |
+| **Agent Maturity Program** | 1–4 Months | Elevate all agents to professional enterprise-grade | **Highest** |
+| **Phase 1** | 1–6 Weeks | Usability, automated configurations, and CLI tooling | High |
+| **Phase 2** | 1–3 Months | Hermes messaging stability & multi-agent intelligence | High |
+| **Phase 3** | 3+ Months | Scalability, performance benchmarks, and Reference Application | Medium |
+
+---
+
+## Agent Maturity Program — Phase 1 (Weeks 1–8)
+
+### 1. Professionalize @frontend Agent (Critical)
+- Component Architecture (Compound Components, Slots, Composition Patterns)
+- Accessibility (WCAG 2.2 AA compliance standards)
+- Performance Engineering (Core Web Vitals, virtualization, code splitting)
+- Testing Strategy (Hook + Component + Integration testing)
+- Error Boundaries & Resilience
+- Design System Governance
+
+### 2. Reinforce @backend Agent
+- Production Testing Culture (Unit + Integration + Contract + E2E)
+- Observability (Structured Logging + Metrics + Tracing)
+- Resilience Patterns (Idempotency, Retry, Circuit Breaker)
+- Query Optimization and Caching Strategy
+
+### 3. Elevate @manager Leadership
+- Technical Debt Auditing & Escalation Register
+- Risk Assessment Framework
+- Capacity Planning & Sustainable Delivery
+- Architecture Decision Records (ADR) Discipline
+
+---
+
+## Phase 1 — Short-Term (Weeks 1–6)
+
+### 1. Fully Automate Claude Configuration
+- **Description:** Remove the manual `claude config add` step after running `init claude`. Automatically patch the Claude Desktop configuration file.
+- **Complexity:** Medium
+- **Status:** Pending
+
+### 2. Frontend Blueprint System
+- **Description:** Carry the blueprint generator power of the backend over to the frontend. Establish structured React components, pages, and UI pattern blueprints.
+- **Complexity:** Medium-High
+- **Status:** Pending
+
+### 3. Expand Getting Started Documentation
+- **Description:** Enrich the new guide based on developer feedback. Add more real-world scenarios, troubleshooting tips, and best practices.
+- **Complexity:** Low-Medium
+- **Status:** In Progress (Getting started guide updated to v0.6.5)
+
+---
+
+## Phase 2 — Mid-Term (Months 1–3)
+
+### 4. Fully Implement Hermes Messaging Protocol
+- **Description:** Move inter-agent categorized, prioritized, and persistent messaging protocol from "defined on paper" to active code implementation.
+- **Complexity:** High
+- **Status:** Draft defined; implementation pending
+
+### 5. Reinforce Academy & Performance System
+- **Description:** Aggregate success metrics, failure tracking, and structured feedback for all agents to report via dashboard.
+- **Complexity:** Medium-High
+- **Status:** Basic tools available; scaling required
+
+---
+
+## Phase 3 — Long-Term (Months 3+)
+
+### 6. Production-Grade Reference Application
+- **Description:** Build a complete end-to-end reference application demonstrating normal CRUD + High-Risk Admin actions + Hermes messaging under Agent Enderun's governance.
+- **Complexity:** Very High
+- **Status:** Planned
+
+---
+
+# Türkçe
+
+Bu belge, Agent Enderun framework'ünün **v0.6.5 sonrası** geliştirme yol haritasını içerir. Tüm maddeler gerçekçi öncelik sırasına göre düzenlenmiştir.
+
+## Mevcut Durum (23 Mayıs 2026)
+
+- **Versiyon:** v0.6.5 (npm yayınına hazır)
+- **Sistem Sağlığı:** 🟢 GREEN
+- **Tamamlanan Önemli İşler:**
+  - Antigravity adapter tam desteği (birincil adapter)
+  - Gemini adapter tamamen kaldırıldı
+  - Lint teknik borcu temizlendi (43 → 0 problem)
+  - `docs/getting-started.md` rehberi yayınlandı
+  - Hafıza ve proje hijyeni güncellendi
+
+- **Aktif Sorun:** Hafıza ve görev takibi takviye edilmeli (ACTIVE TASKS bölümü boş)
+
+---
+
+## Agent Olgunluk ve Profesyonelleşme Programı (En Kritik Stratejik İnisiyatif)
+
+Agent Enderun’un kurumsal ve büyük ölçekli projelerde gerçekten kullanılabilir hale gelmesi için ajanların **kıdemli yazılım mühendisi** seviyesine çıkarılması zorunludur.
+
+Bu program, mevcut ajanların olgunluk seviyelerini analiz edip her birini sistematik şekilde profesyonel/kurumsal seviyeye taşımayı hedefler.
+
+### Ajan Olgunluk Hedefleri
+
+| Ajan Personası | Mevcut Seviye | Hedef Seviye | Öncelik / Risk Durumu |
+| :--- | :--- | :--- | :--- |
+| **@manager** | 8.0 | 9.5 | Yüksek / İstikrarlı. Yönetim yeteneği güçlüdür. |
+| **@backend** | 7.5 | 9.0 | Yüksek / Kararlı. Kysely ve Fastify kalıplarını iyi bilir, test yazımı güçlendirilmelidir. |
+| **@frontend** | 6.5 | 9.0 | **Kritik / Yüksek Risk**. Bileşen taslakları, slots, composition pattern'leri, WCAG 2.2 erişilebilirlik ve performans mühendisliğinde büyük takviye gereklidir. |
+| **@explorer** | 6.5 | 8.5 | Yüksek / Bağımlılık analizi ve kod zekasında yetkindir. |
+| **@analyst** | 6.5 | 8.5 | Orta / Sağlık metrikleri ve uygunluk denetiminde rol alır. |
+| **@git** | 6.0 | 8.0 | Orta / PR ve versiyon takibini koordine eder. |
+| **@mobile & @native** | 2.0 | 7.5 | Düşük / Taslak halinde; olgunlaşması gerekecektir. |
+
+> **Not:** `@frontend` şu anda kurumsal entegrasyonun önündeki en büyük risktir ve birinci önceliğimizdir.
+
+---
+
+## Yol Haritası Genel Bakış
+
+| Faz | Zaman Dilimi | Odak | Öncelik |
+| :--- | :--- | :--- | :--- |
+| **Agent Maturity Program** | 1–4 Ay | Tüm ajanları profesyonel kurumsal seviyeye çıkarma | **En Yüksek** |
+| **Phase 1** | 1–6 Hafta | Temel Kullanılabilirlik + Otomasyon + CLI | Yüksek |
+| **Phase 2** | 1–3 Ay | Zeka ve Hermes Protokol Olgunluğu | Yüksek |
+| **Phase 3** | 3+ Ay | Ölçeklenebilirlik ve Referans Uygulama | Orta |
+
+---
+
+## Agent Maturity Program — Phase 1 (1–8 Hafta)
+
+### 1. @frontend Ajanının Profesyonelleşmesi (Kritik)
+- Component Architecture (Compound Components, Slots, Composition Patterns)
+- Accessibility (WCAG 2.2 AA standartları)
+- Performance Engineering (Core Web Vitals, virtualization, code splitting)
+- Testing Strategy (Hook + Component + Integration test)
+- Error Boundaries & Resilience
+- Design System Governance
+
+### 2. @backend Ajanının Güçlendirilmesi
+- Profesyonel Test Kültürü (Unit + Integration + Contract + E2E)
+- Observability (Structured Logging + Metrics + Tracing)
+- Resilience Patterns (Idempotency, Retry, Circuit Breaker)
+- Query Optimization ve Caching Stratejisi
+
+### 3. @manager Ajanının Liderlik Seviyesinin Yükseltilmesi
+- Teknik Borç Yönetimi ve Kayıt Sistemi
+- Risk Değerlendirme Çerçevesi
+- Kapasite Planlaması ve Sürdürülebilir Teslimat
+- Architecture Decision Records (ADR) Disiplini

package/framework-mcp/README.md

@@ -1,4 +1,4 @@
-# AI-Enderun MCP Server (v0.3.4)
+# AI-Enderun MCP Server (v0.6.5)
 
 English | [Türkçe](#türkçe)