agent-enderun 1.0.4 → 1.0.5

package/.enderun/PROJECT_MEMORY.md

@@ -21,3 +21,11 @@
 
 - **Framework Scaffolding:** Initialized using Agent Enderun templates.
 - **Stable Release v1.0.3:** Promoted and mühürlendi with Unified Brain Architecture, conditional clean scaffolds, Grok army resolution, and 100% passing integration tests.
+- **Antigravity Cross-Compatibility Fix:** Resolved issue where custom agents were not showing up in the Antigravity CLI/IDE. Scaffolded the `.agents/agents/...` directory with 12 agent specifications and updated the `init` command to automatically scaffold it for the `gemini` adapter.
+- **Architectural Guidance:** Answered user inquiry regarding MCP agent definition structure, explaining the role of `agent.json` vs `.md` files.
+- **Framework Directory Resolution Fix:** Removed `.agents` from `FRAMEWORK_DIR_CANDIDATES` to avoid false positive directory detection when `.agents` is created solely for Antigravity/Cursor custom agent registration. Verified health check is 100% green.
+- **Automated Scaffolding Geliştirmesi:** `init` komutu güncellendi. Kurulum sırasında hem `.agents/agents/...` klasörlerinin hem de `.cursorrules` dosyasının otomatik olarak oluşturulması sağlandı, böylece hem Antigravity hem de Cursor IDE destekleri tamamen otonom ve otomatik hale getirildi.
+- **Antigravity Konfigürasyon Entegrasyonu:** `agent-settings`, `cli-settings` ve `ide-settings` kılavuzlarındaki standartlara uygun olarak `.agents/skills`, `.agents/rules`, `.agents/workflows` dizinleri, `.agents/mcp_config.json` lokal MCP tanımları ve kök dizindeki `AGENTS.md` otonom talimat dosyası oluşturuldu ve `init` akışına entegre edildi.
+- **AI Compatibility Audit:** Documented and verified active readiness for Gemini/Antigravity CLI, Cursor IDE, Claude Code/Desktop, and Grok environments.
+- **Kalite Kapısı Kontrolleri:** ESLint otomatik kod formatlama ve hizalama düzeltmeleri uygulandı, TS derleme build'i sıfır hata ile tamamlandı ve vitest birim testlerinin tümü (%100 başarı) başarıyla geçti.
+- **Monorepo Sürüm Senkronizasyonu:** Tüm monorepo paketlerinin (\`@agent-enderun/mcp\`, \`@agent-enderun/backend\`, \`@agent-enderun/web\`) sürümleri ana sürüm olan \`1.0.5\` ile senkronize edildi.

package/README.md

@@ -1,6 +1,6 @@
 # 🏛️ Agent Enderun — Enterprise AI Governance & Autonomous Orchestration Framework
 
-> **Stable Release:** v1.0.4 (Singularity - Patch 1)  
+> **Stable Release:** v1.0.5 (Universal AI Synergy)  
 > **Author:** Yusuf BEKAR  
 > **Trace ID:** `01HGT8J5E2N0W0W0W0W0W0W0W5`  
 > **System Status:** 🟢 All Systems Operational | Build Compile: Clean | Type-Safety: 100% Verified
@@ -11,7 +11,7 @@
 
 **Agent Enderun**, sıradan bir kod şablon üreteci veya basit bir AI asistanı değildir; karmaşık, ölçeklenebilir ve kurumsal (enterprise) düzeydeki yazılım projeleri için özel olarak tasarlanmış bir **Yapay Zeka Yönetişimi ve Otonom Ordu Komuta Sistemidir**.
 
-Sürüm **v1.0.4** itibarıyla sistem; kendi hafızasını yönetebilen, monorepo proje yollarını dinamik olarak haritalayan, tüm ajan seanslarını güvenli şekilde günlükleyen, farklı yapay zeka ekosistemlerini anayasal bir disiplin altında birleştiren ve **macOS & Windows çapraz platform standartlarına tam uyum sağlayan** yaşayan bir mühendislik organizmasıdır.
+Sürüm **v1.0.5** itibarıyla sistem; kendi hafızasını yönetebilen, monorepo proje yollarını dinamik olarak haritalayan, tüm ajan seanslarını güvenli şekilde günlükleyen, farklı yapay zeka ekosistemlerini anayasal bir disiplin altında birleştiren ve **macOS & Windows çapraz platform standartlarına tam uyum sağlayan** yaşayan bir mühendislik organizmasıdır.
 
 ---
 
@@ -27,6 +27,15 @@ Yapay zeka kodlama yardımcıları (Claude Code, Gemini CLI, Grok Build vb.) gel
 
 ---
 
+### 🚀 Sürüm v1.0.5 Universal AI Synergy Kararlı Sürüm Devrimsel Özellikleri
+
+1. **🛸 Antigravity Custom Agent, CLI & IDE Entegrasyonu:**
+   * `.agents/` dizini altında `skills`, `rules` ve `workflows` dizinleri ile yerel `mcp_config.json` dosyasının otonom oluşturulması sağlandı. Kök dizine global `AGENTS.md` dosyasının otomatik yazılması eklenerek Antigravity CLI (`agy`) ve IDE'sinin özel agent'ları pürüzsüz tanıması sağlandı.
+2. **🚀 Cursor IDE `.cursorrules` Desteği:**
+   * Kök dizinde `.cursorrules` dosyası otomatik oluşturularak Cursor AI asistanının (Chat & Composer) Agent Enderun anayasası ve bellek sistemlerine tam uyumlu çalışması sağlandı.
+3. **🩺 Akıllı Framework Dizin Çözümlemesi:**
+   * `.agents/` konfigürasyon dizini ile ana framework çalışma dizinlerinin (`.enderun` vb.) çakışmasını önleyen ve `check` taramasını 100% başarılı kılan dizin çözümleme düzeltmesi uygulandı.
+
 ### 🚀 Sürüm v1.0.4 Singularity Kararlı Sürüm Devrimsel Özellikleri
 
 1. **🧠 Pürüzsüz ve Klasör Kalabalığından Arındırılmış Birleşik Beyin Mimarisi (Unified Brain):**
@@ -177,7 +186,7 @@ npx agent-enderun init gemini --unified
 
 **Agent Enderun** is not a generic boilerplate generator or a simple AI wrapper; it is an elite, state-of-the-art **AI Governance and Autonomous Army Command System** designed for complex, scalable, and highly auditable enterprise software projects.
 
-As of **v1.0.4**, the system operates as a **"Living Engineering Organism"** capable of managing its own persistent memory, dynamically mapping project directory scopes, secure-logging expert agent activities, and **fully complying with cross-platform (macOS & Windows) scripting and standard setups**.
+As of **v1.0.5**, the system operates as a **"Living Engineering Organism"** capable of managing its own persistent memory, dynamically mapping project directory scopes, secure-logging expert agent activities, and **fully complying with cross-platform (macOS & Windows) scripting and standard setups**.
 
 ---
 
@@ -193,6 +202,15 @@ As AI coding assistants (Claude Code, Gemini CLI, Grok Build, etc.) become incre
 
 ---
 
+### 🚀 Key Improvements in Version v1.0.5 (Universal AI Synergy) Stable Release
+
+1. **🛸 Antigravity Custom Agent, CLI & IDE Integration:**
+   * Autonomously scaffolds `.agents/skills`, `.agents/rules`, and `.agents/workflows` directories along with local `mcp_config.json`. Generates the root `AGENTS.md` file automatically, ensuring full cross-platform compatibility and seamless custom agent discovery in the Antigravity CLI (`agy`) and IDE.
+2. **🚀 Cursor IDE `.cursorrules` Support:**
+   * Automatically scaffolds the root `.cursorrules` file to direct Cursor's AI Chat and Composer to comply fully with the Agent Enderun Constitution (`ENDERUN.md`) and persistant memory patterns.
+3. **🩺 Smart Framework Directory Resolution:**
+   * Fixed framework resolution candidates to dynamically prevent folder name collisions between the Antigravity config `.agents` and framework directories, ensuring `check` audits are 100% green.
+
 ### 🚀 Key Improvements in Version v1.0.4 Stable Release
 
 1. **🧠 Clutter-Free Unified Brain Architecture:**
@@ -338,4 +356,4 @@ npx agent-enderun init gemini --unified
 
 ---
 
-Developed with absolute discipline | Developer **Yusuf BEKAR** | Framework Version **v1.0.4**
+Developed with absolute discipline | Developer **Yusuf BEKAR** | Framework Version **v1.0.5**

package/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-enderun/mcp",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "Agent Enderun Model Context Protocol (MCP) Server",
   "type": "module",
   "scripts": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -82,7 +82,7 @@
     "zod": "^3.24.2"
   },
   "enderun": {
-    "version": "1.0.4",
+    "version": "1.0.5",
     "initializedAt": "2026-05-31T09:58:25.773Z"
   },
   "dependencies": {}

package/src/cli/adapters.ts

@@ -63,7 +63,6 @@ export const ADAPTERS: Record<AdapterId, AdapterConfig> = {
  */
 export const FRAMEWORK_DIR_CANDIDATES = [
     ".agent",
-    ".agents",
     ".gemini",
     ".claude",
     ".grok",

package/src/cli/commands/init.ts

@@ -287,6 +287,45 @@ describe("Initial Setup", () => {
         );
     }
 
+    const cursorRulesPath = path.join(targetDir, ".cursorrules");
+    if (!fs.existsSync(cursorRulesPath)) {
+        writeTextFile(
+            cursorRulesPath,
+            `# Agent Enderun — Cursor IDE Rules
+
+This is the primary entry point when using Agent Enderun within the Cursor IDE (Chat & Composer).
+
+The framework operates under a unified governance structure located in the ${frameworkDir}/ directory.
+
+### Primary Constitution
+All governance rules, agent checklists, and project memory live here:
+
+👉 **[${frameworkDir}/ENDERUN.md](${frameworkDir}/ENDERUN.md)**
+
+### 🤖 Agent Directive
+You are operating under the Agent Enderun governance framework.
+
+At the **start of every session**, before any work:
+1. **Restore Memory:** Read ${frameworkDir}/PROJECT_MEMORY.md to restore state, active Trace ID, and history.
+2. **Load Identity:** Read the relevant agent definition under ${frameworkDir}/agents/{agent}.md (default to @manager).
+3. **Internalize Knowledge:** Reference the ${frameworkDir}/knowledge/ base for architectural and coding standards.
+
+### 💾 Memory Tiers
+- **Project Memory (Shared):** ${frameworkDir}/PROJECT_MEMORY.md is the source of truth for task history, Trace IDs, and architectural decisions. **Update this at the end of every turn.**
+- **Private Memory (User-Specific):** Use the local .gitignored memory directory (e.g. ${frameworkDir}/memory/) for personal workflows or user-specific notes that should not be committed to Git. Never use the system's /tmp directory.
+- **Project Instructions:** This .cursorrules file contains the "Supreme Law" and coding standards.
+
+### 🛡️ Core Mandates
+- **Surgical Edits:** Use replace_text or patch_file via MCP for precise changes.
+- **Traceability:** Every action must inherit the active Trace ID from memory.
+- **Contract First:** No implementation without verified types.
+- **NEVER FORGET:** @manager MUST update ${frameworkDir}/PROJECT_MEMORY.md at the end of EVERY session without exception. This is a non-negotiable process integrity rule.
+
+All paths and references inside the project must comply with the Supreme Constitution located at ${frameworkDir}/ENDERUN.md`.trim() + "\n",
+            dryRun,
+        );
+    }
+
     if (!fs.existsSync(path.join(targetDir, ".git"))) {
         try {
             if (dryRun) {
@@ -308,131 +347,175 @@ describe("Initial Setup", () => {
     }
 
     // Always scaffold Antigravity (.agents/) workspace directory for cross-compatibility with agy CLI
-    if (adapter.id === "antigravity" || adapter.id === "antigravity-cli") {
+    if (adapter.id === "antigravity" || adapter.id === "antigravity-cli" || adapter.id === "gemini") {
         const agentsFrameworkDir = path.join(targetDir, ".agents");
         if (!dryRun) {
             try {
                 fs.mkdirSync(agentsFrameworkDir, { recursive: true });
                 const agentsSubdir = path.join(agentsFrameworkDir, "agents");
                 fs.mkdirSync(agentsSubdir, { recursive: true });
-            
-            // Write the 12 agent folders and agent.json files
-            const allAgents = [
-                {
-                    name: "manager",
-                    displayName: "Orchestration & Governance (Team-Lead)",
-                    description: "CTO, Lead Architect, and Orchestrator for Agent Enderun.",
-                    instructions: "You are the manager agent. Orchestrate workspace tasks, manage DAG dependency graphs, handle phase transitions, and enforce architectural standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Single Point of Authority: You are the sole entry point. No specialist acts without your briefing.\n- Traceability: Every action MUST inherit the active Trace ID.\n- Memory Discipline: MUST update PROJECT_MEMORY.md and log actions at the end of EVERY turn."
-                },
-                {
-                    name: "backend",
-                    displayName: "Domain Logic & Databases Specialist",
-                    description: "Responsible for core business logic, database migrations, security standards, API contracts, and server architecture.",
-                    instructions: "You are the backend agent. Build secure, high-performance, and consistent server architecture.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- No UI: Never implement UI or frontend logic.\n- Contract-First: Define shared contracts/branded types BEFORE any consumer code.\n- Branded Types Law: ALL IDs must use branded types (e.g., UserID). Plain strings are forbidden.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Surgical Edits: Use replace_text for all code changes."
-                },
-                {
-                    name: "frontend",
-                    displayName: "Fluid Responsive UI Specialist",
-                    description: "Builds responsive fluid user interfaces, manages styling tokens with Panda CSS, and implements state machines.",
-                    instructions: "You are the frontend agent. Build original, high-performance, and responsive user interfaces.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Responsive-First: Mobile-First (320px) is mandatory. Fixed-width is forbidden.\n- Zero UI Library Policy: No shadcn/ui, MUI, etc. Build everything with Panda CSS.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Contract-First: Use branded types from apps/backend/src/types.\n- No Native Alerts: Use integrated Toaster/Modal components."
-                },
-                {
-                    name: "quality",
-                    displayName: "Automated Testing & Quality Specialist",
-                    description: "Verifies test coverage, audits compliance with the constitution, conducts AST scanning, and verifies CI/CD status.",
-                    instructions: "You are the quality agent. Ensure no code is merged or deployed without meeting standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Final Gate: No code merges or deploys proceed without quality sign-off.\n- Verification-First: Audit lint, typecheck, contract drift, and branded types before sign-off.\n- Never Implement: Audit and assess only. Never write application features.\n- Zero Mock Policy: Integration tests must use real/service-compatible backends.\n- Coverage Gate: Reject approvals if coverage falls below >80% threshold in core."
-                },
-                {
-                    name: "database",
-                    displayName: "Database Migrations & Tuning Specialist",
-                    description: "Designs SQL schemas, manages migration scripts via Kysely, optimizes queries, indexes, and seeding logic.",
-                    instructions: "You are the database agent. Build secure, optimized, and scalable data layers.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Self-Contained DB: Every backend application MUST manage its own schema/migrations/seeds in its own src/database/ directory.\n- Contract-First: All schemas MUST be derived from branded types.\n- Kysely Standard: Use Kysely for application queries. Raw SQL is forbidden.\n- Zero Mock Policy: Realistic, contract-aware seed data only.\n- Surgical Edits: Use replace_text for all schema/migration changes."
-                },
-                {
-                    name: "devops",
-                    displayName: "Infrastructure & CI/CD Specialist",
-                    description: "Handles deployment pipelines, environment variables, system containerization, logging & telemetry integrations.",
-                    instructions: "You are the devops agent. Ensure reliable execution in every environment with strict quality gates.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Gate Approvals: NEVER deploy to production without quality gate approval.\n- No Docker Policy: Prefer native Node.js unless explicitly overridden by manager.\n- Environment Parity: Identical configs across dev/staging/prod (except secrets).\n- Secrets Security: NEVER hardcode secrets. Use environment variables.\n- Rollback First: Deployment is BLOCKED if no documented rollback plan exists."
-                },
-                {
-                    name: "explorer",
-                    displayName: "Codebase Discovery Specialist",
-                    description: "Maps code dependencies, performs project scans, identifies architectural gaps, and supports legacy onboarding.",
-                    instructions: "You are the explorer agent. Map project structure and provide deep context to other agents.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Read-Only: Never write production code. Only discover, map, and report.\n- Search-First: Always use search_codebase before reading large files.\n- Surgical Discovery: Focus on entry points and core domain logic.\n- Zero Mock Policy: Analyze real system state only.\n- Traceability: All findings must be linked to a Trace ID."
-                },
-                {
-                    name: "git",
-                    displayName: "Version Control Specialist",
-                    description: "Manages commit histories, branches, Trace ID alignment, semantic tagging, and merge conflicts.",
-                    instructions: "You are the git agent. Ensure a clean, atomic, and traceable repository history.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Trace ID Tagging: EVERY commit must include the active Trace ID in the message.\n- Atomic Integrity: Every commit must represent exactly one logical change.\n- Health-First: Never commit code that fails build or basic tests.\n- No Push: Do not run git push without explicit USER approval.\n- No Force: Never use git push --force on public branches."
-                },
-                {
-                    name: "mobile",
-                    displayName: "Mobile App Specialist",
-                    description: "Develops cross-platform mobile apps using React Native and Expo with clean component states.",
-                    instructions: "You are the mobile agent. Build high-performance, responsive mobile apps (React Native/Expo).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Zero UI Library: Same discipline as web. Build UI from scratch.\n- Contract-First: Use shared types from apps/backend/src/types.\n- Responsive-First: Mobile-First approach is mandatory.\n- Safe Area: Handle iOS/Android safe area insets on every screen.\n- Performance: Target 60 FPS."
-                },
-                {
-                    name: "native",
-                    displayName: "Native OS Integration Specialist",
-                    description: "Builds lightweight desktop wrappers and system integrations using Tauri or Electron.",
-                    instructions: "You are the native agent. Build secure, efficient desktop apps (Tauri/Electron).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Security-First: No remote code execution. Mandatory sandboxing and strict CSP.\n- Secure Storage: Use Keychain/Credential Manager for sensitive data.\n- IPC Contract: All communication between frontend and native MUST be typed.\n- Contract-First: Define IPC and data contracts before implementation.\n- Surgical Edits: Use replace_text for all code changes."
-                },
-                {
-                    name: "security",
-                    displayName: "Security & Cryptography Specialist",
-                    description: "Enforces authentication flows, CSP policies, credential rotation, RLS constraints, and cryptographic safety.",
-                    instructions: "You are the security agent. Ensure all endpoints, database connections, and authentication flows satisfy strict enterprise compliance policies.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Sandboxed Security First: Enforce Row Level Security (RLS) on all database tables.\n- Credential Rotation Policy: Credentials, keys, and tokens must never be hardcoded. Use vault/env variables.\n- CSP & CORS Strictness: Never open wildcards (*) for CORS or CSP policies.\n- Surgical Edits: Use replace_text for all security patches."
-                },
-                {
-                    name: "analyst",
-                    displayName: "Contract Verification & Business Analyst",
-                    description: "Validates business specifications, tests database contract integrity, and audits constitutional compliance.",
-                    instructions: "You are the analyst agent. Independently verify compliance with contracts and specifications between frontend, backend, and the constitution.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Independent Stance: Act as an objective verification gate.\n- Contract-First Law: Ensure contract.version.json perfectly matches types.\n- Escalation Priority: Report all contract drift to manager immediately.\n- Surgical Edits: Use replace_text for all document updates."
-                }
-            ];
 
-            for (const ag of allAgents) {
-                const agentDir = path.join(agentsSubdir, ag.name);
-                fs.mkdirSync(agentDir, { recursive: true });
-                
-                const payload = {
-                    name: ag.name,
-                    displayName: ag.displayName,
-                    description: ag.description,
-                    hidden: false,
-                    customAgentSpec: {
-                        customAgent: {
-                            systemPromptSections: [
-                                {
-                                    title: "Instructions",
-                                    content: ag.instructions
-                                }
-                            ],
-                            toolNames: [
-                                "view_file",
-                                "replace_file_content",
-                                "write_to_file",
-                                "run_command",
-                                "grep_search",
-                                "list_dir"
-                            ]
+                // Create other standard Antigravity directories for custom workspace customizations
+                fs.mkdirSync(path.join(agentsFrameworkDir, "skills"), { recursive: true });
+                fs.mkdirSync(path.join(agentsFrameworkDir, "rules"), { recursive: true });
+                fs.mkdirSync(path.join(agentsFrameworkDir, "workflows"), { recursive: true });
+
+                // Write workspace-specific MCP config
+                const mcpBlock = {
+                    mcpServers: {
+                        "agent-enderun": {
+                            command: "node",
+                            args: [path.join(targetDir, "framework-mcp/dist/index.js")],
+                            env: {
+                                "ENDERUN_PROJECT_ROOT": targetDir
+                            }
                         }
                     }
                 };
-                
                 fs.writeFileSync(
-                    path.join(agentDir, "agent.json"),
-                    JSON.stringify(payload, null, 2),
+                    path.join(agentsFrameworkDir, "mcp_config.json"),
+                    JSON.stringify(mcpBlock, null, 2),
                     "utf8"
                 );
-            }
-            console.warn(`✅ Scaffolding ${allAgents.length} Antigravity agents under .agents/agents/...`);
-        } catch (e) {
+
+                // Write AGENTS.md at the project root for prepended global rules
+                const agentsMdPath = path.join(targetDir, "AGENTS.md");
+                if (!fs.existsSync(agentsMdPath)) {
+                    fs.writeFileSync(
+                        agentsMdPath,
+                        `# Agent Enderun Workspace Instructions
+
+You are operating under the Agent Enderun AI governance and orchestration framework.
+
+### 🛡️ Critical Guidelines
+1. **Traceability First:** Every action or execution MUST inherit the active Trace ID from \`${frameworkDir}/PROJECT_MEMORY.md\`.
+2. **Surgical Operations:** Use precise file replacements or patches. NEVER rewrite entire source files unnecessarily.
+3. **Contract-First Design:** Backend models and type contracts must be locked and verified before frontend components are created.
+4. **Memory Synchronization:** All agent runs must update the project memory logs before concluding the session.
+
+All rules and constraints defined in \`${frameworkDir}/ENDERUN.md\` are strictly binding.
+`.trim() + "\n",
+                        "utf8"
+                    );
+                }
+            
+                // Write the 12 agent folders and agent.json files
+                const allAgents = [
+                    {
+                        name: "manager",
+                        displayName: "Orchestration & Governance (Team-Lead)",
+                        description: "CTO, Lead Architect, and Orchestrator for Agent Enderun.",
+                        instructions: "You are the manager agent. Orchestrate workspace tasks, manage DAG dependency graphs, handle phase transitions, and enforce architectural standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Single Point of Authority: You are the sole entry point. No specialist acts without your briefing.\n- Traceability: Every action MUST inherit the active Trace ID.\n- Memory Discipline: MUST update PROJECT_MEMORY.md and log actions at the end of EVERY turn."
+                    },
+                    {
+                        name: "backend",
+                        displayName: "Domain Logic & Databases Specialist",
+                        description: "Responsible for core business logic, database migrations, security standards, API contracts, and server architecture.",
+                        instructions: "You are the backend agent. Build secure, high-performance, and consistent server architecture.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- No UI: Never implement UI or frontend logic.\n- Contract-First: Define shared contracts/branded types BEFORE any consumer code.\n- Branded Types Law: ALL IDs must use branded types (e.g., UserID). Plain strings are forbidden.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Surgical Edits: Use replace_text for all code changes."
+                    },
+                    {
+                        name: "frontend",
+                        displayName: "Fluid Responsive UI Specialist",
+                        description: "Builds responsive fluid user interfaces, manages styling tokens with Panda CSS, and implements state machines.",
+                        instructions: "You are the frontend agent. Build original, high-performance, and responsive user interfaces.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Responsive-First: Mobile-First (320px) is mandatory. Fixed-width is forbidden.\n- Zero UI Library Policy: No shadcn/ui, MUI, etc. Build everything with Panda CSS.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Contract-First: Use branded types from apps/backend/src/types.\n- No Native Alerts: Use integrated Toaster/Modal components."
+                    },
+                    {
+                        name: "quality",
+                        displayName: "Automated Testing & Quality Specialist",
+                        description: "Verifies test coverage, audits compliance with the constitution, conducts AST scanning, and verifies CI/CD status.",
+                        instructions: "You are the quality agent. Ensure no code is merged or deployed without meeting standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Final Gate: No code merges or deploys proceed without quality sign-off.\n- Verification-First: Audit lint, typecheck, contract drift, and branded types before sign-off.\n- Never Implement: Audit and assess only. Never write application features.\n- Zero Mock Policy: Integration tests must use real/service-compatible backends.\n- Coverage Gate: Reject approvals if coverage falls below >80% threshold in core."
+                    },
+                    {
+                        name: "database",
+                        displayName: "Database Migrations & Tuning Specialist",
+                        description: "Designs SQL schemas, manages migration scripts via Kysely, optimizes queries, indexes, and seeding logic.",
+                        instructions: "You are the database agent. Build secure, optimized, and scalable data layers.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Self-Contained DB: Every backend application MUST manage its own schema/migrations/seeds in its own src/database/ directory.\n- Contract-First: All schemas MUST be derived from branded types.\n- Kysely Standard: Use Kysely for application queries. Raw SQL is forbidden.\n- Zero Mock Policy: Realistic, contract-aware seed data only.\n- Surgical Edits: Use replace_text for all schema/migration changes."
+                    },
+                    {
+                        name: "devops",
+                        displayName: "Infrastructure & CI/CD Specialist",
+                        description: "Handles deployment pipelines, environment variables, system containerization, logging & telemetry integrations.",
+                        instructions: "You are the devops agent. Ensure reliable execution in every environment with strict quality gates.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Gate Approvals: NEVER deploy to production without quality gate approval.\n- No Docker Policy: Prefer native Node.js unless explicitly overridden by manager.\n- Environment Parity: Identical configs across dev/staging/prod (except secrets).\n- Secrets Security: NEVER hardcode secrets. Use environment variables.\n- Rollback First: Deployment is BLOCKED if no documented rollback plan exists."
+                    },
+                    {
+                        name: "explorer",
+                        displayName: "Codebase Discovery Specialist",
+                        description: "Maps code dependencies, performs project scans, identifies architectural gaps, and supports legacy onboarding.",
+                        instructions: "You are the explorer agent. Map project structure and provide deep context to other agents.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Read-Only: Never write production code. Only discover, map, and report.\n- Search-First: Always use search_codebase before reading large files.\n- Surgical Discovery: Focus on entry points and core domain logic.\n- Zero Mock Policy: Analyze real system state only.\n- Traceability: All findings must be linked to a Trace ID."
+                    },
+                    {
+                        name: "git",
+                        displayName: "Version Control Specialist",
+                        description: "Manages commit histories, branches, Trace ID alignment, semantic tagging, and merge conflicts.",
+                        instructions: "You are the git agent. Ensure a clean, atomic, and traceable repository history.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Trace ID Tagging: EVERY commit must include the active Trace ID in the message.\n- Atomic Integrity: Every commit must represent exactly one logical change.\n- Health-First: Never commit code that fails build or basic tests.\n- No Push: Do not run git push without explicit USER approval.\n- No Force: Never use git push --force on public branches."
+                    },
+                    {
+                        name: "mobile",
+                        displayName: "Mobile App Specialist",
+                        description: "Develops cross-platform mobile apps using React Native and Expo with clean component states.",
+                        instructions: "You are the mobile agent. Build high-performance, responsive mobile apps (React Native/Expo).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Zero UI Library: Same discipline as web. Build UI from scratch.\n- Contract-First: Use shared types from apps/backend/src/types.\n- Responsive-First: Mobile-First approach is mandatory.\n- Safe Area: Handle iOS/Android safe area insets on every screen.\n- Performance: Target 60 FPS."
+                    },
+                    {
+                        name: "native",
+                        displayName: "Native OS Integration Specialist",
+                        description: "Builds lightweight desktop wrappers and system integrations using Tauri or Electron.",
+                        instructions: "You are the native agent. Build secure, efficient desktop apps (Tauri/Electron).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Security-First: No remote code execution. Mandatory sandboxing and strict CSP.\n- Secure Storage: Use Keychain/Credential Manager for sensitive data.\n- IPC Contract: All communication between frontend and native MUST be typed.\n- Contract-First: Define IPC and data contracts before implementation.\n- Surgical Edits: Use replace_text for all code changes."
+                    },
+                    {
+                        name: "security",
+                        displayName: "Security & Cryptography Specialist",
+                        description: "Enforces authentication flows, CSP policies, credential rotation, RLS constraints, and cryptographic safety.",
+                        instructions: "You are the security agent. Ensure all endpoints, database connections, and authentication flows satisfy strict enterprise compliance policies.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Sandboxed Security First: Enforce Row Level Security (RLS) on all database tables.\n- Credential Rotation Policy: Credentials, keys, and tokens must never be hardcoded. Use vault/env variables.\n- CSP & CORS Strictness: Never open wildcards (*) for CORS or CSP policies.\n- Surgical Edits: Use replace_text for all security patches."
+                    },
+                    {
+                        name: "analyst",
+                        displayName: "Contract Verification & Business Analyst",
+                        description: "Validates business specifications, tests database contract integrity, and audits constitutional compliance.",
+                        instructions: "You are the analyst agent. Independently verify compliance with contracts and specifications between frontend, backend, and the constitution.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Independent Stance: Act as an objective verification gate.\n- Contract-First Law: Ensure contract.version.json perfectly matches types.\n- Escalation Priority: Report all contract drift to manager immediately.\n- Surgical Edits: Use replace_text for all document updates."
+                    }
+                ];
+
+                for (const ag of allAgents) {
+                    const agentDir = path.join(agentsSubdir, ag.name);
+                    fs.mkdirSync(agentDir, { recursive: true });
+                
+                    const payload = {
+                        name: ag.name,
+                        displayName: ag.displayName,
+                        description: ag.description,
+                        hidden: false,
+                        customAgentSpec: {
+                            customAgent: {
+                                systemPromptSections: [
+                                    {
+                                        title: "Instructions",
+                                        content: ag.instructions
+                                    }
+                                ],
+                                toolNames: [
+                                    "view_file",
+                                    "replace_file_content",
+                                    "write_to_file",
+                                    "run_command",
+                                    "grep_search",
+                                    "list_dir"
+                                ]
+                            }
+                        }
+                    };
+                
+                    fs.writeFileSync(
+                        path.join(agentDir, "agent.json"),
+                        JSON.stringify(payload, null, 2),
+                        "utf8"
+                    );
+                }
+                console.warn(`✅ Scaffolding ${allAgents.length} Antigravity agents under .agents/agents/...`);
+            } catch {
             // fallback
+            }
         }
     }
-}
 
     console.warn(`\n♊ ${adapter.id.toUpperCase()}: Setup complete.`);
     console.warn(`   • Framework runtime: ${frameworkDir}/`);