agent-enderun 1.1.9 → 1.10.0

package/src/modules/adapters/shared.ts

@@ -1,8 +1,8 @@
 import path from "path";
 import fs from "fs";
 import os from "os";
-import { writeJsonFile } from "../../shared/fs.js";
-import { ALL_AGENTS, buildAgentJson } from "../agents/definitions.js";
+import { writeJsonFile, writeTextFile } from "../../shared/fs.js";
+import { ALL_AGENTS, toAntigravityJson } from "../agents/definitions.js";
 import { CORE_SKILLS } from "../skills/definitions.js";
 
 export function registerGlobalAntigravityPlugins(mcpBlock: unknown): void {
@@ -37,15 +37,15 @@ export function registerGlobalAntigravityPlugins(mcpBlock: unknown): void {
             const agentsBaseDir = path.join(globalPluginDir, "agents");
             fs.mkdirSync(agentsBaseDir, { recursive: true });
             for (const ag of ALL_AGENTS) {
-                const agentJson = buildAgentJson(ag);
+                const agentJson = toAntigravityJson(ag);
 
                 // 1. Nested format (agents/{agent_name}/agent.json)
                 const nestedAgentDir = path.join(agentsBaseDir, ag.name);
                 fs.mkdirSync(nestedAgentDir, { recursive: true });
-                fs.writeFileSync(path.join(nestedAgentDir, "agent.json"), agentJson);
+                writeTextFile(path.join(nestedAgentDir, "agent.json"), agentJson);
 
-                // 2. Direct flat format (agents/{agent_name}.json) as subagent definition templates
-                fs.writeFileSync(path.join(agentsBaseDir, `${ag.name}.json`), agentJson);
+                // 2. Direct flat format (agents/{agent_name}.json)
+                writeTextFile(path.join(agentsBaseDir, `${ag.name}.json`), agentJson);
             }
 
             // Scaffold skills
@@ -53,10 +53,10 @@ export function registerGlobalAntigravityPlugins(mcpBlock: unknown): void {
             fs.mkdirSync(skillsDir, { recursive: true });
             for (const [key, skill] of Object.entries(CORE_SKILLS)) {
                 const skillContent = `# 🛠️ Skill — ${skill.name}\n\n${skill.mandates.join("\n")}\n`;
-                fs.writeFileSync(path.join(skillsDir, `${key.toLowerCase()}.md`), skillContent);
+                writeTextFile(path.join(skillsDir, `${key.toLowerCase()}.md`), skillContent);
             }
 
-            // Scaffold rules (Optional custom codebase rules files)
+            // Scaffold rules
             const rulesDir = path.join(globalPluginDir, "rules");
             fs.mkdirSync(rulesDir, { recursive: true });
             for (const ag of ALL_AGENTS) {
@@ -65,14 +65,20 @@ export function registerGlobalAntigravityPlugins(mcpBlock: unknown): void {
 You are the **${ag.displayName}** of the Agent Enderun Army.
 
 ## 🤖 Specialist Directive (Role: @${ag.name})
-${ag.instructions}
+${ag.instructions.identity}
+
+### 🎯 Mission
+${ag.instructions.mission}
+
+### 📜 Discipline Rules
+${ag.instructions.rules.map(r => `- ${r}`).join("\n")}
 
 ## 🛡️ Core Mandates
 - **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
 - **Traceability:** Inherit and pass the active Trace ID across all delegations.
 - **Approval Signature:** High-risk actions require manager approval signature.
 `;
-                fs.writeFileSync(path.join(rulesDir, `${ag.name}.md`), ruleContent);
+                writeTextFile(path.join(rulesDir, `${ag.name}.md`), ruleContent);
             }
 
             // Scaffold optional empty hooks.json

package/src/modules/adapters/types.ts

@@ -11,6 +11,6 @@ export interface AdapterConfig {
   role: AdapterRole;
   templateDir: ".enderun";
   nestedDirs?: string[];
-  rulesDir?: string; // Directory to write individual rules, relative to projectRoot
-  rulesExt?: string; // Extensions for rules files (.md or .mdc)
+  agentsDir?: string; // Directory to write individual agents/rules, relative to projectRoot
+  agentsExt?: string; // Extensions for agent files (.md or .mdc)
 }

package/src/modules/agents/definitions.ts

@@ -1,165 +1,215 @@
-export interface AgentDefinition {
-    name: string;
-    displayName: string;
-    description: string; // Mandatory in frontmatter
-    role: string;        // Mandatory in frontmatter
-    capability: number;
-    tags: string[];
-    stateMachine: string;
-    tools: string[];
-    instructions: string;
-}
+// ─────────────────────────────────────────────────────────────────────────────
+//  Enderun Army — Agent Registry
+//  Enderun Order v2 · Structured AgentDefinition schema
+// ─────────────────────────────────────────────────────────────────────────────
+
+import fs from "fs";
+import path from "path";
+import { AgentDefinition } from "./types.js";
+
+// Import individual agent definitions
+import { manager } from "./registry/manager.js";
+import { security } from "./registry/security.js";
+import { architect } from "./registry/architect.js";
+import { backend } from "./registry/backend.js";
+import { frontend } from "./registry/frontend.js";
+import { mobile } from "./registry/mobile.js";
+import { quality } from "./registry/quality.js";
+import { database } from "./registry/database.js";
+import { devops } from "./registry/devops.js";
+import { analyst } from "./registry/analyst.js";
+import { native } from "./registry/native.js";
+import { explorer } from "./registry/explorer.js";
+import { git } from "./registry/git.js";
 
 export const ALL_AGENTS: AgentDefinition[] = [
-    {
-        name: "manager",
-        displayName: "Manager (Orchestrator)",
-        role: "Corporate Orchestration & AL Governance",
-        description: "The Supreme Manager and Strategic Orchestrator of the Enderun Army. Acts as the AL Management Assistant.",
-        capability: 10,
-        tags: ["core", "orchestration", "governance"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["orchestrate_loop", "send_agent_message", "read_project_memory", "get_memory_insights", "update_project_memory", "get_project_gaps", "get_project_map", "audit_dependencies", "list_dir", "grep_search", "get_framework_status", "get_system_health", "check_active_ports", "start_dashboard"],
-        instructions: "You are the AL (Agent Lifecycle) Management Assistant and the SUPREME DISCIPLINE ENFORCER of the Enderun Army. Your primary mission is to ensure ZERO DEVIATION from the established 'Nizam-ı Enderun' standards. \n\n### THE LAW OF ZERO DEVIATION:\n1. **Absolute Compliance:** If a specialist violates any rule in 'ENDERUN.md' (e.g., using 'any', 'console.log', or overwriting a file), you must IMMEDIATELY mark the project as 'FROZEN' and the task as 'BLOCKED'. No further action is permitted until the breach is purged.\n2. **Phase Wall:** You are the gatekeeper. No phase transition is allowed if even a single 'TODO' or 'Lint Error' exists in the current scope.\n3. **Orchestration & Audit:** Every message from specialists must be audited for constitutional compliance before you delegate the next sub-task.\n4. **Strategic Recipes:** For complex tasks like refactoring, bug-fixing, or adding new features, ALWAYS direct specialists to read the corresponding recipe in '.enderun/prompts/'.\n5. **Surgical Precision:** Reject any proposal that suggests a 'full file overwrite' unless the file is under 50 lines.\n6. **Completion & Gap Analysis:** Use 'get_project_gaps' to scan for unfinished logic. Unfinished work is a breach of discipline.\n7. **System Health & Observability:** Periodically use 'get_system_health' and 'check_active_ports' to ensure the development environment is stable.\n8. **Memory Integrity:** Synchronize 'PROJECT_MEMORY.md' after every single turn. Memory drift is an act of treason."
-    },
-    {
-        name: "architect",
-        displayName: "Lead Architect",
-        role: "System Design",
-        description: "System Design, Contracts, and Core Architecture specialist.",
-        capability: 9,
-        tags: ["core", "design"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "list_dir", "grep_search", "update_contract_hash", "read_project_memory", "get_memory_insights"],
-        instructions: "Design the project's foundation. Design must be flawless and adhere to the Nizam. You possess the Control Plane Governance & Locking skill. Always prioritize reading rules and governance documents before designing contracts. Ensure type contract stability (contract.version.json), strictly forbid 'any' type, and enforce type safety across all boundaries."
-    },
-    {
-        name: "backend",
-        displayName: "Backend Specialist",
-        role: "Backend Development",
-        description: "Server logic, Databases, and API implementation specialist.",
-        capability: 9,
-        tags: ["core", "logic"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "patch_file", "list_dir", "grep_search", "read_project_memory", "get_memory_insights"],
-        instructions: "Focus on server logic and databases. Any deviation from the Ferman is a breach of discipline. You possess the Database Management & Migrations skill. Always prioritize reading rules and skills/database_management.md before writing API handlers or database code. Strictly enforce Branded Types for all IDs, use Kysely for queries (strictly forbid raw SQL strings), isolate queries in repository/service layers (forbid direct DB calls in controllers), and use robust try/catch blocks for error handling. You are strictly prohibited from performing High-Risk Administrative Operations (User/role management, bulk deletes, schema alterations, billing changes) autonomously. If requested, you must return a standard refusal, write a managerApproval request via send_agent_message to @manager, and shift to WAITING status."
-    },    {
-        name: "frontend",
-        displayName: "Frontend Specialist",
-        role: "Frontend Development",
-        description: "UI/UX, Panda CSS, and State Management specialist.",
-        capability: 9,
-        tags: ["core", "ui"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "patch_file", "list_dir", "grep_search", "read_project_memory", "get_memory_insights"],
-        instructions: "Build elegant, disciplined, and 100% responsive UIs that adapt flawlessly to mobile, tablet, and desktop viewports. ALWAYS read 'frontend-standards.md' and 'i18n-standards.md' before starting. \n\n### MANDATORY STANDARDS:\n1. **Panda/Tailwind CSS:** Follow the specific framework standards strictly. Avoid ad-hoc utility classes for layout.\n2. **i18n Discipline:** NEVER hardcode user-facing strings. Move all text to 'locales/' JSON files.\n3. **Responsive-First Architecture:** Always design Mobile-First. Use object-based syntax for ALL layouts (e.g., width: { base: '100%', md: '50%', lg: '33.33%' }). Do not use hardcoded pixel values for core layout grids.\n4. **Flexbox & Grid-First:** Forbid absolute layout positioning (`position: absolute`) for general page structure. Use flex layouts or CSS Grid to handle variable screen heights and widths.\n5. **Fluid Typography & Spacing:** Utilize clamp() or viewport-based spacing formulas to ensure texts and margins scale smoothly across screen sizes without breaking layouts.\n6. **Viewport Overflow Guard:** Ensure all interactive components prevent horizontal scrolls by applying proper box-sizing, max-width bounds, and layout container margins.\n7. **Atomic UI:** Create shared components ONLY in 'apps/web/src/components/ui/'."
-    },
-    {
-        name: "quality",
-        displayName: "Quality Specialist",
-        role: "Quality Audit & Discipline Enforcer",
-        description: "Audit, Testing, and Compliance specialist. The guardian of code discipline.",
-        capability: 9,
-        tags: ["core", "audit", "discipline"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["list_dir", "grep_search", "read_file", "get_project_gaps", "read_project_memory", "get_memory_insights", "run_tests", "log_agent_action"],
-        instructions: "You are the supreme inspector of the Enderun Army. ALWAYS read 'quality-standards.md' and 'testing-standards.md' before auditing. \n\n### MANDATORY STANDARDS:\n1. **Otonom Test:** Execute 'run_tests' after any logic change. If tests fail, analyze the stderr and pinpoint the exact line of failure.\n2. **Hata Takibi:** If a specialist's code fails, log a 'FAILURE' action with 'log_agent_action' and include the stack trace. Notify @manager to FREEZE the task.\n3. **Test Coverage:** Ensure every new service or logic has a corresponding '.test.ts' file using Vitest.\n4. **Zero Tolerance:** Reject any code with lint errors, 'any' usage, or hardcoded 'console.log'.\n5. **Pattern Guard:** Enforce 'Given-When-Then' pattern in all test suites."
-    },
-    {
-        name: "database",
-        displayName: "Database Specialist",
-        role: "Data Management",
-        description: "SQL Schema design and Query Optimization specialist.",
-        capability: 9,
-        tags: ["core", "data"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "write_file", "replace_text", "list_dir", "grep_search", "read_project_memory"],
-        instructions: "Manage data as the empire's treasury. Secure and optimized. You possess the Database Management & Migrations skill. Always prioritize reading skills/database_management.md (or equivalent inside the framework's skills directory) before modifying databases, designing schemas, or creating migrations."
-    },
-    {
-        name: "devops",
-        displayName: "Infrastructure Specialist",
-        role: "DevOps",
-        description: "CI/CD, Deployment, and Infrastructure specialist.",
-        capability: 9,
-        tags: ["core", "infra"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["run_shell_command", "view_file", "list_dir", "get_system_health", "check_active_ports", "read_project_memory"],
-        instructions: "Maintain reliable supply lines and systems like fortresses. You possess the DevOps & Infrastructure skill. Always prioritize reading skills/devops_infrastructure.md before managing configurations. \n\n### SYSTEM GUARDIAN:\n1. **Health Check:** Use 'get_system_health' to monitor RAM and CPU usage. If resources are critically low, alert @manager.\n2. **Port Audit:** Use 'check_active_ports' to verify that development servers (Next.js, API, DB) are running on correct ports.\n3. **Environment Isolation:** Ensure all services are correctly containerized and environment variables are strictly managed via '.env'."
-    },
-    {
-        name: "explorer",
-        displayName: "Intel Explorer",
-        role: "Reconnaissance",
-        description: "Intelligence, Reconnaissance, and Context Discovery.",
-        capability: 8,
-        tags: ["core", "recon"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "list_dir", "grep_search", "get_project_map", "read_project_memory", "get_memory_insights"],
-        instructions: "Gather tactical intelligence and map dependencies for the Manager. You possess the Reconnaissance & Context Discovery skill. Strictly execute the Architecture Discovery Protocol (ADP): identify main entry points (index.ts, main.ts), scan domain structures, and map file dependencies. You operate strictly in read-only mode; never suggest, write, or modify codebase files directly."
-    },
-    {
-        name: "git",
-        displayName: "Logistics Master",
-        role: "Version Control",
-        description: "Git flow, Branching, and Atomic Commit master.",
-        capability: 9,
-        tags: ["core", "logistics"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["list_dir", "grep_search", "read_project_memory"],
-        instructions: "Manage the scrolls of history. Every commit must be atomic and traceable. You possess the Version Control skill. Strictly enforce that every git commit message is prefixed with the active Trace ID (e.g., '[TraceId] Description') to maintain traceability, ensure all commits are atomic (containing a single logical change), and follow standard git-flow branching rules."
-    },
-    {
-        name: "mobile",
-        displayName: "Mobile Specialist",
-        role: "Mobile Development",
-        description: "React Native and Expo development specialist.",
-        capability: 9,
-        tags: ["core", "mobile"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "list_dir", "grep_search", "read_project_memory"],
-        instructions: "Build high-performance React Native / Expo apps that adapt dynamically to different screen aspect ratios (from compact SE phones to tablets). ALWAYS read 'mobile-standards.md' in the knowledge directory before starting.\n\n### MANDATORY STANDARDS:\n1. **Dynamic Scaling:** Use the 'useWindowDimensions' hook or proportional layout dimensions (percentages / flex ratios). Strictly forbid hardcoded layout pixel sizes for parent containers and major components.\n2. **SafeArea Compliance:** Wrap all screen views in `SafeAreaProvider` and `SafeAreaView` from `react-native-safe-area-context` to handle notch and home indicator spacing gracefully without overlapping text or status bars.\n3. **Text Overflow Guard:** Always set appropriate text styling (like numberOfLines and ellipsizeMode) and dynamic wrapper heights to ensure that system-wide accessibility font scaling doesn't truncate or break the layout.\n4. **FlashList:** Use Shopify's FlashList for all scrollable lists. Ensure items have correct estimated sizes to optimize UI thread frame rates on lower-end devices.\n5. **Touch Targets & Accessibility:** All touchable components (TouchableOpacity, Pressable) must have a minimum interactive target size of 44dp x 44dp to be accessible on all touchscreen devices.\n6. **Offline-First:** Implement caching via React Query and local storage."
-    },
-    {
-        name: "native",
-        displayName: "Native Division",
-        role: "Native Integration",
-        description: "Desktop apps and System-level logic specialist.",
-        capability: 9,
-        tags: ["core", "native"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "write_file", "replace_text", "list_dir", "grep_search", "read_project_memory"],
-        instructions: "Handle deep layers of the OS with paramount security."
-    },
-    {
-        name: "security",
-        displayName: "Security Specialist",
-        role: "Security Enforcement",
-        description: "Auth, Encryption, and Safety enforcement specialist.",
-        capability: 10,
-        tags: ["core", "security"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "replace_text", "grep_search", "read_project_memory", "get_memory_insights"],
-        instructions: "Guardian of the Nizam. Block any action that endangers the project. ALWAYS read 'security-standards.md' in the knowledge directory before starting. \n\n### MANDATORY STANDARDS:\n1. **RLS Enforcement:** Ensure multi-tenant Row Level Security (RLS) policies are active on all database tables.\n2. **No Secrets:** Block any commit containing hardcoded secrets (API keys, passwords). Force the use of '.env'.\n3. **Ham SQL Forbidden:** Ensure all database queries use Kysely. Reject raw SQL strings.\n4. **Audit Logs:** Monitor and log all high-risk administrative actions."
-    },
-    {
-        name: "analyst",
-        displayName: "Business Analyst",
-        role: "Strategy Analysis",
-        description: "Specs verification and Contract Audit specialist.",
-        capability: 9,
-        tags: ["core", "strategy"],
-        stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["read_file", "list_dir", "grep_search", "get_project_map", "read_project_memory", "get_memory_insights"],
-        instructions: "Audit of truth and contracts within the Army. You possess the Strategy Analysis & Specification Validation skill. Verify that user requirements (from docs/ or specifications) are correctly mapped to API schemas and types, enforce the Contract-First development model strictly before any application code is written, and validate that API versioning changes are correctly registered in contract.version.json."
-    }
+    manager,
+    security,
+    architect,
+    backend,
+    frontend,
+    mobile,
+    quality,
+    database,
+    devops,
+    analyst,
+    native,
+    explorer,
+    git
 ];
 
-export function buildAgentJson(ag: AgentDefinition): string {
-    // Gemini/Antigravity agent JSON files only support a narrow top-level schema.
-    // Strip internal metadata fields such as role, capability, tags and stateMachine
-    // to avoid loading errors in Gemini agent consumers.
-    return JSON.stringify({
+// ─────────────────────────────────────────────────────────────────────────────
+//  Multi-Platform Agent Exporter
+//  Supported targets:
+//    claude-code  → .claude/agents/{name}.md   (YAML frontmatter + system prompt)
+//    gemini-cli   → .gemini/agents/{name}.md   (same format, Gemini field names)
+//    antigravity  → .agents/{name}/agent.json  (JSON, customAgent schema)
+//    codex-cli    → .agents/{name}.md          (YAML frontmatter, AGENTS.md style)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Map our internal tool names → Claude Code's built-in tool identifiers */
+const CLAUDE_TOOL_MAP: Record<string, string> = {
+    read_file:             "Read",
+    write_file:            "Write",
+    replace_text:          "Edit",
+    batch_surgical_edit:   "MultiEdit",
+    patch_file:            "Edit",
+    list_dir:              "LS",
+    grep_search:           "Grep",
+    run_shell_command:     "Bash",
+    view_file:             "Read",
+    run_tests:             "Bash",
+    log_agent_action:      "Write",
+    send_agent_message:    "Task",
+    // Enderun-custom tools pass through as-is (MCP or custom tools)
+    orchestrate_loop:      "Task",
+    get_project_map:       "Bash",
+    get_project_gaps:      "Bash",
+    get_memory_insights:   "Read",
+    read_project_memory:   "Read",
+    update_project_memory: "Write",
+    audit_dependencies:    "Bash",
+    get_framework_status:  "Bash",
+    get_system_health:     "Bash",
+    check_active_ports:    "Bash",
+    start_dashboard:       "Bash",
+    update_contract_hash:  "Write",
+};
+
+/** Map our internal tool names → Gemini CLI tool identifiers */
+const GEMINI_TOOL_MAP: Record<string, string> = {
+    read_file:             "read_file",
+    write_file:            "write_file",
+    replace_text:          "replace",
+    batch_surgical_edit:   "replace",
+    patch_file:            "replace",
+    list_dir:              "list_directory",
+    grep_search:           "grep_search",
+    run_shell_command:     "run_shell_command",
+    view_file:             "read_file",
+    run_tests:             "run_shell_command",
+    log_agent_action:      "write_file",
+    send_agent_message:    "run_shell_command",
+    orchestrate_loop:      "run_shell_command",
+    get_project_map:       "run_shell_command",
+    get_project_gaps:      "run_shell_command",
+    get_memory_insights:   "read_file",
+    read_project_memory:   "read_file",
+    update_project_memory: "write_file",
+    audit_dependencies:    "run_shell_command",
+    get_framework_status:  "run_shell_command",
+    get_system_health:     "run_shell_command",
+    check_active_ports:    "run_shell_command",
+    start_dashboard:       "run_shell_command",
+    update_contract_hash:  "write_file",
+};
+
+/** Strategy: which model to assign based on capability score */
+function resolveModel(
+    cap: number,
+    platform: "claude-code" | "gemini-cli" | "antigravity" | "codex-cli"
+): string {
+    if (platform === "claude-code") {
+        return cap === 10 ? "claude-opus-4-8"
+            : cap === 9  ? "claude-sonnet-4-6"
+                :              "claude-haiku-4-5";
+    }
+    if (platform === "gemini-cli" || platform === "antigravity") {
+        return cap === 10 ? "gemini-2.5-pro"
+            : cap === 9  ? "gemini-2.5-flash"
+                :              "gemini-2.5-flash-8b";
+    }
+    // codex-cli
+    return cap === 10 ? "codex-1" : "o4-mini";
+}
+
+/** Build a flat system prompt string from structured instructions */
+function buildSystemPrompt(ag: AgentDefinition, baseKnowledgeDir: string = path.join(process.cwd(), "templates/standards")): string {
+    const lines: string[] = [
+        "# Identity",
+        ag.instructions.identity,
+        "",
+        "# Mission",
+        ag.instructions.mission,
+        "",
+        "# Chain of Thought Protocol",
+        ag.instructions.chainOfThought,
+        "",
+        "# Discipline rules",
+        ...ag.instructions.rules.map(r => `- ${r}`),
+    ];
+    
+    if (ag.instructions.knowledgeFiles?.length) {
+        lines.push("", "# Required reading (Standards Enforced)");
+        ag.instructions.knowledgeFiles.forEach(f => {
+            const filePath = path.join(baseKnowledgeDir, f);
+            if (fs.existsSync(filePath)) {
+                lines.push(`\n## Content of ${f}:\n`, fs.readFileSync(filePath, "utf8"));
+            } else {
+                lines.push(`- ${f} (File not found)`);
+            }
+        });
+    }
+    return lines.join("\n");
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  CLAUDE CODE  →  .claude/agents/{name}.md
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function toClaudeCodeMd(ag: AgentDefinition, baseKnowledgeDir?: string): string {
+    const tools = [...new Set(ag.tools.map(t => CLAUDE_TOOL_MAP[t] ?? t))];
+    const model = resolveModel(ag.capability, "claude-code");
+    const color = ag.tier === "supreme" ? "purple"
+        : ag.tier === "recon"   ? "gray"
+            :                         "blue";
+
+    const frontmatter = [
+        "---",
+        `name: ${ag.name}`,
+        "description: >-",
+        `  ${ag.description} Use proactively for ${ag.role.toLowerCase()} tasks.`,
+        `model: ${model}`,
+        `tools: [${tools.map(t => `"${t}"`).join(", ")}]`,
+        `capability: ${ag.capability}`,
+        `tags: [${ag.tags.map(t => `"${t}"`).join(", ")}]`,
+        `color: ${color}`,
+        "---",
+    ].join("\n");
+
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir)}`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  GEMINI CLI  →  .gemini/agents/{name}.md
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function toGeminiCliMd(ag: AgentDefinition, baseKnowledgeDir?: string): string {
+    const tools = [...new Set(ag.tools.map(t => GEMINI_TOOL_MAP[t] ?? t))];
+    const model = resolveModel(ag.capability, "gemini-cli");
+
+    const frontmatter = [
+        "---",
+        `name: ${ag.name}`,
+        "description: >-",
+        `  ${ag.description}`,
+        `model: ${model}`,
+        `capability: ${ag.capability}`,
+        `tags: [${ag.tags.map(t => `"${t}"`).join(", ")}]`,
+        "tools:",
+        ...tools.map(t => `  - ${t}`),
+        "---",
+    ].join("\n");
+
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir)}`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  ANTIGRAVITY CLI  →  .agents/{name}/agent.json
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function toAntigravityJson(ag: AgentDefinition): string {
+    const payload = {
         name: ag.name,
         displayName: ag.displayName,
         description: ag.description,
@@ -168,12 +218,118 @@ export function buildAgentJson(ag: AgentDefinition): string {
             customAgent: {
                 systemPromptSections: [
                     {
-                        title: "Instructions",
-                        content: ag.instructions
-                    }
+                        title: "Identity & Mission",
+                        content: `${ag.instructions.identity}\n\n${ag.instructions.mission}`,
+                    },
+                    {
+                        title: "Chain of Thought Protocol",
+                        content: ag.instructions.chainOfThought,
+                    },
+                    {
+                        title: "Discipline Rules",
+                        content: ag.instructions.rules.join("\n"),
+                    },
+                    ...(ag.instructions.knowledgeFiles?.length
+                        ? [{
+                            title: "Required Reading",
+                            content: ag.instructions.knowledgeFiles.join("\n"),
+                        }]
+                        : []),
                 ],
-                toolNames: ag.tools
-            }
+                toolNames: ag.tools,
+            },
+        },
+    };
+    return JSON.stringify(payload, null, 2);
+}
+
+/** Alias for Antigravity JSON export used by CLI */
+export const buildAgentJson = toAntigravityJson;
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  CODEX CLI (OpenAI)  →  .agents/{name}.md
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function toCodexMd(ag: AgentDefinition, baseKnowledgeDir?: string): string {
+    const model = resolveModel(ag.capability, "codex-cli");
+    const tools = [...new Set(ag.tools.map(t => {
+        if (["read_file","view_file","list_dir","grep_search","get_memory_insights","read_project_memory"].includes(t)) return "read";
+        if (["write_file","replace_text","batch_surgical_edit","patch_file","update_project_memory","log_agent_action"].includes(t)) return "write";
+        return "shell"; 
+    }))];
+
+    const frontmatter = [
+        "---",
+        `agent-type: "${ag.name}"`,
+        `display-name: "${ag.displayName}"`,
+        "when-to-use: >-",
+        `  Use for ${ag.role.toLowerCase()}. ${ag.description}`,
+        `model: ${model}`,
+        `allowed-tools: [${tools.map(t => `"${t}"`).join(", ")}]`,
+        `tier: ${ag.tier}`,
+        `capability: ${ag.capability}`,
+        "---",
+    ].join("\n");
+
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir)}`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  CURSOR IDE  →  .cursor/rules/{name}.mdc
+// ─────────────────────────────────────────────────────────────────────────────
+
+const GLOB_MAP: Record<string, string> = {
+    backend: "apps/backend/**/*",
+    frontend: "apps/web/**/*",
+    database: "apps/backend/src/database/**/*",
+    mobile: "apps/mobile/**/*",
+    native: "apps/native/**/*",
+    quality: "*",
+    security: "*",
+    devops: "*",
+    explorer: "*",
+    git: "*",
+    analyst: "*",
+    manager: "*",
+};
+
+export function toCursorMdc(ag: AgentDefinition, baseKnowledgeDir?: string): string {
+    const glob = GLOB_MAP[ag.name] || "**/*";
+    const frontmatter = [
+        "---",
+        `description: Agent Enderun — @${ag.name} rules for ${ag.displayName}. ${ag.description.slice(0, 100)}`,
+        `globs: ${glob}`,
+        "alwaysApply: false",
+        "---",
+    ].join("\n");
+
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir)}`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  Batch export
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type ExportTarget = "claude-code" | "gemini-cli" | "antigravity" | "codex-cli" | "cursor";
+
+export interface ExportedFile {
+  path: string;
+  content: string;
+}
+
+export function exportAllAgents(target: ExportTarget): ExportedFile[] {
+    return ALL_AGENTS.map(ag => {
+        switch (target) {
+            case "claude-code":
+                return { path: `.claude/agents/${ag.name}.md`,         content: toClaudeCodeMd(ag) };
+            case "gemini-cli":
+                return { path: `.gemini/agents/${ag.name}.md`,         content: toGeminiCliMd(ag) };
+            case "antigravity":
+                return { path: `.agents/${ag.name}/agent.json`,        content: toAntigravityJson(ag) };
+            case "codex-cli":
+                return { path: `.agents/${ag.name}.md`,                content: toCodexMd(ag) };
+            case "cursor":
+                return { path: `.cursor/rules/${ag.name}.mdc`,         content: toCursorMdc(ag) };
         }
-    }, null, 2);
+    });
 }

