@fission-ai/openspec 0.2.0 → 0.4.0

package/dist/core/init.js

@@ -1,65 +1,307 @@
 import path from 'path';
-import { select } from '@inquirer/prompts';
+import { createPrompt, isBackspaceKey, isDownKey, isEnterKey, isSpaceKey, isUpKey, useKeypress, usePagination, useState, } from '@inquirer/core';
+import chalk from 'chalk';
 import ora from 'ora';
 import { FileSystemUtils } from '../utils/file-system.js';
 import { TemplateManager } from './templates/index.js';
 import { ToolRegistry } from './configurators/registry.js';
 import { SlashCommandRegistry } from './configurators/slash/registry.js';
-import { AI_TOOLS, OPENSPEC_DIR_NAME } from './config.js';
+import { AI_TOOLS, OPENSPEC_DIR_NAME, } from './config.js';
+const PROGRESS_SPINNER = {
+    interval: 80,
+    frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓'],
+};
+const PALETTE = {
+    white: chalk.hex('#f4f4f4'),
+    lightGray: chalk.hex('#c8c8c8'),
+    midGray: chalk.hex('#8a8a8a'),
+    darkGray: chalk.hex('#4a4a4a'),
+};
+const LETTER_MAP = {
+    O: [' ████ ', '██  ██', '██  ██', '██  ██', ' ████ '],
+    P: ['█████ ', '██  ██', '█████ ', '██    ', '██    '],
+    E: ['██████', '██    ', '█████ ', '██    ', '██████'],
+    N: ['██  ██', '███ ██', '██ ███', '██  ██', '██  ██'],
+    S: [' █████', '██    ', ' ████ ', '    ██', '█████ '],
+    C: [' █████', '██    ', '██    ', '██    ', ' █████'],
+    ' ': ['  ', '  ', '  ', '  ', '  '],
+};
+const sanitizeToolLabel = (raw) => raw.replace(/✅/gu, '✔').trim();
+const parseToolLabel = (raw) => {
+    const sanitized = sanitizeToolLabel(raw);
+    const match = sanitized.match(/^(.*?)\s*\((.+)\)$/u);
+    if (!match) {
+        return { primary: sanitized };
+    }
+    return {
+        primary: match[1].trim(),
+        annotation: match[2].trim(),
+    };
+};
+const toolSelectionWizard = createPrompt((config, done) => {
+    const totalSteps = 3;
+    const [step, setStep] = useState('intro');
+    const [cursor, setCursor] = useState(0);
+    const [selected, setSelected] = useState(() => config.initialSelected ?? []);
+    const [error, setError] = useState(null);
+    const selectedSet = new Set(selected);
+    const pageSize = Math.max(Math.min(config.choices.length, 7), 1);
+    const updateSelected = (next) => {
+        const ordered = config.choices
+            .map((choice) => choice.value)
+            .filter((value) => next.has(value));
+        setSelected(ordered);
+    };
+    const page = usePagination({
+        items: config.choices,
+        active: cursor,
+        pageSize,
+        loop: config.choices.length > 1,
+        renderItem: ({ item, isActive }) => {
+            const isSelected = selectedSet.has(item.value);
+            const cursorSymbol = isActive
+                ? PALETTE.white('›')
+                : PALETTE.midGray(' ');
+            const indicator = isSelected
+                ? PALETTE.white('◉')
+                : PALETTE.midGray('○');
+            const nameColor = isActive ? PALETTE.white : PALETTE.midGray;
+            const label = `${nameColor(item.label.primary)}${item.configured ? PALETTE.midGray(' (already configured)') : ''}`;
+            return `${cursorSymbol} ${indicator} ${label}`;
+        },
+    });
+    useKeypress((key) => {
+        if (step === 'intro') {
+            if (isEnterKey(key)) {
+                setStep('select');
+            }
+            return;
+        }
+        if (step === 'select') {
+            if (isUpKey(key)) {
+                const previousIndex = cursor <= 0 ? config.choices.length - 1 : cursor - 1;
+                setCursor(previousIndex);
+                setError(null);
+                return;
+            }
+            if (isDownKey(key)) {
+                const nextIndex = cursor >= config.choices.length - 1 ? 0 : cursor + 1;
+                setCursor(nextIndex);
+                setError(null);
+                return;
+            }
+            if (isSpaceKey(key)) {
+                const current = config.choices[cursor];
+                if (!current)
+                    return;
+                const next = new Set(selected);
+                if (next.has(current.value)) {
+                    next.delete(current.value);
+                }
+                else {
+                    next.add(current.value);
+                }
+                updateSelected(next);
+                setError(null);
+                return;
+            }
+            if (isEnterKey(key)) {
+                if (selected.length === 0) {
+                    setError('Select at least one AI tool to continue.');
+                    return;
+                }
+                setStep('review');
+                setError(null);
+                return;
+            }
+            if (key.name === 'escape') {
+                setSelected([]);
+                setError(null);
+            }
+            return;
+        }
+        if (step === 'review') {
+            if (isEnterKey(key)) {
+                const finalSelection = config.choices
+                    .map((choice) => choice.value)
+                    .filter((value) => selectedSet.has(value));
+                done(finalSelection);
+                return;
+            }
+            if (isBackspaceKey(key) || key.name === 'escape') {
+                setStep('select');
+                setError(null);
+            }
+        }
+    });
+    const selectedNames = config.choices
+        .filter((choice) => selectedSet.has(choice.value))
+        .map((choice) => choice.label.primary);
+    const stepIndex = step === 'intro' ? 1 : step === 'select' ? 2 : 3;
+    const lines = [];
+    lines.push(PALETTE.midGray(`Step ${stepIndex}/${totalSteps}`));
+    lines.push('');
+    if (step === 'intro') {
+        const introHeadline = config.extendMode
+            ? 'Extend your OpenSpec tooling'
+            : 'Configure your OpenSpec tooling';
+        const introBody = config.extendMode
+            ? 'We detected an existing setup. We will help you refresh or add integrations.'
+            : "Let's get your AI assistants connected so they understand OpenSpec.";
+        lines.push(PALETTE.white(introHeadline));
+        lines.push(PALETTE.midGray(introBody));
+        lines.push('');
+        lines.push(PALETTE.midGray('Press Enter to continue.'));
+    }
+    else if (step === 'select') {
+        lines.push(PALETTE.white(config.baseMessage));
+        lines.push(PALETTE.midGray('Use ↑/↓ to move · Space to toggle · Enter to review selections.'));
+        lines.push('');
+        lines.push(page);
+        lines.push('');
+        if (selectedNames.length === 0) {
+            lines.push(`${PALETTE.midGray('Selected')}: ${PALETTE.midGray('None selected yet')}`);
+        }
+        else {
+            lines.push(PALETTE.midGray('Selected:'));
+            selectedNames.forEach((name) => {
+                lines.push(`  ${PALETTE.white('-')} ${PALETTE.white(name)}`);
+            });
+        }
+    }
+    else {
+        lines.push(PALETTE.white('Review selections'));
+        lines.push(PALETTE.midGray('Press Enter to confirm or Backspace to adjust.'));
+        lines.push('');
+        if (selectedNames.length === 0) {
+            lines.push(PALETTE.midGray('No tools selected. Press Backspace to return.'));
+        }
+        else {
+            selectedNames.forEach((name) => {
+                lines.push(`${PALETTE.white('▌')} ${PALETTE.white(name)}`);
+            });
+        }
+    }
+    if (error) {
+        return [lines.join('\n'), chalk.red(error)];
+    }
+    return lines.join('\n');
+});
 export class InitCommand {
+    prompt;
+    constructor(options = {}) {
+        this.prompt = options.prompt ?? ((config) => toolSelectionWizard(config));
+    }
     async execute(targetPath) {
         const projectPath = path.resolve(targetPath);
         const openspecDir = OPENSPEC_DIR_NAME;
         const openspecPath = path.join(projectPath, openspecDir);
         // Validation happens silently in the background
-        await this.validate(projectPath, openspecPath);
+        const extendMode = await this.validate(projectPath, openspecPath);
+        const existingToolStates = await this.getExistingToolStates(projectPath);
+        this.renderBanner(extendMode);
         // Get configuration (after validation to avoid prompts if validation fails)
-        const config = await this.getConfiguration();
+        const config = await this.getConfiguration(existingToolStates, extendMode);
+        if (config.aiTools.length === 0) {
+            if (extendMode) {
+                throw new Error(`OpenSpec seems to already be initialized at ${openspecPath}.\n` +
+                    `Use 'openspec update' to update the structure.`);
+            }
+            throw new Error('You must select at least one AI tool to configure.');
+        }
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
+        const selectedIds = new Set(config.aiTools);
+        const selectedTools = availableTools.filter((tool) => selectedIds.has(tool.value));
+        const created = selectedTools.filter((tool) => !existingToolStates[tool.value]);
+        const refreshed = selectedTools.filter((tool) => existingToolStates[tool.value]);
+        const skippedExisting = availableTools.filter((tool) => !selectedIds.has(tool.value) && existingToolStates[tool.value]);
+        const skipped = availableTools.filter((tool) => !selectedIds.has(tool.value) && !existingToolStates[tool.value]);
         // Step 1: Create directory structure
-        const structureSpinner = ora({ text: 'Creating OpenSpec structure...', stream: process.stdout }).start();
-        await this.createDirectoryStructure(openspecPath);
-        await this.generateFiles(openspecPath, config);
-        structureSpinner.succeed('OpenSpec structure created');
+        if (!extendMode) {
+            const structureSpinner = this.startSpinner('Creating OpenSpec structure...');
+            await this.createDirectoryStructure(openspecPath);
+            await this.generateFiles(openspecPath, config);
+            structureSpinner.stopAndPersist({
+                symbol: PALETTE.white('▌'),
+                text: PALETTE.white('OpenSpec structure created'),
+            });
+        }
+        else {
+            ora({ stream: process.stdout }).info(PALETTE.midGray('ℹ OpenSpec already initialized. Skipping base scaffolding.'));
+        }
         // Step 2: Configure AI tools
-        const toolSpinner = ora({ text: 'Configuring AI tools...', stream: process.stdout }).start();
+        const toolSpinner = this.startSpinner('Configuring AI tools...');
         await this.configureAITools(projectPath, openspecDir, config.aiTools);
-        toolSpinner.succeed('AI tools configured');
+        toolSpinner.stopAndPersist({
+            symbol: PALETTE.white('▌'),
+            text: PALETTE.white('AI tools configured'),
+        });
         // Success message
-        this.displaySuccessMessage(openspecDir, config);
+        this.displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode);
     }
