agent-enderun 1.0.3 → 1.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/gemini.md

@@ -19,7 +19,7 @@ At the **start of every session**, before any work:
 
 ### 💾 Memory Tiers
 - **Project Memory (Shared):** `.enderun/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 system's temporary directory memory folder for personal workflows or user-specific notes that should not be committed to Git.
+- **Private Memory (User-Specific):** Use the local `.gitignored` memory directory (e.g. `.enderun/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 `gemini.md` file contains the "Supreme Law" and coding standards.
 
 ### 🛡️ Core Mandates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "1.0.3",
+  "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.3",
+    "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",
@@ -124,15 +123,17 @@ export function remapFrameworkContent(
 ): string {
     let result = content;
 
-    // 1. Dynamic Agent Folder Mapping based on adapter
+    // 1. Dynamic Agent Folder Mapping based on adapter (Only remap if NOT in unified .enderun mode)
     let agentFolder = "agents";
     let knowledgeFolder = "knowledge";
     
-    if (adapterId === "antigravity") {
-        agentFolder = "skills";
-        knowledgeFolder = "rules";
-    } else if (adapterId === "grok") {
-        agentFolder = "plugins";
+    if (frameworkDir !== ".enderun") {
+        if (adapterId === "antigravity") {
+            agentFolder = "skills";
+            knowledgeFolder = "rules";
+        } else if (adapterId === "grok") {
+            agentFolder = "plugins";
+        }
     }
 
     // 2. Replacements

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}/`);

package/src/cli/utils/fs.ts

@@ -9,6 +9,7 @@ export function updateGitIgnore(targetPath: string, frameworkDir = ".gemini", dr
         "# AI-Enderun",
         `${frameworkDir}/logs/*.json`,
         `${frameworkDir}/*.lock`,
+        `${frameworkDir}/memory/`,
         ".env",
         ".DS_Store",
     ];