specweave 0.17.0 → 0.17.1

package/dist/src/adapters/claude-md-generator.js

@@ -0,0 +1,307 @@
+/**
+ * CLAUDE.md Generator
+ *
+ * Generates CLAUDE.md - the PRIMARY instruction file for Claude Code.
+ *
+ * CRITICAL:
+ * - Claude Code ONLY reads CLAUDE.md (NOT AGENTS.md)
+ * - This is the native/baseline implementation (skills, agents, hooks, slash commands)
+ * - Claude Code is NOT an adapter - it's the gold standard that others try to approximate
+ *
+ * This generator creates a quick reference that lists what's actually installed,
+ * so when we add new agents/skills, CLAUDE.md stays in sync automatically.
+ */
+import { DocGenerator } from './doc-generator.js';
+import * as path from 'path';
+import fs from 'fs-extra';
+import { getDirname } from '../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+/**
+ * Find the package root by walking up the directory tree looking for package.json
+ * This works reliably on all platforms including Windows with UNC paths
+ */
+function findPackageRoot(startDir) {
+    let currentDir = startDir;
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const packageJsonPath = path.join(currentDir, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                // Verify this is the specweave package
+                if (packageJson.name === 'specweave') {
+                    return currentDir;
+                }
+            }
+            catch (error) {
+                // Not a valid package.json, continue searching
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            break; // Reached root
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Find template file using package root detection
+ */
+function findTemplateFile(filename) {
+    const packageRoot = findPackageRoot(__dirname);
+    if (packageRoot) {
+        // Try src/templates/ first (for npm installs)
+        const srcPath = path.normalize(path.join(packageRoot, 'src', 'templates', filename));
+        if (fs.existsSync(srcPath)) {
+            return srcPath;
+        }
+        // Try dist/templates/ (shouldn't exist but try anyway)
+        const distPath = path.normalize(path.join(packageRoot, 'dist', 'templates', filename));
+        if (fs.existsSync(distPath)) {
+            return distPath;
+        }
+        // Try templates/ directly in package root
+        const rootPath = path.normalize(path.join(packageRoot, 'templates', filename));
+        if (fs.existsSync(rootPath)) {
+            return rootPath;
+        }
+    }
+    return null;
+}
+/**
+ * Generate CLAUDE.md with dynamic agent/skill sections
+ */
+export class ClaudeMdGenerator {
+    constructor(skillsDir, agentsDir, commandsDir) {
+        this.docGen = new DocGenerator(skillsDir, agentsDir, commandsDir);
+    }
+    /**
+     * Generate complete CLAUDE.md content
+     */
+    async generate(options) {
+        // Read template - use provided path or find it via package root
+        let templatePath = options.templatePath;
+        if (!templatePath || !await fs.pathExists(templatePath)) {
+            // Fallback: try to find template using package root detection
+            const foundPath = findTemplateFile('CLAUDE.md.template');
+            if (foundPath) {
+                templatePath = foundPath;
+            }
+            else {
+                const errorMsg = options.templatePath
+                    ? `CLAUDE.md template not found at: ${options.templatePath}\nAlso tried package root detection but failed.`
+                    : `CLAUDE.md template not found. Tried:\n  - Package root detection\n  - __dirname: ${__dirname}\n  - Default: ${path.join(__dirname, '../templates/CLAUDE.md.template')}`;
+                throw new Error(errorMsg);
+            }
+        }
+        let content = await fs.readFile(templatePath, 'utf-8');
+        // Replace placeholders
+        content = content.replace(/\{PROJECT_NAME\}/g, options.projectName);
+        // Replace dynamic sections
+        content = await this.replaceDynamicSections(content);
+        return content;
+    }
+    /**
+     * Replace dynamic sections in template
+     */
+    async replaceDynamicSections(content) {
+        // Extract actual skills and agents
+        const skills = await this.docGen.extractSkills();
+        const agents = await this.docGen.extractAgents();
+        const commands = await this.docGen.extractCommands();
+        // Replace agents section (lines 226-243 in template)
+        content = this.replaceAgentsSection(content, agents);
+        // Replace skills section (lines 248-278 in template)
+        content = this.replaceSkillsSection(content, skills);
+        // Replace commands section if needed
+        content = this.replaceCommandsSection(content, commands);
+        return content;
+    }
+    /**
+     * Generate dynamic agents section
+     */
+    replaceAgentsSection(content, agents) {
+        const agentsTable = this.generateAgentsTable(agents);
+        // Find the agents section and replace it
+        // Look for "## Agents (Activate Automatically)" section
+        const agentsSectionRegex = /## Agents \(Activate Automatically\)[\s\S]*?(?=\n## |$)/;
+        const agentsSection = `## Agents (Activate Automatically)
+
+**Strategic Agents** (pre-installed & ready to use):
+
+${agentsTable}
+
+**All ${agents.length} agents are pre-installed** - Claude uses the right one based on your request!
+
+**See**: \`.claude/agents/\` for complete list
+
+---
+`;
+        if (agentsSectionRegex.test(content)) {
+            return content.replace(agentsSectionRegex, agentsSection);
+        }
+        return content;
+    }
+    /**
+     * Generate agents table
+     */
+    generateAgentsTable(agents) {
+        let table = '| Agent | Purpose | Activates When |\n';
+        table += '|-------|---------|----------------|\n';
+        for (const agent of agents) {
+            const activation = this.getAgentActivation(agent.name);
+            table += `| \`${agent.name}\` | ${agent.description} | ${activation} |\n`;
+        }
+        return table;
+    }
+    /**
+     * Get agent activation guidance
+     */
+    getAgentActivation(agentName) {
+        const activations = {
+            'pm': 'Planning features',
+            'architect': 'Technical design',
+            'security': 'Security review',
+            'qa-lead': 'Testing',
+            'devops': 'Deployment needed',
+            'tech-lead': 'Code review',
+            'sre': 'Troubleshooting',
+            'docs-writer': 'Writing docs',
+            'performance': 'Optimization needed',
+            'frontend': 'Frontend development',
+            'nodejs-backend': 'Node.js backend',
+            'python-backend': 'Python backend',
+            'nextjs': 'Next.js development',
+            'dotnet-backend': '.NET development'
+        };
+        return activations[agentName] || 'Specialized tasks';
+    }
+    /**
+     * Generate dynamic skills section
+     */
+    replaceSkillsSection(content, skills) {
+        const skillsTable = this.generateSkillsTable(skills);
+        // Find the skills section and replace it
+        const skillsSectionRegex = /## Skills \(Activate Automatically\)[\s\S]*?(?=\n## |$)/;
+        const skillsSection = `## Skills (Activate Automatically)
+
+**Framework Skills** (always available):
+
+${this.generateFrameworkSkillsTable(skills)}
+
+**Technology Skills** (all pre-installed):
+
+${this.generateTechSkillsTable(skills)}
+
+**Integration Skills** (all pre-installed):
+
+${this.generateIntegrationSkillsTable(skills)}
+
+**See**: \`.claude/skills/\` for complete list of ${skills.length}+ skills!
+
+---
+`;
+        if (skillsSectionRegex.test(content)) {
+            return content.replace(skillsSectionRegex, skillsSection);
+        }
+        return content;
+    }
+    /**
+     * Generate framework skills table
+     */
+    generateFrameworkSkillsTable(skills) {
+        const frameworkSkills = skills.filter(s => ['specweave-detector', 'increment-planner', 'context-loader', 'skill-router',
+            'spec-driven-debugging', 'spec-driven-brainstorming', 'brownfield-analyzer'].includes(s.name));
+        let table = '| Skill | Purpose | Activates When |\n';
+        table += '|-------|---------|----------------|\n';
+        for (const skill of frameworkSkills) {
+            const activation = this.getSkillActivation(skill.name);
+            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 60)} | ${activation} |\n`;
+        }
+        return table;
+    }
+    /**
+     * Generate tech skills table
+     */
+    generateTechSkillsTable(skills) {
+        const techSkills = skills.filter(s => ['nodejs-backend', 'python-backend', 'nextjs', 'frontend', 'dotnet-backend',
+            'e2e-playwright'].includes(s.name));
+        let table = '| Skill | Purpose | Activates When |\n';
+        table += '|-------|---------|----------------|\n';
+        for (const skill of techSkills) {
+            const activation = this.getSkillActivation(skill.name);
+            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 60)} | ${activation} |\n`;
+        }
+        return table;
+    }
+    /**
+     * Generate integration skills table
+     */
+    generateIntegrationSkillsTable(skills) {
+        const integrationSkills = skills.filter(s => ['jira-sync', 'github-sync', 'ado-sync', 'hetzner-provisioner',
+            'cost-optimizer', 'figma-mcp-connector'].includes(s.name));
+        let table = '| Skill | Purpose | Activates When |\n';
+        table += '|-------|---------|----------------|\n';
+        for (const skill of integrationSkills) {
+            const activation = this.getSkillActivation(skill.name);
+            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 60)} | ${activation} |\n`;
+        }
+        return table;
+    }
+    /**
+     * Get skill activation guidance
+     */
+    getSkillActivation(skillName) {
+        const activations = {
+            'specweave-detector': 'User asks about SpecWeave',
+            'increment-planner': '/pi or feature planning',
+            'context-loader': 'Working on increments',
+            'skill-router': 'Ambiguous requests',
+            'spec-driven-debugging': 'Bug or test failure',
+            'spec-driven-brainstorming': 'Brainstorm or refine idea',
+            'nodejs-backend': 'Node.js backend',
+            'python-backend': 'Python backend',
+            'nextjs': 'Next.js',
+            'frontend': 'Frontend',
+            'dotnet-backend': '.NET',
+            'jira-sync': 'JIRA integration',
+            'github-sync': 'GitHub integration',
+            'ado-sync': 'Azure DevOps sync',
+            'hetzner-provisioner': 'Hetzner deployment',
+            'cost-optimizer': 'Cost optimization',
+            'e2e-playwright': 'E2E testing'
+        };
+        return activations[skillName] || 'Specialized tasks';
+    }
+    /**
+     * Generate skills table
+     */
+    generateSkillsTable(skills) {
+        let table = '| Skill | Description |\n';
+        table += '|-------|-------------|\n';
+        for (const skill of skills.slice(0, 20)) { // Top 20 skills
+            table += `| \`${skill.name}\` | ${this.truncate(skill.description, 80)} |\n`;
+        }
+        if (skills.length > 20) {
+            table += `| _...and ${skills.length - 20} more_ | See \`.claude/skills/\` |\n`;
+        }
+        return table;
+    }
+    /**
+     * Replace commands section
+     */
+    replaceCommandsSection(content, commands) {
+        // Commands are already listed in the template, but we could make them dynamic too
+        // For now, we'll skip this since commands are explicitly documented
+        return content;
+    }
+    /**
+     * Truncate text to max length
+     */
+    truncate(text, maxLength) {
+        if (text.length <= maxLength)
+            return text;
+        return text.substring(0, maxLength - 3) + '...';
+    }
+}
+//# sourceMappingURL=claude-md-generator.js.map