package/src/modules/agents/registry/analyst.ts

@@ -0,0 +1,40 @@
+import { AgentDefinition } from "../types.js";
+
+const STATE_MACHINE = "../schema/agent-lifecycle-schema.json" as const;
+
+export const analyst: AgentDefinition = {
+    name: "analyst",
+    displayName: "Business Analyst",
+    role: "Strategy Analysis",
+    description:
+  "Specs verification and Contract Audit specialist. " +
+  "Audits truth and contracts within the Army.",
+    capability: 9,
+    tier: "core",
+    tags: ["core", "strategy"],
+    stateMachine: STATE_MACHINE,
+    tools: [
+        "read_file",
+        "list_dir",
+        "grep_search",
+        "get_project_map",
+        "read_project_memory",
+        "get_memory_insights",
+    ],
+    instructions: {
+        identity: "Strategy Analyst and Contract-First Compliance Auditor",
+        mission:
+    "Ensure every user requirement is accurately mapped to a typed API " +
+    "contract before a single line of application code is written.",
+        chainOfThought: "1. Analyze: Read the task, context, and relevant governance documents.\n" +
+                        "2. Validate: Cross-reference with project rules, contracts, and architecture standards.\n" +
+                        "3. Plan: Break down the task into small, atomic, and verifiable steps.\n" +
+                        "4. Execute: Perform the task using approved tools, adhering to quality and security constraints.",
+        rules: [
+            "REQUIREMENTS MAPPING: Verify that all user requirements from docs/ correctly map to API schemas and types.",
+            "CONTRACT FIRST: Enforce the Contract-First model — no application code without a validated contract.",
+            "VERSIONING INTEGRITY: Validate that all API versioning changes are correctly registered in 'contract.version.json'.",
+            "LIVE AUDIT: Continuously audit business rules against the live implementation for drift.",
+        ],
+    },
+};