@namch/agent-assistant 1.1.1 → 1.2.0

package/cli/install.js

@@ -8,6 +8,7 @@
  * - GitHub Copilot
  * - Antigravity (Gemini)
  * - Claude Code
+ * - Codex
  * 
  * Usage:
  *   npx agent-assistant install [tool]
@@ -139,6 +140,30 @@ const TOOLS = {
         assets: {
             claudeMd: path.join(ROOT, 'code-assistants', 'claude-assistant', 'CLAUDE.md'),
         }
+    },
+    codex: {
+        name: 'Codex',
+        description: 'OpenAI Codex CLI',
+        paths: {
+            home: path.join(HOME, '.codex'),
+            skills: path.join(HOME, '.codex', 'skills'),
+            commands: path.join(HOME, '.codex', 'commands'),
+            agents: path.join(HOME, '.codex', 'agents'),
+            agentAssistant: path.join(HOME, '.codex', 'skills', 'agent-assistant'),
+        },
+        replacements: {
+            '~/.{TOOL}/skills/agent-assistant/': '~/.codex/skills/agent-assistant/',
+            '{TOOL}/agent-assistant/': 'codex/skills/agent-assistant/',
+            '{TOOL}': 'codex',
+            '{HOME}': '~',
+            '~/.agent/': '~/.codex/skills/agent-assistant/'
+        },
+        assets: {
+            codexMd: path.join(ROOT, 'code-assistants', 'codex-assistant', 'CODEX.md'),
+            configToml: path.join(ROOT, 'code-assistants', 'codex-assistant', 'config.toml'),
+            agentTomlDir: path.join(ROOT, 'code-assistants', 'codex-assistant', 'agents'),
+            commandSkillsDir: path.join(ROOT, 'code-assistants', 'codex-assistant', 'skills'),
+        }
     }
 };
 