package/dist/src/adapters/claude-md-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-generator.js","sourceRoot":"","sources":["../../../src/adapters/claude-md-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/adapters/codex/adapter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Codex Adapter (OpenAI)
+ *
+ * Semi-automation adapter for OpenAI Codex (ChatGPT Code Interpreter/Codex CLI).
+ * Uses universal AGENTS.md file for instructions.
+ *
+ * Codex features:
+ * - Works in CLI, IDE, web, GitHub, iOS app
+ * - GPT-5-Codex optimized for engineering tasks
+ * - File read/write operations
+ * - Test execution and validation
+ * - Task-based isolated environments
+ */
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+export declare class CodexAdapter extends AdapterBase {
+    name: string;
+    description: string;
+    automationLevel: "semi";
+    /**
+     * Detect if Codex is available
+     *
+     * Checks for:
+     * - codex command in PATH (Codex CLI)
+     * - .codex/ directory exists
+     * - AGENTS.md file exists (previously configured)
+     */
+    detect(): Promise<boolean>;
+    /**
+     * Get files to install for Codex adapter
+     */
+    getFiles(): AdapterFile[];
+    /**
+     * Install Codex adapter
+     */
+    install(options: AdapterOptions): Promise<void>;
+    /**
+     * Generate AGENTS.md file
+     */
+    private generateAgentsMd;
+    /**
+     * Post-installation instructions
+     */
+    postInstall(options: AdapterOptions): Promise<void>;
+    /**
+     * Get usage instructions for Codex adapter
+     */
+    getInstructions(): string;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/src/adapters/codex/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/codex/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtE,qBAAa,YAAa,SAAQ,WAAW;IAC3C,IAAI,SAAW;IACf,WAAW,SAAoF;IAC/F,eAAe,EAAG,MAAM,CAAU;IAElC;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAQhC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAezB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAuN1B"}

package/dist/src/adapters/codex/adapter.js

@@ -0,0 +1,316 @@
+/**
+ * Codex Adapter (OpenAI)
+ *
+ * Semi-automation adapter for OpenAI Codex (ChatGPT Code Interpreter/Codex CLI).
+ * Uses universal AGENTS.md file for instructions.
+ *
+ * Codex features:
+ * - Works in CLI, IDE, web, GitHub, iOS app
+ * - GPT-5-Codex optimized for engineering tasks
+ * - File read/write operations
+ * - Test execution and validation
+ * - Task-based isolated environments
+ */
+import * as path from 'path';
+import fs from 'fs-extra';
+import { AdapterBase } from '../adapter-base.js';
+import { AgentsMdGenerator } from '../agents-md-generator.js';
+import { getDirname } from '../../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+export class CodexAdapter extends AdapterBase {
+    constructor() {
+        super(...arguments);
+        this.name = 'codex';
+        this.description = 'OpenAI Codex adapter - Semi-automation with AGENTS.md and task-based execution';
+        this.automationLevel = 'semi';
+    }
+    /**
+     * Detect if Codex is available
+     *
+     * Checks for:
+     * - codex command in PATH (Codex CLI)
+     * - .codex/ directory exists
+     * - AGENTS.md file exists (previously configured)
+     */
+    async detect() {
+        const hasCodexCLI = await this.commandExists('codex');
+        const hasCodexDir = await this.fileExists('.codex');
+        const hasAgentsMd = await this.fileExists('AGENTS.md');
+        return hasCodexCLI || hasCodexDir || hasAgentsMd;
+    }
+    /**
+     * Get files to install for Codex adapter
+     */
+    getFiles() {
+        return [
+            {
+                sourcePath: 'AGENTS.md',
+                targetPath: 'AGENTS.md',
+                description: 'Universal SpecWeave instructions (works with all AI tools)'
+            },
+            {
+                sourcePath: 'README.md',
+                targetPath: '.codex/README.md',
+                description: 'Codex adapter documentation'
+            }
+        ];
+    }
+    /**
+     * Install Codex adapter
+     */
+    async install(options) {
+        console.log('\n📦 Installing OpenAI Codex Adapter (Semi-Automation)\n');
+        // Ensure .codex directory exists
+        const codexDir = path.join(options.projectPath, '.codex');
+        await fs.ensureDir(codexDir);
+        // Generate AGENTS.md
+        const agentsMdPath = path.join(options.projectPath, 'AGENTS.md');
+        await this.generateAgentsMd(agentsMdPath, options);
+        // Copy README
+        const readmePath = path.join(__dirname, 'README.md');
+        if (await fs.pathExists(readmePath)) {
+            await fs.copy(readmePath, path.join(codexDir, 'README.md'));
+        }
+        console.log('\n✨ Codex adapter installed!');
+        console.log('\n📋 Files created:');
+        console.log('   - AGENTS.md (universal instructions)');
+        console.log('   - .codex/README.md (adapter documentation)');
+    }
+    /**
+     * Generate AGENTS.md file
+     */
+    async generateAgentsMd(targetPath, options) {
+        const generator = new AgentsMdGenerator(path.join(__dirname, '../../skills'), path.join(__dirname, '../../agents'), path.join(__dirname, '../../commands'));
+        const content = await generator.generate({
+            projectName: options.projectName,
+            projectPath: options.projectPath
+        });
+        await fs.writeFile(targetPath, content);
+        console.log('  ✅ AGENTS.md - Universal SpecWeave instructions');
+    }
+    /**
+     * Post-installation instructions
+     */
+    async postInstall(options) {
+        console.log(this.getInstructions());
+    }
+    /**
+     * Get usage instructions for Codex adapter
+     */
+    getInstructions() {
+        return `
+================================================================
+      OpenAI Codex Adapter - Semi-Automation
+================================================================
+
+Your project is now configured for OpenAI Codex with SEMI-automation!
+
+WHAT THIS PROVIDES:
+
+- AGENTS.md (Universal Instructions)
+  - Works with Codex CLI, ChatGPT web, and IDEs
+  - Auto-generated from actual skills/agents
+  - SpecWeave structure and workflows
+  - GPT-5-Codex optimized guidance
+
+- Task-Based Execution
+  - Isolated environments per task
+  - File read/write operations
+  - Test execution and validation
+
+QUICK START:
+
+**Option 1: Codex CLI** (Fastest)
+
+1. Install Codex CLI:
+
+   # Included with ChatGPT Plus, Pro, Business, Enterprise
+   npm install -g openai-codex-cli
+
+2. Create your first feature:
+
+   codex "Read AGENTS.md and create increment for user authentication"
+
+   Codex will:
+   - Read AGENTS.md for SpecWeave context
+   - Adopt PM role: Create spec.md (WHAT/WHY)
+   - Adopt Architect role: Create plan.md (HOW)
+   - Create tasks.md
+   - Execute in isolated environment
+
+**Option 2: ChatGPT Web** (Most Accessible)
+
+1. Open ChatGPT (Plus/Pro/Business/Enterprise)
+
+2. Upload AGENTS.md file
+
+3. Say:
+   "I'm using SpecWeave framework. Create increment for user authentication."
+
+4. Copy generated content to files:
+   - spec.md
+   - plan.md
+   - tasks.md
+
+**Option 3: IDE Integration** (If available in your IDE)
+
+Use Codex integration in your IDE (VS Code, JetBrains, etc.)
+Reference AGENTS.md for SpecWeave structure.
+
+HOW TO USE:
+
+**With Codex CLI**:
+\`\`\`bash
+# Explicit reference (recommended):
+codex "Read AGENTS.md and [your request]"
+
+# Natural language:
+codex "Create a new feature following SpecWeave structure"
+
+# With context:
+codex "Following the PM role in AGENTS.md, create requirements for payments"
+\`\`\`
+
+**With ChatGPT Web**:
+1. Upload AGENTS.md at start of conversation
+2. Reference it: "Following AGENTS.md, create increment for..."
+3. Download or copy-paste generated files
+
+CONTEXT LOADING (70%+ Token Savings):
+
+CRITICAL: Tell Codex to read context-manifest.yaml first!
+
+\`\`\`bash
+# CLI:
+codex "Read context-manifest.yaml from increment 0001, load only those files, then implement task T001"
+
+# Web:
+# 1. Upload context-manifest.yaml
+# 2. Upload only files listed in manifest
+# 3. Request task implementation
+\`\`\`
+
+FEATURES:
+
+✅ GPT-5-Codex Model
+   - Optimized for engineering tasks
+   - Trained on complex, real-world projects
+   - Code generation, debugging, refactoring
+
+✅ Task-Based Execution
+   - Each task in isolated environment
+   - Real-time progress monitoring
+   - Verifiable evidence (citations, logs)
+
+✅ File Operations
+   - Read and edit files
+   - Run commands (tests, linters, type checkers)
+   - Create new files and directories
+
+✅ Multiple Access Points
+   - CLI (fastest)
+   - Web (most accessible)
+   - IDE (most integrated)
+   - GitHub (for PRs)
+   - iOS app (mobile)
+
+✅ Test Execution
+   - Run test harnesses
+   - Validate implementations
+   - Ensure quality
+
+EXAMPLE WORKFLOWS:
+
+1. **Create Feature (CLI)**:
+   \`\`\`bash
+   codex "Read AGENTS.md. Create increment 0002 for payment processing with Stripe. Follow SpecWeave structure."
+   \`\`\`
+
+2. **Create Feature (Web)**:
+   - Upload AGENTS.md
+   - Say: "Create increment for payment processing"
+   - Download generated files
+
+3. **Implement Task**:
+   \`\`\`bash
+   codex "Read increment 0002, implement task T001 (Setup Stripe SDK)"
+   \`\`\`
+
+4. **Fix Bug**:
+   \`\`\`bash
+   codex "Read AGENTS.md and increment 0001. Fix authentication bug. Run tests."
+   \`\`\`
+
+5. **Code Review**:
+   \`\`\`bash
+   codex "Adopt Tech Lead role from AGENTS.md. Review src/auth/ code."
+   \`\`\`
+
+TIPS & TRICKS:
+
+1. **Always Reference AGENTS.md**
+   - CLI: Explicit in command
+   - Web: Upload at conversation start
+
+2. **Use Task-Based Approach**
+   - Break work into tasks (T001, T002, etc.)
+   - Each task runs in isolated environment
+   - Easier to track and validate
+
+3. **Monitor Progress**
+   - CLI shows real-time progress (1-30 minutes per task)
+   - Web shows thinking process
+   - Review citations and logs
+
+4. **Leverage Multiple Access Points**
+   - CLI for speed
+   - Web for accessibility
+   - IDE for integration
+
+5. **Validate with Tests**
+   - Codex can run tests automatically
+   - Verify implementations work
+
+COMPARISON:
+
+| Feature | Claude Code | Codex |
+|---------|-------------|-------|
+| **Automation** | Full | Semi |
+| **Skills** | Native | Via AGENTS.md |
+| **Agents** | Native | Via AGENTS.md |
+| **Access** | CLI only | CLI + Web + IDE + GitHub + iOS |
+| **Model** | Sonnet 4.5 | GPT-5-Codex |
+| **Task Isolation** | No | Yes (isolated environments) |
+
+LIMITATIONS:
+
+- No native skills/agents (manual role adoption via AGENTS.md)
+- No hooks (can't auto-update docs on events)
+- Tasks run 1-30 minutes (not instant)
+- Requires ChatGPT Plus/Pro/Business/Enterprise
+
+But very powerful with GPT-5-Codex and multiple access points!
+
+PLANS & PRICING:
+
+- **ChatGPT Plus**: $20/month (includes Codex CLI + Web)
+- **ChatGPT Pro**: $200/month (unlimited, faster)
+- **Business/Enterprise**: Custom pricing
+
+Free trial may be available - check OpenAI website.
+
+DOCUMENTATION:
+
+- AGENTS.md: Universal SpecWeave instructions (READ THIS!)
+- SPECWEAVE.md: Complete framework documentation
+- .codex/README.md: Codex adapter guide
+- https://openai.com/codex/
+
+You're ready to build with SpecWeave on OpenAI Codex!
+
+Pro tip: Use CLI for speed, Web for accessibility, and always
+reference AGENTS.md for SpecWeave structure!
+    `;
+    }
+}
+//# sourceMappingURL=adapter.js.map