-    async validate(projectPath, openspecPath) {
-        // Check if OpenSpec already exists
-        if (await FileSystemUtils.directoryExists(openspecPath)) {
-            throw new Error(`OpenSpec seems to already be initialized at ${openspecPath}.\n` +
-                `Use 'openspec update' to update the structure.`);
-        }
+    async validate(projectPath, _openspecPath) {
+        const extendMode = await FileSystemUtils.directoryExists(_openspecPath);
         // Check write permissions
-        if (!await FileSystemUtils.ensureWritePermissions(projectPath)) {
+        if (!(await FileSystemUtils.ensureWritePermissions(projectPath))) {
             throw new Error(`Insufficient permissions to write to ${projectPath}`);
         }
+        return extendMode;
     }
-    async getConfiguration() {
-        const config = {
-            aiTools: []
-        };
-        // Single-select for better UX
-        const selectedTool = await select({
-            message: 'Which AI tool do you use?',
-            choices: AI_TOOLS.map(tool => ({
-                name: tool.available ? tool.name : `${tool.name} (coming soon)`,
+    async getConfiguration(existingTools, extendMode) {
+        const selectedTools = await this.promptForAITools(existingTools, extendMode);
+        return { aiTools: selectedTools };
+    }
+    async promptForAITools(existingTools, extendMode) {
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
+        if (availableTools.length === 0) {
+            return [];
+        }
+        const baseMessage = extendMode
+            ? 'Which AI tools would you like to add or refresh?'
+            : 'Which AI tools do you use?';
+        const initialSelected = extendMode
+            ? availableTools
+                .filter((tool) => existingTools[tool.value])
+                .map((tool) => tool.value)
+            : [];
+        return this.prompt({
+            extendMode,
+            baseMessage,
+            choices: availableTools.map((tool) => ({
                 value: tool.value,
-                disabled: !tool.available
-            }))
+                label: parseToolLabel(tool.name),
+                configured: Boolean(existingTools[tool.value]),
+            })),
+            initialSelected,
         });
-        config.aiTools = [selectedTool];
-        return config;
+    }
+    async getExistingToolStates(projectPath) {
+        const states = {};
+        for (const tool of AI_TOOLS) {
+            states[tool.value] = await this.isToolConfigured(projectPath, tool.value);
+        }
+        return states;
+    }
+    async isToolConfigured(projectPath, toolId) {
+        const configFile = ToolRegistry.get(toolId)?.configFileName;
+        if (configFile &&
+            (await FileSystemUtils.fileExists(path.join(projectPath, configFile))))
+            return true;
+        const slashConfigurator = SlashCommandRegistry.get(toolId);
+        if (!slashConfigurator)
+            return false;
+        for (const target of slashConfigurator.getTargets()) {
+            if (await FileSystemUtils.fileExists(path.join(projectPath, target.path)))
+                return true;
+        }
+        return false;
     }
     async createDirectoryStructure(openspecPath) {
         const directories = [
             openspecPath,
             path.join(openspecPath, 'specs'),
             path.join(openspecPath, 'changes'),
-            path.join(openspecPath, 'changes', 'archive')
+            path.join(openspecPath, 'changes', 'archive'),
         ];
         for (const dir of directories) {
             await FileSystemUtils.createDirectory(dir);
@@ -90,25 +332,91 @@ export class InitCommand {
             }
         }
     }
-    displaySuccessMessage(openspecDir, config) {
+    displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode) {
         console.log(); // Empty line for spacing
-        ora().succeed('OpenSpec initialized successfully!');
-        // Get the selected tool name for display
-        const selectedToolId = config.aiTools[0];
-        const selectedTool = AI_TOOLS.find(t => t.value === selectedToolId);
-        const toolName = selectedTool ? selectedTool.name : 'your AI assistant';
-        console.log(`\nNext steps - Copy these prompts to ${toolName}:\n`);
-        console.log('────────────────────────────────────────────────────────────');
-        console.log('1. Populate your project context:');
-        console.log('   "Please read openspec/project.md and help me fill it out');
-        console.log('    with details about my project, tech stack, and conventions"\n');
-        console.log('2. Create your first change proposal:');
-        console.log('   "I want to add [YOUR FEATURE HERE]. Please create an');
-        console.log('    OpenSpec change proposal for this feature"\n');
-        console.log('3. Learn the OpenSpec workflow:');
-        console.log('   "Please explain the OpenSpec workflow from openspec/AGENTS.md');
-        console.log('    and how I should work with you on this project"');
-        console.log('────────────────────────────────────────────────────────────\n');
+        const successHeadline = extendMode
+            ? 'OpenSpec tool configuration updated!'
+            : 'OpenSpec initialized successfully!';
+        ora().succeed(PALETTE.white(successHeadline));
+        console.log();
+        console.log(PALETTE.lightGray('Tool summary:'));
+        const summaryLines = [
+            created.length
+                ? `${PALETTE.white('▌')} ${PALETTE.white('Created:')} ${this.formatToolNames(created)}`
+                : null,
+            refreshed.length
+                ? `${PALETTE.lightGray('▌')} ${PALETTE.lightGray('Refreshed:')} ${this.formatToolNames(refreshed)}`
+                : null,
+            skippedExisting.length
+                ? `${PALETTE.midGray('▌')} ${PALETTE.midGray('Skipped (already configured):')} ${this.formatToolNames(skippedExisting)}`
+                : null,
+            skipped.length
+                ? `${PALETTE.darkGray('▌')} ${PALETTE.darkGray('Skipped:')} ${this.formatToolNames(skipped)}`
+                : null,
+        ].filter((line) => Boolean(line));
+        for (const line of summaryLines) {
+            console.log(line);
+        }
+        console.log();
+        console.log(PALETTE.midGray('Use `openspec update` to refresh shared OpenSpec instructions in the future.'));
+        // Get the selected tool name(s) for display
+        const toolName = this.formatToolNames(selectedTools);
+        console.log();
+        console.log(`Next steps - Copy these prompts to ${toolName}:`);
+        console.log(chalk.gray('────────────────────────────────────────────────────────────'));
+        console.log(PALETTE.white('1. Populate your project context:'));
+        console.log(PALETTE.lightGray('   "Please read openspec/project.md and help me fill it out'));
+        console.log(PALETTE.lightGray('    with details about my project, tech stack, and conventions"\n'));
+        console.log(PALETTE.white('2. Create your first change proposal:'));
+        console.log(PALETTE.lightGray('   "I want to add [YOUR FEATURE HERE]. Please create an'));
+        console.log(PALETTE.lightGray('    OpenSpec change proposal for this feature"\n'));
+        console.log(PALETTE.white('3. Learn the OpenSpec workflow:'));
+        console.log(PALETTE.lightGray('   "Please explain the OpenSpec workflow from openspec/AGENTS.md'));
+        console.log(PALETTE.lightGray('    and how I should work with you on this project"'));
+        console.log(PALETTE.darkGray('────────────────────────────────────────────────────────────\n'));
+    }
+    formatToolNames(tools) {
+        const names = tools
+            .map((tool) => tool.successLabel ?? tool.name)
+            .filter((name) => Boolean(name));
+        if (names.length === 0)
+            return PALETTE.lightGray('your AI assistant');
+        if (names.length === 1)
+            return PALETTE.white(names[0]);
+        const base = names.slice(0, -1).map((name) => PALETTE.white(name));
+        const last = PALETTE.white(names[names.length - 1]);
+        return `${base.join(PALETTE.midGray(', '))}${base.length ? PALETTE.midGray(', and ') : ''}${last}`;
+    }
+    renderBanner(_extendMode) {
+        const rows = ['', '', '', '', ''];
+        for (const char of 'OPENSPEC') {
+            const glyph = LETTER_MAP[char] ?? LETTER_MAP[' '];
+            for (let i = 0; i < rows.length; i += 1) {
+                rows[i] += `${glyph[i]}  `;
+            }
+        }
+        const rowStyles = [
+            PALETTE.white,
+            PALETTE.lightGray,
+            PALETTE.midGray,
+            PALETTE.lightGray,
+            PALETTE.white,
+        ];
+        console.log();
+        rows.forEach((row, index) => {
+            console.log(rowStyles[index](row.replace(/\s+$/u, '')));
+        });
+        console.log();
+        console.log(PALETTE.white('Welcome to OpenSpec!'));
+        console.log();
+    }
+    startSpinner(text) {
+        return ora({
+            text,
+            stream: process.stdout,
+            color: 'gray',
+            spinner: PROGRESS_SPINNER,
+        }).start();
     }
 }
 //# sourceMappingURL=init.js.map

package/dist/core/parsers/change-parser.js

@@ -124,7 +124,7 @@ export class ChangeParser extends MarkdownParser {
     }
     parseRenames(content) {
         const renames = [];
-        const lines = content.split('\n');
+        const lines = ChangeParser.normalizeContent(content).split('\n');
         let currentRename = {};
         for (const line of lines) {
             const fromMatch = line.match(/^\s*-?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);
@@ -146,7 +146,8 @@ export class ChangeParser extends MarkdownParser {
         return renames;
     }
     parseSectionsFromContent(content) {
-        const lines = content.split('\n');
+        const normalizedContent = ChangeParser.normalizeContent(content);
+        const lines = normalizedContent.split('\n');
         const sections = [];
         const stack = [];
         for (let i = 0; i < lines.length; i++) {

package/dist/core/parsers/markdown-parser.d.ts

@@ -9,6 +9,7 @@ export declare class MarkdownParser {
     private lines;
     private currentLine;
     constructor(content: string);
+    protected static normalizeContent(content: string): string;
     parseSpec(name: string): Spec;
     parseChange(name: string): Change;
     protected parseSections(): Section[];

package/dist/core/parsers/markdown-parser.js

@@ -2,9 +2,13 @@ export class MarkdownParser {
     lines;
     currentLine;
     constructor(content) {
-        this.lines = content.split('\n');
+        const normalized = MarkdownParser.normalizeContent(content);
+        this.lines = normalized.split('\n');
         this.currentLine = 0;
     }
+    static normalizeContent(content) {
+        return content.replace(/\r\n?/g, '\n');
+    }
     parseSpec(name) {
         const sections = this.parseSections();
         const purpose = this.findSection(sections, 'Purpose')?.content || '';

package/dist/core/parsers/requirement-blocks.js

@@ -6,7 +6,8 @@ const REQUIREMENT_HEADER_REGEX = /^###\s*Requirement:\s*(.+)\s*$/;
  * Extracts the Requirements section from a spec file and parses requirement blocks.
  */
 export function extractRequirementsSection(content) {
-    const lines = content.split('\n');
+    const normalized = normalizeLineEndings(content);
+    const lines = normalized.split('\n');
     const reqHeaderIndex = lines.findIndex(l => /^##\s+Requirements\s*$/i.test(l));
     if (reqHeaderIndex === -1) {
         // No requirements section; create an empty one at the end
@@ -70,11 +71,15 @@ export function extractRequirementsSection(content) {
         after: after.startsWith('\n') ? after : '\n' + after,
     };
 }
+function normalizeLineEndings(content) {
+    return content.replace(/\r\n?/g, '\n');
+}
 /**
  * Parse a delta-formatted spec change file content into a DeltaPlan with raw blocks.
  */
 export function parseDeltaSpec(content) {
-    const sections = splitTopLevelSections(content);
+    const normalized = normalizeLineEndings(content);
+    const sections = splitTopLevelSections(normalized);
     const added = parseRequirementBlocksFromSection(sections['ADDED Requirements'] || '');
     const modified = parseRequirementBlocksFromSection(sections['MODIFIED Requirements'] || '');
     const removedNames = parseRemovedNames(sections['REMOVED Requirements'] || '');
@@ -103,7 +108,7 @@ function splitTopLevelSections(content) {
 function parseRequirementBlocksFromSection(sectionBody) {
     if (!sectionBody)
         return [];
-    const lines = sectionBody.split('\n');
+    const lines = normalizeLineEndings(sectionBody).split('\n');
     const blocks = [];
     let i = 0;
     while (i < lines.length) {
@@ -133,7 +138,7 @@ function parseRemovedNames(sectionBody) {
     if (!sectionBody)
         return [];
     const names = [];
-    const lines = sectionBody.split('\n');
+    const lines = normalizeLineEndings(sectionBody).split('\n');
     for (const line of lines) {
         const m = line.match(REQUIREMENT_HEADER_REGEX);
         if (m) {
@@ -152,7 +157,7 @@ function parseRenamedPairs(sectionBody) {
     if (!sectionBody)
         return [];
     const pairs = [];
-    const lines = sectionBody.split('\n');
+    const lines = normalizeLineEndings(sectionBody).split('\n');
     let current = {};
     for (const line of lines) {
         const fromMatch = line.match(/^\s*-?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);

package/dist/core/templates/claude-template.d.ts

@@ -1,2 +1,2 @@
-export declare const claudeTemplate = "# OpenSpec Project\n\nThis project uses OpenSpec for spec-driven development. Specifications are the source of truth.\n\nSee @openspec/AGENTS.md for detailed conventions and guidelines.\n\n## Three-Stage Workflow\n\n### Stage 1: Creating Changes\nCreate proposal for: features, breaking changes, architecture changes\nSkip proposal for: bug fixes, typos, non-breaking updates\n\n### Stage 2: Implementing Changes\n1. Read proposal.md to understand the change\n2. Read design.md if it exists for technical context\n3. Read tasks.md for implementation checklist\n4. Complete tasks one by one\n5. Mark each task complete immediately: `- [x]`\n6. Validate strictly: `openspec validate [change] --strict`\n7. Approval gate: Do not start implementation until the proposal is approved\n\n### Stage 3: Archiving\nAfter deployment, use `openspec archive [change]` (add `--skip-specs` for tooling-only changes)\n\n## Before Any Task\n\n**Always:**\n- Check existing specs: `openspec list --specs`\n- Check active changes: `openspec list`\n- Read relevant specs before creating new ones\n- Prefer modifying existing specs over creating duplicates\n\n## CLI Quick Reference\n\n```bash\n# Essential\nopenspec list              # Active changes\nopenspec list --specs      # Existing specifications\nopenspec show [item]       # View details\nopenspec validate --strict # Validate thoroughly\nopenspec archive [change]  # Archive after deployment\n\n# Interactive\nopenspec show              # Prompts for selection\nopenspec validate          # Bulk validation\n\n# Debugging\nopenspec show [change] --json --deltas-only\n```\n\n## Creating Changes\n\n1. **Directory:** `changes/[change-id]/`\n   - Change ID naming: kebab-case, verb-led (`add-`, `update-`, `remove-`, `refactor-`), unique (append `-2`, `-3` if needed)\n2. **Files:**\n   - `proposal.md` - Why, what, impact\n   - `tasks.md` - Implementation checklist\n   - `design.md` - Only if needed (cross-cutting, new deps/data model, security/perf/migration complexity, or high ambiguity)\n   - `specs/[capability]/spec.md` - Delta changes (ADDED/MODIFIED/REMOVED). For multiple capabilities, include multiple files.\n3. **If ambiguous:** ask 1\u20132 clarifying questions before scaffolding\n\n## Search Guidance\n- Enumerate specs: `openspec spec list --long` (or `--json`)\n- Enumerate changes: `openspec list`\n- Show details: `openspec show <spec-id> --type spec`, `openspec show <change-id> --json --deltas-only`\n- Full-text search (use ripgrep): `rg -n \"Requirement:|Scenario:\" openspec/specs`\n\n## Critical: Scenario Format\n\n**CORRECT:**\n```markdown\n#### Scenario: User login\n- **WHEN** valid credentials\n- **THEN** return token\n```\n\n**WRONG:** Using bullets (- **Scenario**), bold (**Scenario:**), or ### headers\n\nEvery requirement MUST have scenarios using `#### Scenario:` format.\n\n## Complexity Management\n\n**Default to minimal:**\n- <100 lines of new code\n- Single-file implementations\n- No frameworks without justification\n- Boring, proven patterns\n\n**Only add complexity with:**\n- Performance data showing need\n- Concrete scale requirements (>1000 users)\n- Multiple proven use cases\n\n## Troubleshooting\n\n**\"Change must have at least one delta\"**\n- Check `changes/[name]/specs/` exists\n- Verify operation prefixes (## ADDED Requirements)\n\n**\"Requirement must have at least one scenario\"**\n- Use `#### Scenario:` format (4 hashtags)\n- Don't use bullets or bold\n\n**Debug:** `openspec show [change] --json --deltas-only`\n";
+export { agentsTemplate as claudeTemplate } from './agents-template.js';
 //# sourceMappingURL=claude-template.d.ts.map

package/dist/core/templates/claude-template.js

@@ -1,106 +1,2 @@
-export const claudeTemplate = `# OpenSpec Project
-
-This project uses OpenSpec for spec-driven development. Specifications are the source of truth.
-
-See @openspec/AGENTS.md for detailed conventions and guidelines.
-
-## Three-Stage Workflow
-
-### Stage 1: Creating Changes
-Create proposal for: features, breaking changes, architecture changes
-Skip proposal for: bug fixes, typos, non-breaking updates
-
-### Stage 2: Implementing Changes
-1. Read proposal.md to understand the change
-2. Read design.md if it exists for technical context
-3. Read tasks.md for implementation checklist
-4. Complete tasks one by one
-5. Mark each task complete immediately: \`- [x]\`
-6. Validate strictly: \`openspec validate [change] --strict\`
-7. Approval gate: Do not start implementation until the proposal is approved
-
-### Stage 3: Archiving
-After deployment, use \`openspec archive [change]\` (add \`--skip-specs\` for tooling-only changes)
-
-## Before Any Task
-
-**Always:**
-- Check existing specs: \`openspec list --specs\`
-- Check active changes: \`openspec list\`
-- Read relevant specs before creating new ones
-- Prefer modifying existing specs over creating duplicates
-
-## CLI Quick Reference
-
-\`\`\`bash
-# Essential
-openspec list              # Active changes
-openspec list --specs      # Existing specifications
-openspec show [item]       # View details
-openspec validate --strict # Validate thoroughly
-openspec archive [change]  # Archive after deployment
-
-# Interactive
-openspec show              # Prompts for selection
-openspec validate          # Bulk validation
-
-# Debugging
-openspec show [change] --json --deltas-only
-\`\`\`
-
-## Creating Changes
-
-1. **Directory:** \`changes/[change-id]/\`
-   - Change ID naming: kebab-case, verb-led (\`add-\`, \`update-\`, \`remove-\`, \`refactor-\`), unique (append \`-2\`, \`-3\` if needed)
-2. **Files:**
-   - \`proposal.md\` - Why, what, impact
-   - \`tasks.md\` - Implementation checklist
-   - \`design.md\` - Only if needed (cross-cutting, new deps/data model, security/perf/migration complexity, or high ambiguity)
-   - \`specs/[capability]/spec.md\` - Delta changes (ADDED/MODIFIED/REMOVED). For multiple capabilities, include multiple files.
-3. **If ambiguous:** ask 1–2 clarifying questions before scaffolding
-
-## Search Guidance
-- Enumerate specs: \`openspec spec list --long\` (or \`--json\`)
-- Enumerate changes: \`openspec list\`
-- Show details: \`openspec show <spec-id> --type spec\`, \`openspec show <change-id> --json --deltas-only\`
-- Full-text search (use ripgrep): \`rg -n "Requirement:|Scenario:" openspec/specs\`
-
-## Critical: Scenario Format
-
-**CORRECT:**
-\`\`\`markdown
-#### Scenario: User login
-- **WHEN** valid credentials
-- **THEN** return token
-\`\`\`
-
-**WRONG:** Using bullets (- **Scenario**), bold (**Scenario:**), or ### headers
-
-Every requirement MUST have scenarios using \`#### Scenario:\` format.
-
-## Complexity Management
-
-**Default to minimal:**
-- <100 lines of new code
-- Single-file implementations
-- No frameworks without justification
-- Boring, proven patterns
-
-**Only add complexity with:**
-- Performance data showing need
-- Concrete scale requirements (>1000 users)
-- Multiple proven use cases
-
-## Troubleshooting
-
-**"Change must have at least one delta"**
-- Check \`changes/[name]/specs/\` exists
-- Verify operation prefixes (## ADDED Requirements)
-
-**"Requirement must have at least one scenario"**
-- Use \`#### Scenario:\` format (4 hashtags)
-- Don't use bullets or bold
-
-**Debug:** \`openspec show [change] --json --deltas-only\`
-`;
+export { agentsTemplate as claudeTemplate } from './agents-template.js';
 //# sourceMappingURL=claude-template.js.map