@@ -341,7 +366,7 @@ function copyWithReplace(src, dest, replacements = {}, trackProgress = true) {
         } else {
             try {
                 // Apply replacements for text files
-                const textExtensions = ['.md', '.txt', '.json', '.mdc', '.yaml', '.yml'];
+                const textExtensions = ['.md', '.txt', '.json', '.mdc', '.yaml', '.yml', '.toml'];
                 const ext = path.extname(entry.name).toLowerCase();
 
                 if (textExtensions.includes(ext)) {
@@ -974,6 +999,181 @@ function installClaude() {
     return total;
 }
 
+function mergeCodexConfig(templatePath, userConfigPath) {
+    // Read template
+    const template = fs.readFileSync(templatePath, 'utf8');
+
+    // Read existing user config or empty string
+    let userConfig = '';
+    if (fs.existsSync(userConfigPath)) {
+        userConfig = fs.readFileSync(userConfigPath, 'utf8');
+    }
+
+    // Our marker: lines between start and end markers
+    const markerStart = '# === AGENT-ASSISTANT START ===';
+    const markerEnd = '# === AGENT-ASSISTANT END ===';
+
+    // Remove old agent-assistant sections from user config
+    const startIdx = userConfig.indexOf(markerStart);
+    const endIdx = userConfig.indexOf(markerEnd);
+    if (startIdx !== -1 && endIdx !== -1) {
+        userConfig = userConfig.substring(0, startIdx).trimEnd() + '\n' +
+                    userConfig.substring(endIdx + markerEnd.length).trimStart();
+    }
+
+    // Update or add project_doc_fallback_filenames in user config
+    const docFallback = 'project_doc_fallback_filenames = ["AGENT.md", "CODEX.md", "AGENTS.md", ".agents.md"]';
+    if (userConfig.includes('project_doc_fallback_filenames')) {
+        userConfig = userConfig.replace(/project_doc_fallback_filenames\s*=\s*\[.*?\]/s, docFallback);
+    } else {
+        // Prepend before first section header or at end of top-level keys
+        const firstSection = userConfig.indexOf('\n[');
+        if (firstSection !== -1) {
+            userConfig = userConfig.substring(0, firstSection) + '\n' + docFallback + '\n' + userConfig.substring(firstSection);
+        } else {
+            userConfig = userConfig.trimEnd() + '\n' + docFallback + '\n';
+        }
+    }
+
+    // Build our managed block
+    let managedBlock = `\n${markerStart}\n`;
+    managedBlock += '# Managed by Agent Assistant — do not edit manually\n\n';
+
+    // Add [features] if not present
+    if (!userConfig.includes('[features]')) {
+        managedBlock += '[features]\nmulti_agent = true\n\n';
+    } else if (!userConfig.includes('multi_agent')) {
+        // Need to add multi_agent to existing [features]
+        userConfig = userConfig.replace('[features]', '[features]\nmulti_agent = true');
+    }
+
+    // Add agents config (always from template)
+    // Extract everything from [agents] onward in template
+    const agentsSectionMatch = template.match(/(\[agents\][\s\S]*)/);
+    if (agentsSectionMatch) {
+        managedBlock += agentsSectionMatch[1] + '\n';
+    }
+
+    managedBlock += `${markerEnd}\n`;
+
+    // Append managed block to user config
+    const finalConfig = userConfig.trimEnd() + '\n' + managedBlock;
+
+    // Write with fsync
+    const fd = fs.openSync(userConfigPath, 'w');
+    fs.writeSync(fd, finalConfig);
+    fs.fsyncSync(fd);
+    fs.closeSync(fd);
+
+    return true;
+}
+
+function installCodex() {
+    const tool = TOOLS.codex;
+    
+    // Reset and estimate progress
+    resetProgress();
+    progressState.total = estimateInstallFiles();
+    
+    console.log(`\n📦 Installing Agent Assistant for ${tool.name}...`);
+    console.log(`   Estimated files: ~${formatNumber(progressState.total)}\n`);
+
+    let total = 0;
+
+    // --- 1. INSTALL GLOBAL CONFIG (~/.codex) ---
+    ensureDir(tool.paths.home);
+
+    // 1.1 Global Config Files (AGENTS.md, CODEX.md, AGENT.md)
+    if (tool.assets.codexMd && fs.existsSync(tool.assets.codexMd)) {
+        const destFile = path.join(tool.paths.home, 'CODEX.md');
+        if (copyFileWithReplace(tool.assets.codexMd, destFile, tool.replacements)) total++;
+
+        // Codex discovers global instructions from ~/.codex/AGENTS.md.
+        const agentsDestFile = path.join(tool.paths.home, 'AGENTS.md');
+        if (copyFileWithReplace(tool.assets.codexMd, agentsDestFile, tool.replacements)) total++;
+    }
+    
+    // Copy AGENT.md as well
+    const agentMdSrc = path.join(ROOT, 'AGENT.md');
+    if (fs.existsSync(agentMdSrc)) {
+        const agentMdDest = path.join(tool.paths.home, 'AGENT.md');
+        if (copyFileWithReplace(agentMdSrc, agentMdDest, tool.replacements)) total++;
+    }
+
+    // 1.2 Codex-native TOML agent configs (~/.codex/agents/)
+    ensureDir(tool.paths.agents);
+    if (tool.assets.agentTomlDir && fs.existsSync(tool.assets.agentTomlDir)) {
+        total += copyWithReplace(tool.assets.agentTomlDir, tool.paths.agents, tool.replacements);
+        console.log(`   ✅ Installed ${fs.readdirSync(tool.assets.agentTomlDir).filter(f => f.endsWith('.toml')).length} Codex agent roles (TOML)`);
+    }
+
+    // 1.3 Merge config.toml (agents + features into user config)
+    if (tool.assets.configToml && fs.existsSync(tool.assets.configToml)) {
+        const userConfigPath = path.join(tool.paths.home, 'config.toml');
+        if (mergeCodexConfig(tool.assets.configToml, userConfigPath)) {
+            total++;
+            console.log(`   ✅ Merged agent config into ${userConfigPath}`);
+        }
+    }
+
+    // 1.4 Commands (~/.codex/commands — for backward compat)
+    ensureDir(tool.paths.commands);
+    total += copyWithReplace(path.join(ROOT, 'commands'), tool.paths.commands, tool.replacements);
+
+    // --- 2. INSTALL CORE FRAMEWORK (~/.codex/skills/agent-assistant) ---
+    if (fs.existsSync(tool.paths.agentAssistant)) {
+        fs.rmSync(tool.paths.agentAssistant, { recursive: true, force: true });
+    }
+    ensureDir(tool.paths.agentAssistant);
+
+    for (const dir of CORE_DIRS) {
+        const srcDir = path.join(ROOT, dir);
+        if (fs.existsSync(srcDir)) {
+            total += copyWithReplace(srcDir, path.join(tool.paths.agentAssistant, dir), tool.replacements);
+        }
+    }
+
+    // Copy backward compat workflows
+    const commandsSrc = path.join(ROOT, 'commands');
+    if (fs.existsSync(commandsSrc)) {
+        total += copyWithReplace(commandsSrc, path.join(tool.paths.agentAssistant, 'workflows'), tool.replacements);
+    }
+
+    // Copy root files
+    for (const file of ROOT_FILES) {
+        const srcFile = path.join(ROOT, file);
+        if (fs.existsSync(srcFile)) {
+            if (copyFileWithReplace(srcFile, path.join(tool.paths.agentAssistant, file), tool.replacements)) total++;
+        }
+    }
+
+    // --- 3. INSTALL SKILLS (~/.codex/skills) ---
+    total += copyWithReplace(path.join(ROOT, 'skills'), tool.paths.skills, tool.replacements);
+
+    // 3.1 Install Codex-specific command skills (from codex-assistant/skills/)
+    if (tool.assets.commandSkillsDir && fs.existsSync(tool.assets.commandSkillsDir)) {
+        total += copyWithReplace(tool.assets.commandSkillsDir, tool.paths.skills, tool.replacements);
+        const cmdSkillCount = fs.readdirSync(tool.assets.commandSkillsDir)
+            .filter(f => fs.statSync(path.join(tool.assets.commandSkillsDir, f)).isDirectory()).length;
+        console.log(`   ✅ Installed ${cmdSkillCount} command skills (Codex-native)`);
+    }
+
+    // Complete progress bar
+    completeProgress();
+    
+    // Print summary with verification
+    printSummary(tool.name, 'install');
+    
+    console.log(`\n   📁 Paths:`);
+    console.log(`      Home:      ${tool.paths.home}`);
+    console.log(`      Agents:    ${tool.paths.agents} (TOML configs)`);
+    console.log(`      Commands:  ${tool.paths.commands}`);
+    console.log(`      Skills:    ${tool.paths.skills}`);
+    console.log(`      Framework: ${tool.paths.agentAssistant}`);
+
+    return total;
+}
+
 // ============================================================================
 // Uninstall Functions
 // ============================================================================
@@ -1214,6 +1414,62 @@ function uninstallClaude() {
     return removed;
 }
 
+function uninstallCodex() {
+    const tool = TOOLS.codex;
+    
+    // Reset progress
+    resetProgress();
+    progressState.total = 6;
+    
+    console.log(`\n🗑️  Uninstalling Agent Assistant from ${tool.name}...`);
+    console.log(`   This will remove the framework while preserving user skills.\n`);
+
+    let removed = 0;
+
+    // 1. Remove Global Config
+    const codexMd = path.join(tool.paths.home, 'CODEX.md');
+    if (removeFile(codexMd)) {
+        removed++;
+    }
+
+    // Remove AGENTS.md (Codex primary instruction file)
+    const agentsMd = path.join(tool.paths.home, 'AGENTS.md');
+    if (removeFile(agentsMd)) {
+        removed++;
+    }
+
+    // Remove AGENT.md
+    const agentMd = path.join(tool.paths.home, 'AGENT.md');
+    if (removeFile(agentMd)) {
+        removed++;
+    }
+
+    // 2. Remove Commands
+    if (removeDir(tool.paths.commands)) {
+        removed++;
+    }
+
+    // 3. Remove Native Agents
+    if (removeDir(tool.paths.agents)) {
+        removed++;
+    }
+
+    // 4. Remove Core Framework
+    if (removeDir(tool.paths.agentAssistant)) {
+        removed++;
+    }
+
+    // Complete progress bar
+    completeProgress();
+    
+    // Print summary
+    printSummary(tool.name, 'uninstall');
+    
+    console.log(`\n   ℹ️  User skills preserved at: ${tool.paths.skills}`);
+
+    return removed;
+}
+
 // ============================================================================
 // CLI Interface
 // ============================================================================
@@ -1235,7 +1491,7 @@ function printUsage() {
 Usage: npx agent-assistant <command> [options]
 
 Commands:
-  install [tool]     Install for a specific tool (cursor, copilot, antigravity)
+  install [tool]     Install for a specific tool (cursor, copilot, antigravity, claude, codex)
   install --all      Install for all supported tools
   uninstall [tool]   Uninstall from a specific tool
   list               List supported tools and installation status
@@ -1286,6 +1542,14 @@ function listTools() {
                     details.push('CLAUDE.md');
                 }
             }
+            if (key === 'codex') {
+                if (fs.existsSync(path.join(tool.paths.home, 'AGENTS.md'))) {
+                    details.push('AGENTS.md');
+                }
+                if (fs.existsSync(path.join(tool.paths.home, 'CODEX.md'))) {
+                    details.push('CODEX.md');
+                }
+            }
             if (details.length > 0) {
                 console.log(`               ${' '.padEnd(25)} (${details.join(', ')})`);
             }
@@ -1306,10 +1570,11 @@ async function promptToolSelection() {
         console.log('  2. GitHub Copilot');
         console.log('  3. Antigravity (Gemini)');
         console.log('  4. Claude Code');
-        console.log('  5. All tools');
+        console.log('  5. Codex');
+        console.log('  6. All tools');
         console.log('  0. Cancel\n');
 
-        rl.question('Enter your choice (0-5): ', (answer) => {
+        rl.question('Enter your choice (0-6): ', (answer) => {
             rl.close();
             resolve(answer.trim());
         });
@@ -1333,16 +1598,20 @@ async function interactiveInstall() {
             installClaude();
             break;
         case '5':
+            installCodex();
+            break;
+        case '6':
             installCursor();
             installCopilot();
             installAntigravity();
             installClaude();
+            installCodex();
             break;
         case '0':
             console.log('\n❌ Installation cancelled.\n');
             break;
         default:
-            console.log('\n❌ Invalid choice. Please enter 0-5.\n');
+            console.log('\n❌ Invalid choice. Please enter 0-6.\n');
     }
 }
 
@@ -1374,6 +1643,7 @@ async function main() {
                 totalFiles += installCopilot();
                 totalFiles += installAntigravity();
                 totalFiles += installClaude();
+                totalFiles += installCodex();
                 
                 const duration = ((Date.now() - startTime) / 1000).toFixed(2);
                 console.log('\n' + '═'.repeat(60));
@@ -1389,11 +1659,13 @@ async function main() {
                 installAntigravity();
             } else if (target === 'claude' || target === 'claude-code') {
                 installClaude();
+            } else if (target === 'codex') {
+                installCodex();
             } else if (!target) {
                 await interactiveInstall();
             } else {
                 console.log(`❌ Unknown tool: ${target}`);
-                console.log('   Supported tools: cursor, copilot, antigravity, claude');
+                console.log('   Supported tools: cursor, copilot, antigravity, claude, codex');
             }
             break;
 
@@ -1404,6 +1676,7 @@ async function main() {
                 uninstallCopilot();
                 uninstallAntigravity();
                 uninstallClaude();
+                uninstallCodex();
                 
                 const duration = ((Date.now() - startTime) / 1000).toFixed(2);
                 console.log('\n' + '═'.repeat(60));
@@ -1418,8 +1691,10 @@ async function main() {
                 uninstallAntigravity();
             } else if (target === 'claude' || target === 'claude-code') {
                 uninstallClaude();
+            } else if (target === 'codex') {
+                uninstallCodex();
             } else {
-                console.log(`❌ Please specify a tool: cursor, copilot, antigravity, claude, or --all`);
+                console.log(`❌ Please specify a tool: cursor, copilot, antigravity, claude, codex, or --all`);
             }
             break;
 

package/cli/install.test.js.example

@@ -99,7 +99,7 @@ describe('CLI Installer', () => {
     describe('Input Validation', () => {
         test('should reject invalid tool names', () => {
             // Test that invalid tools are rejected
-            // const validTools = ['cursor', 'copilot', 'antigravity', 'gemini', 'claude', 'claude-code'];
+            // const validTools = ['cursor', 'copilot', 'antigravity', 'gemini', 'claude', 'claude-code', 'codex'];
             // const invalidTools = ['invalid', '../path', '', null];
             assert.ok(true, 'Test placeholder');
         });

package/code-assistants/codex-assistant/CODEX.md

@@ -0,0 +1,235 @@
+# CODEX.md — Agent Assistant Orchestrator for OpenAI Codex
+
+> ⛔ **MANDATORY BOOT SEQUENCE** — EXECUTE BEFORE ANY OTHER ACTION
+>
+> 1. **READ NOW**: `~/.codex/skills/agent-assistant/rules/CORE.md`
+> 2. **INTERNALIZE**: All 10 Laws, TIERED EXECUTION, PROHIBITIONS
+> 3. **ACTIVATE**: Orchestrator mode (delegate, NEVER implement)
+>
+> **⚠️ FAILURE TO LOAD CORE.md = PROTOCOL VIOLATION — All responses invalid until loaded**
+
+---
+
+## 🆔 IDENTITY — ABSOLUTE BINDING
+
+```
+╔═══════════════════════════════════════════════════════════════════════════════╗
+║  YOU ARE THE ORCHESTRATOR — NOT AN IMPLEMENTER                               ║
+║                                                                              ║
+║  ✅ YOU DO: Delegate, coordinate, verify, synthesize                         ║
+║  ❌ YOU NEVER: Write code, debug, test, design, or implement directly        ║
+║                                                                              ║
+║  🚨 EVERY TIME you're about to DO something → STOP → DELEGATE instead        ║
+╚═══════════════════════════════════════════════════════════════════════════════╝
+```
+
+**This is your ONLY role. There are NO exceptions. Not even for "simple" tasks.**
+
+---
+
+## 📂 PATHS (Use These Exact Paths)
+
+```
+CONFIG   = ~/.codex/config.toml
+COMMANDS = ~/.codex/skills/agent-assistant/commands/
+AGENTS   = ~/.codex/skills/agent-assistant/agents/
+SKILLS   = ~/.codex/skills/
+RULES    = ~/.codex/skills/agent-assistant/rules/
+REPORTS  = ./reports/
+```
+
+---
+
+## 🤖 CODEX MULTI-AGENT SYSTEM
+
+Codex has a **native multi-agent system** configured in `~/.codex/config.toml`.
+There are **21 specialist agents** registered, each with their own `.toml` config and full agent definition in `~/.codex/skills/agent-assistant/agents/{name}.md`.
+
+### TIER 1 — SPAWN AGENTS (Primary Method)
+
+**You MUST use Codex's native agent spawning system to delegate work.**
+
+When a workflow phase requires a specialist:
+1. Identify the required agent role from the phase definition
+2. **SPAWN** that agent using Codex's multi-agent system
+3. Provide the agent with: objective, constraints, context, and definition of done
+4. Wait for agent completion and verify exit criteria
+
+### TIER 2 — EMBODY (Fallback Only)
+
+Only if agent spawning fails or is unavailable:
+- EMBODY the specialist role by reading their full definition from `~/.codex/skills/agent-assistant/agents/{name}.md`
+- Follow their constraints, thinking protocol, and output format exactly
+
+**❌ FORBIDDEN**: Using TIER 2 when TIER 1 (native agent spawning) is available
+
+### Agent Roles Available
+
+| Agent Name | Role | Spawn When |
+|------------|------|------------|
+| `backend-engineer` | Principal Backend Architect | Server-side implementation |
+| `brainstormer` | Principal Requirements Architect | Requirements discovery, ideation |
+| `business-analyst` | Principal Business Analyst | Requirements, domain modeling |
+| `database-architect` | Principal Database Architect | Schema design, query optimization |
+| `debugger` | Principal Debug Specialist | Root cause analysis |
+| `designer` | Principal Design Architect | UI/UX design, design systems |
+| `devops-engineer` | Principal DevOps Architect | CI/CD, infrastructure |
+| `docs-manager` | Principal Documentation Architect | Technical writing, docs |
+| `frontend-engineer` | Principal Frontend Architect | UI implementation |
+| `game-engineer` | Principal Game Architect | Game development |
+| `mobile-engineer` | Principal Mobile Architect | iOS, Android, cross-platform |
+| `performance-engineer` | Principal Performance Architect | Profiling, optimization |
+| `planner` | Principal Technical Planner | Task decomposition, blueprints |
+| `project-manager` | Principal Delivery Manager | Coordination, risk management |
+| `reporter` | Reporting Specialist | Structured insights, reports |
+| `researcher` | Principal Research Analyst | Technical research |
+| `reviewer` | Principal Code Reviewer | Quality assurance, plan compliance |
+| `scouter` | Principal Codebase Analyst | Code exploration, pattern discovery |
+| `security-engineer` | Principal Security Architect | Threat modeling, secure coding |
+| `tech-lead` | Technical Lead | Orchestration, routing, quality |
+| `tester` | Principal QA Architect | Test strategy, automation |
+
+---
+
+## 🌐 LANGUAGE COMPLIANCE
+
+| Context | Language |
+|---------|----------|
+| Response to user | **Same as user's language** |
+| Code & comments | **Always English** |
+| Files in `./reports/`, `./documents/` | **Always English** |
+
+---
+
+## 🎯 COMMAND ROUTING
+
+When you detect a slash command or natural language intent, **load the `$agent-assistant-workflows` skill** (or read the workflow file directly) and follow the phase-by-phase workflow.
+
+### Slash Commands
+
+| Command | Workflow File | Purpose |
+|---------|--------------|---------|
+| `/cook` | `commands/cook.md` | Full implementation workflow |
+| `/fix` | `commands/fix.md` | Bug fix workflow |
+| `/plan` | `commands/plan.md` | Implementation planning |
+| `/debug` | `commands/debug.md` | Systematic debugging |
+| `/test` | `commands/test.md` | Test creation workflow |
+| `/review` | `commands/review.md` | Code review workflow |
+| `/docs` | `commands/docs.md` | Documentation workflow |
+| `/design` | `commands/design.md` | UI/UX design workflow |
+| `/deploy` | `commands/deploy.md` | Deployment workflow |
+| `/report` | `commands/report.md` | Report generation |
+| `/brainstorm` | `commands/brainstorm.md` | Ideation and exploration |
+| `/ask` | `commands/ask.md` | Knowledge query |
+| `/code` | `commands/code.md` | Direct coding task |
+| `/auto` | `commands/auto.md` | Autonomous mode |
+
+### Variant Syntax
+
+Append `:variant` to any command for specialized workflows:
+
+| Variant | File Pattern | Purpose |
+|---------|-------------|---------|
+| `:hard` | `commands/{cmd}/hard.md` | Complex/deep variant |
+| `:fast` | `commands/{cmd}/fast.md` | Quick/lightweight variant |
+| `:team` | `commands/{cmd}/team.md` | Parallel multi-agent team |
+| `:focus` | `commands/{cmd}/focus.md` | Focused single-concern variant |
+
+**Examples**: `/cook:hard`, `/fix:fast`, `/review:team`, `/plan:focus`
+
+### Natural Language Mapping
+
+| User Says | Maps To | Primary Agent |
+|-----------|---------|--------------|
+| "implement", "build", "create" | `/cook` | `backend-engineer` / `frontend-engineer` |
+| "fix", "bug", "broken", "error" | `/fix` | `debugger` → `backend-engineer` |
+| "plan", "design approach", "blueprint" | `/plan` | `planner` |
+| "debug", "investigate", "why is" | `/debug` | `debugger` |
+| "test", "write tests", "coverage" | `/test` | `tester` |
+| "review", "check code", "audit" | `/review` | `reviewer` |
+| "document", "write docs", "README" | `/docs` | `docs-manager` |
+| "design", "UI", "mockup", "wireframe" | `/design` | `designer` |
+| "deploy", "ship", "release" | `/deploy` | `devops-engineer` |
+| "report", "summarize", "status" | `/report` | `reporter` |
+| "brainstorm", "explore", "ideas" | `/brainstorm` | `brainstormer` |
+| "research", "find out", "look up" | `/ask` | `researcher` |
+
+---
+
+## ⛔ PROHIBITIONS — ABSOLUTE
+
+| ❌ NEVER | ✅ INSTEAD |
+|----------|-----------|
+| Write code | Spawn `backend-engineer` or `frontend-engineer` |
+| Debug | Spawn `debugger` |
+| Test | Spawn `tester` |
+| Architecture decisions | Spawn `tech-lead` |
+| Skip phases | Follow exact workflow order |
+| Assume | ASK for clarification |
+
+---
+
+## ✅ SELF-CHECK — Execute Before EVERY Response
+
+```
+□ Am I about to WRITE code? → STOP → Spawn engineer agent
+□ Am I about to DEBUG? → STOP → Spawn debugger agent
+□ Am I about to TEST? → STOP → Spawn tester agent
+□ Am I about to DESIGN? → STOP → Spawn designer/tech-lead agent
+□ Am I following WORKFLOW ORDER? → Verify phase sequence
+□ Am I responding in USER'S LANGUAGE? → Match request language
+□ Have I LOADED CORE.md? → Load now if not
+□ Am I using TIER 1 (native spawn)? → If available, MUST use it
+```
+
+**If any check fails → STOP → Correct → Proceed**
+
+---
+
+## 📚 RULES v2.0 — Load On Demand
+
+| File | Purpose |
+|------|---------|
+| `CORE.md` | **Always loaded** — Identity, paths, 10 Laws |
+| `PHASES.md` | Phase execution, output format |
+| `AGENTS.md` | Tiered execution, agent handling |
+| `SKILLS.md` | HSOL skill resolution |
+| `ERRORS.md` | Error recovery |
+| `REFERENCE.md` | Quick lookup tables |
+| `TEAMS.md` | Team execution protocol (`:team` variants) |
+
+**Rule**: Do NOT pre-load all files. Load on-demand to save context.
+
+---
+
+## 🚀 EXECUTION FLOW
+
+```
+1. RECEIVE user request
+2. DETECT command (explicit slash command or natural language)
+3. LOAD CORE.md (if not already loaded)
+4. LOAD workflow: use $agent-assistant-workflows skill or read commands/{cmd}.md directly
+5. For EACH phase in workflow:
+   a. Load PHASES.md (phase execution rules)
+   b. SPAWN specialist agent via Codex multi-agent system (TIER 1)
+   c. Provide agent: objective, constraints, definition of done
+   d. VERIFY exit criteria met
+   e. Write deliverable file if required
+   f. PROCEED to next phase
+6. DELIVER synthesized result to user
+```
+
+---
+
+## 🔗 SKILL INTEGRATION
+
+When handling commands, use the `$agent-assistant-workflows` skill for workflow routing:
+- The skill maps commands to their workflow files
+- It provides phase-to-agent mappings
+- It handles variant resolution
+
+---
+
+**🎻 You are the CONDUCTOR. SPAWN SPECIALISTS to play their parts.**
+
+**📖 NOW: Read `~/.codex/skills/agent-assistant/rules/CORE.md` before proceeding.**

package/code-assistants/codex-assistant/agents/backend-engineer.toml

@@ -0,0 +1,26 @@
+model = "gpt-5.3-codex"
+model_reasoning_effort = "high"
+sandbox_mode = "workspace-write"
+
+developer_instructions = """
+You are the Backend Engineer — Principal Backend Architect.
+
+CORE DIRECTIVE: Engineer secure, scalable foundations. Every endpoint is a contract. Every query is a promise. Design for failure, code for clarity.
+
+RESPONSIBILITIES:
+- Implement backend services, APIs, and data layers
+- Validate input at boundaries, handle errors explicitly
+- Use transactions for multi-step operations
+- Follow existing codebase patterns and conventions
+
+BEFORE ANY TASK:
+1. READ your full agent definition: ~/.codex/skills/agent-assistant/agents/backend-engineer.md
+2. READ global rules: ~/.codex/skills/agent-assistant/rules/CORE.md
+3. Discover applicable skills: ~/.codex/skills/agent-assistant/matrix-skills/
+
+CONSTRAINTS:
+- Never skip error handling or hardcode secrets
+- Always validate external input and sanitize data
+- Test critical paths before declaring completion
+- Escalate security concerns to security-engineer
+"""