@fission-ai/openspec 0.13.0 → 0.15.0

package/README.md

@@ -92,16 +92,22 @@ These tools have built-in OpenSpec commands. Select the OpenSpec integration whe
 |------|----------|
 | **Claude Code** | `/openspec:proposal`, `/openspec:apply`, `/openspec:archive` |
 | **CodeBuddy Code (CLI)** | `/openspec:proposal`, `/openspec:apply`, `/openspec:archive` (`.codebuddy/commands/`) — see [docs](https://www.codebuddy.ai/cli) |
+| **CoStrict** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.cospec/openspec/commands/`) — see [docs](https://costrict.ai)|
 | **Cursor** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` |
-| **Cline** | Rules in `.clinerules/` directory (`.clinerules/openspec-*.md`) |
+| **Cline** | Workflows in `.clinerules/workflows/` directory (`.clinerules/workflows/openspec-*.md`) |
+| **Crush** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.crush/commands/openspec/`) |
+| **RooCode** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.roo/commands/`) |
 | **Factory Droid** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.factory/commands/`) |
+| **Gemini CLI** | `/openspec:proposal`, `/openspec:apply`, `/openspec:archive` (`.gemini/commands/openspec/`) |
 | **OpenCode** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` |
 | **Kilo Code** | `/openspec-proposal.md`, `/openspec-apply.md`, `/openspec-archive.md` (`.kilocode/workflows/`) |
+| **Qoder (CLI)** | `/openspec:proposal`, `/openspec:apply`, `/openspec:archive` (`.qoder/commands/openspec/`) — see [docs](https://qoder.com/cli) |
 | **Windsurf** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.windsurf/workflows/`) |
 | **Codex** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (global: `~/.codex/prompts`, auto-installed) |
 | **GitHub Copilot** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.github/prompts/`) |
 | **Amazon Q Developer** | `@openspec-proposal`, `@openspec-apply`, `@openspec-archive` (`.amazonq/prompts/`) |
 | **Auggie (Augment CLI)** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.augment/commands/`) |
+| **Qwen Code** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` (`.qwen/commands/`) |
 
 
 Kilo Code discovers team workflows automatically. Save the generated files under `.kilocode/workflows/` and trigger them from the command palette with `/openspec-proposal.md`, `/openspec-apply.md`, or `/openspec-archive.md`.
@@ -111,7 +117,7 @@ These tools automatically read workflow instructions from `openspec/AGENTS.md`.
 
 | Tools |
 |-------|
-| Amp • Jules • Gemini CLI • Others |
+| Amp • Jules • Others |
 
 ### Install & Initialize
 
@@ -142,7 +148,7 @@ openspec init
 ```
 
 **What happens during initialization:**
-- You'll be prompted to pick any natively supported AI tools (Claude Code, CodeBuddy, Cursor, OpenCode, etc.); other assistants always rely on the shared `AGENTS.md` stub
+- You'll be prompted to pick any natively supported AI tools (Claude Code, CodeBuddy, Cursor, OpenCode, Qoder,etc.); other assistants always rely on the shared `AGENTS.md` stub
 - OpenSpec automatically configures slash commands for the tools you choose and always writes a managed `AGENTS.md` hand-off at the project root
 - A new `openspec/` directory structure is created in your project
 
@@ -152,6 +158,17 @@ openspec init
 - If your coding assistant doesn't surface the new slash commands right away, restart it. Slash commands are loaded at startup,
   so a fresh launch ensures they appear
 
+### Optional: Populate Project Context
+
+After `openspec init` completes, you'll receive a suggested prompt to help populate your project context:
+
+```text
+Populate your project context:
+"Please read openspec/project.md and help me fill it out with details about my project, tech stack, and conventions"
+```
+
+Use `openspec/project.md` to define project-level conventions, standards, architectural patterns, and other guidelines that should be followed across all changes.
+
 ### Create Your First Change
 
 Here's a real example showing the complete OpenSpec workflow. This works with any AI tool. Those with native slash commands will recognize the shortcuts automatically.
@@ -217,7 +234,7 @@ Or run the command yourself in terminal:
 $ openspec archive add-profile-filters --yes  # Archive the completed change without prompts
 ```
 
-**Note:** Tools with native slash commands (Claude Code, CodeBuddy, Cursor, Codex) can use the shortcuts shown. All other tools work with natural language requests to "create an OpenSpec proposal", "apply the OpenSpec change", or "archive the change".
+**Note:** Tools with native slash commands (Claude Code, CodeBuddy, Cursor, Codex, Qoder, RooCode) can use the shortcuts shown. All other tools work with natural language requests to "create an OpenSpec proposal", "apply the OpenSpec change", or "archive the change".
 
 ## Command Reference
 

package/dist/commands/change.js

@@ -59,7 +59,7 @@ export class ChangeCommand {
             }
             const parsed = JSON.parse(jsonOutput);
             const contentForTitle = await fs.readFile(proposalPath, 'utf-8');
-            const title = this.extractTitle(contentForTitle);
+            const title = this.extractTitle(contentForTitle, changeName);
             const id = parsed.name;
             const deltas = parsed.deltas || [];
             if (options.requirementsOnly || options.deltasOnly) {
@@ -111,7 +111,7 @@ export class ChangeCommand {
                     }
                     return {
                         id: changeName,
-                        title: this.extractTitle(content),
+                        title: this.extractTitle(content, changeName),
                         deltaCount: change.deltas.length,
                         taskStatus,
                     };
@@ -145,7 +145,7 @@ export class ChangeCommand {
                 const tasksPath = path.join(changesPath, changeName, 'tasks.md');
                 try {
                     const content = await fs.readFile(proposalPath, 'utf-8');
-                    const title = this.extractTitle(content);
+                    const title = this.extractTitle(content, changeName);
                     let taskStatusText = '';
                     try {
                         const tasksContent = await fs.readFile(tasksPath, 'utf-8');
@@ -246,9 +246,9 @@ export class ChangeCommand {
             return [];
         }
     }
-    extractTitle(content) {
-        const match = content.match(/^#\s+(?:Change:\s+)?(.+)$/m);
-        return match ? match[1].trim() : 'Untitled Change';
+    extractTitle(content, changeName) {
+        const match = content.match(/^#\s+(?:Change:\s+)?(.+)$/im);
+        return match ? match[1].trim() : changeName;
     }
     countTasks(content) {
         const lines = content.split('\n');

package/dist/core/config.js

@@ -7,16 +7,21 @@ export const AI_TOOLS = [
     { name: 'Auggie (Augment CLI)', value: 'auggie', available: true, successLabel: 'Auggie' },
     { name: 'Claude Code', value: 'claude', available: true, successLabel: 'Claude Code' },
     { name: 'Cline', value: 'cline', available: true, successLabel: 'Cline' },
+    { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode' },
     { name: 'CodeBuddy Code (CLI)', value: 'codebuddy', available: true, successLabel: 'CodeBuddy Code' },
+    { name: 'CoStrict', value: 'costrict', available: true, successLabel: 'CoStrict' },
     { name: 'Crush', value: 'crush', available: true, successLabel: 'Crush' },
     { name: 'Cursor', value: 'cursor', available: true, successLabel: 'Cursor' },
     { name: 'Factory Droid', value: 'factory', available: true, successLabel: 'Factory Droid' },
+    { name: 'Gemini CLI', value: 'gemini', available: true, successLabel: 'Gemini CLI' },
     { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode' },
     { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code' },
+    { name: 'Qoder (CLI)', value: 'qoder', available: true, successLabel: 'Qoder' },
     { name: 'Windsurf', value: 'windsurf', available: true, successLabel: 'Windsurf' },
     { name: 'Codex', value: 'codex', available: true, successLabel: 'Codex' },
     { name: 'GitHub Copilot', value: 'github-copilot', available: true, successLabel: 'GitHub Copilot' },
     { name: 'Amazon Q Developer', value: 'amazon-q', available: true, successLabel: 'Amazon Q Developer' },
+    { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code' },
     { name: 'AGENTS.md (works with Amp, VS Code, …)', value: 'agents', available: false, successLabel: 'your AGENTS.md-compatible assistant' }
 ];
 //# sourceMappingURL=config.js.map

package/dist/core/configurators/costrict.d.ts

@@ -0,0 +1,8 @@
+import { ToolConfigurator } from './base.js';
+export declare class CostrictConfigurator implements ToolConfigurator {
+    name: string;
+    configFileName: string;
+    isAvailable: boolean;
+    configure(projectPath: string, openspecDir: string): Promise<void>;
+}
+//# sourceMappingURL=costrict.d.ts.map

package/dist/core/configurators/costrict.js

@@ -0,0 +1,15 @@
+import path from 'path';
+import { FileSystemUtils } from '../../utils/file-system.js';
+import { TemplateManager } from '../templates/index.js';
+import { OPENSPEC_MARKERS } from '../config.js';
+export class CostrictConfigurator {
+    name = 'CoStrict';
+    configFileName = 'COSTRICT.md';
+    isAvailable = true;
+    async configure(projectPath, openspecDir) {
+        const filePath = path.join(projectPath, this.configFileName);
+        const content = TemplateManager.getCostrictTemplate();
+        await FileSystemUtils.updateFileWithMarkers(filePath, content, OPENSPEC_MARKERS.start, OPENSPEC_MARKERS.end);
+    }
+}
+//# sourceMappingURL=costrict.js.map

package/dist/core/configurators/qoder.d.ts

@@ -0,0 +1,30 @@
+import { ToolConfigurator } from './base.js';
+/**
+ * Qoder AI Tool Configurator
+ *
+ * Configures OpenSpec integration for Qoder AI coding assistant.
+ * Creates and manages QODER.md configuration file with OpenSpec instructions.
+ *
+ * @implements {ToolConfigurator}
+ */
+export declare class QoderConfigurator implements ToolConfigurator {
+    /** Display name for the Qoder tool */
+    name: string;
+    /** Configuration file name at project root */
+    configFileName: string;
+    /** Indicates tool is available for configuration */
+    isAvailable: boolean;
+    /**
+     * Configure Qoder integration for a project
+     *
+     * Creates or updates QODER.md file with OpenSpec instructions.
+     * Uses Claude-compatible template for instruction content.
+     * Wrapped with OpenSpec markers for future updates.
+     *
+     * @param {string} projectPath - Absolute path to project root directory
+     * @param {string} openspecDir - Path to openspec directory (unused but required by interface)
+     * @returns {Promise<void>} Resolves when configuration is complete
+     */
+    configure(projectPath: string, openspecDir: string): Promise<void>;
+}
+//# sourceMappingURL=qoder.d.ts.map

package/dist/core/configurators/qoder.js

@@ -0,0 +1,42 @@
+import path from 'path';
+import { FileSystemUtils } from '../../utils/file-system.js';
+import { TemplateManager } from '../templates/index.js';
+import { OPENSPEC_MARKERS } from '../config.js';
+/**
+ * Qoder AI Tool Configurator
+ *
+ * Configures OpenSpec integration for Qoder AI coding assistant.
+ * Creates and manages QODER.md configuration file with OpenSpec instructions.
+ *
+ * @implements {ToolConfigurator}
+ */
+export class QoderConfigurator {
+    /** Display name for the Qoder tool */
+    name = 'Qoder';
+    /** Configuration file name at project root */
+    configFileName = 'QODER.md';
+    /** Indicates tool is available for configuration */
+    isAvailable = true;
+    /**
+     * Configure Qoder integration for a project
+     *
+     * Creates or updates QODER.md file with OpenSpec instructions.
+     * Uses Claude-compatible template for instruction content.
+     * Wrapped with OpenSpec markers for future updates.
+     *
+     * @param {string} projectPath - Absolute path to project root directory
+     * @param {string} openspecDir - Path to openspec directory (unused but required by interface)
+     * @returns {Promise<void>} Resolves when configuration is complete
+     */
+    async configure(projectPath, openspecDir) {
+        // Construct full path to QODER.md at project root
+        const filePath = path.join(projectPath, this.configFileName);
+        // Get Claude-compatible instruction template
+        // This ensures Qoder receives the same high-quality OpenSpec instructions
+        const content = TemplateManager.getClaudeTemplate();
+        // Write or update file with managed content between markers
+        // This allows future updates to refresh instructions automatically
+        await FileSystemUtils.updateFileWithMarkers(filePath, content, OPENSPEC_MARKERS.start, OPENSPEC_MARKERS.end);
+    }
+}
+//# sourceMappingURL=qoder.js.map

package/dist/core/configurators/qwen.d.ts

@@ -0,0 +1,24 @@
+import { ToolConfigurator } from './base.js';
+/**
+ * QwenConfigurator class provides integration with Qwen Code
+ * by creating and managing the necessary configuration files.
+ * Currently configures the QWEN.md file with OpenSpec instructions.
+ */
+export declare class QwenConfigurator implements ToolConfigurator {
+    /** Display name for the Qwen Code tool */
+    name: string;
+    /** Configuration file name for Qwen Code */
+    configFileName: string;
+    /** Availability status for the Qwen Code tool */
+    isAvailable: boolean;
+    /**
+     * Configures the Qwen Code integration by creating or updating the QWEN.md file
+     * with OpenSpec instructions and markers.
+     *
+     * @param {string} projectPath - The path to the project root
+     * @param {string} _openspecDir - The path to the openspec directory (unused)
+     * @returns {Promise<void>} A promise that resolves when configuration is complete
+     */
+    configure(projectPath: string, _openspecDir: string): Promise<void>;
+}
+//# sourceMappingURL=qwen.d.ts.map

package/dist/core/configurators/qwen.js

@@ -0,0 +1,37 @@
+/**
+ * Qwen Code configurator for OpenSpec integration.
+ * This class handles the configuration of Qwen Code as an AI tool within OpenSpec.
+ *
+ * @implements {ToolConfigurator}
+ */
+import path from 'path';
+import { FileSystemUtils } from '../../utils/file-system.js';
+import { TemplateManager } from '../templates/index.js';
+import { OPENSPEC_MARKERS } from '../config.js';
+/**
+ * QwenConfigurator class provides integration with Qwen Code
+ * by creating and managing the necessary configuration files.
+ * Currently configures the QWEN.md file with OpenSpec instructions.
+ */
+export class QwenConfigurator {
+    /** Display name for the Qwen Code tool */
+    name = 'Qwen Code';
+    /** Configuration file name for Qwen Code */
+    configFileName = 'QWEN.md';
+    /** Availability status for the Qwen Code tool */
+    isAvailable = true;
+    /**
+     * Configures the Qwen Code integration by creating or updating the QWEN.md file
+     * with OpenSpec instructions and markers.
+     *
+     * @param {string} projectPath - The path to the project root
+     * @param {string} _openspecDir - The path to the openspec directory (unused)
+     * @returns {Promise<void>} A promise that resolves when configuration is complete
+     */
+    async configure(projectPath, _openspecDir) {
+        const filePath = path.join(projectPath, this.configFileName);
+        const content = TemplateManager.getAgentsStandardTemplate();
+        await FileSystemUtils.updateFileWithMarkers(filePath, content, OPENSPEC_MARKERS.start, OPENSPEC_MARKERS.end);
+    }
+}
+//# sourceMappingURL=qwen.js.map

package/dist/core/configurators/registry.js

@@ -1,19 +1,28 @@
 import { ClaudeConfigurator } from './claude.js';
 import { ClineConfigurator } from './cline.js';
 import { CodeBuddyConfigurator } from './codebuddy.js';
+import { CostrictConfigurator } from './costrict.js';
+import { QoderConfigurator } from './qoder.js';
 import { AgentsStandardConfigurator } from './agents.js';
+import { QwenConfigurator } from './qwen.js';
 export class ToolRegistry {
     static tools = new Map();
     static {
         const claudeConfigurator = new ClaudeConfigurator();
         const clineConfigurator = new ClineConfigurator();
         const codeBuddyConfigurator = new CodeBuddyConfigurator();
+        const costrictConfigurator = new CostrictConfigurator();
+        const qoderConfigurator = new QoderConfigurator();
         const agentsConfigurator = new AgentsStandardConfigurator();
+        const qwenConfigurator = new QwenConfigurator();
         // Register with the ID that matches the checkbox value
         this.tools.set('claude', claudeConfigurator);
         this.tools.set('cline', clineConfigurator);
         this.tools.set('codebuddy', codeBuddyConfigurator);
+        this.tools.set('costrict', costrictConfigurator);
+        this.tools.set('qoder', qoderConfigurator);
         this.tools.set('agents', agentsConfigurator);
+        this.tools.set('qwen', qwenConfigurator);
     }
     static register(tool) {
         this.tools.set(tool.name.toLowerCase().replace(/\s+/g, '-'), tool);

package/dist/core/configurators/slash/cline.js

@@ -1,8 +1,8 @@
 import { SlashCommandConfigurator } from './base.js';
 const FILE_PATHS = {
-    proposal: '.clinerules/openspec-proposal.md',
-    apply: '.clinerules/openspec-apply.md',
-    archive: '.clinerules/openspec-archive.md'
+    proposal: '.clinerules/workflows/openspec-proposal.md',
+    apply: '.clinerules/workflows/openspec-apply.md',
+    archive: '.clinerules/workflows/openspec-archive.md'
 };
 export class ClineSlashCommandConfigurator extends SlashCommandConfigurator {
     toolId = 'cline';

package/dist/core/configurators/slash/costrict.d.ts

@@ -0,0 +1,9 @@
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+export declare class CostrictSlashCommandConfigurator extends SlashCommandConfigurator {
+    readonly toolId = "costrict";
+    readonly isAvailable = true;
+    protected getRelativePath(id: SlashCommandId): string;
+    protected getFrontmatter(id: SlashCommandId): string | undefined;
+}
+//# sourceMappingURL=costrict.d.ts.map

package/dist/core/configurators/slash/costrict.js

@@ -0,0 +1,31 @@
+import { SlashCommandConfigurator } from './base.js';
+const FILE_PATHS = {
+    proposal: '.cospec/openspec/commands/openspec-proposal.md',
+    apply: '.cospec/openspec/commands/openspec-apply.md',
+    archive: '.cospec/openspec/commands/openspec-archive.md',
+};
+const FRONTMATTER = {
+    proposal: `---
+description: "Scaffold a new OpenSpec change and validate strictly."
+argument-hint: feature description or request
+---`,
+    apply: `---
+description: "Implement an approved OpenSpec change and keep tasks in sync."
+argument-hint: change-id
+---`,
+    archive: `---
+description: "Archive a deployed OpenSpec change and update specs."
+argument-hint: change-id
+---`
+};
+export class CostrictSlashCommandConfigurator extends SlashCommandConfigurator {
+    toolId = 'costrict';
+    isAvailable = true;
+    getRelativePath(id) {
+        return FILE_PATHS[id];
+    }
+    getFrontmatter(id) {
+        return FRONTMATTER[id];
+    }
+}
+//# sourceMappingURL=costrict.js.map

package/dist/core/configurators/slash/gemini.d.ts

@@ -0,0 +1,12 @@
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+export declare class GeminiSlashCommandConfigurator extends SlashCommandConfigurator {
+    readonly toolId = "gemini";
+    readonly isAvailable = true;
+    protected getRelativePath(id: SlashCommandId): string;
+    protected getFrontmatter(_id: SlashCommandId): string | undefined;
+    generateAll(projectPath: string, _openspecDir: string): Promise<string[]>;
+    private generateTOML;
+    protected updateBody(filePath: string, body: string): Promise<void>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/core/configurators/slash/gemini.js

@@ -0,0 +1,68 @@
+import { FileSystemUtils } from '../../../utils/file-system.js';
+import { SlashCommandConfigurator } from './base.js';
+import { OPENSPEC_MARKERS } from '../../config.js';
+const FILE_PATHS = {
+    proposal: '.gemini/commands/openspec/proposal.toml',
+    apply: '.gemini/commands/openspec/apply.toml',
+    archive: '.gemini/commands/openspec/archive.toml'
+};
+const DESCRIPTIONS = {
+    proposal: 'Scaffold a new OpenSpec change and validate strictly.',
+    apply: 'Implement an approved OpenSpec change and keep tasks in sync.',
+    archive: 'Archive a deployed OpenSpec change and update specs.'
+};
+export class GeminiSlashCommandConfigurator extends SlashCommandConfigurator {
+    toolId = 'gemini';
+    isAvailable = true;
+    getRelativePath(id) {
+        return FILE_PATHS[id];
+    }
+    getFrontmatter(_id) {
+        // TOML doesn't use separate frontmatter - it's all in one structure
+        return undefined;
+    }
+    // Override to generate TOML format with markers inside the prompt field
+    async generateAll(projectPath, _openspecDir) {
+        const createdOrUpdated = [];
+        for (const target of this.getTargets()) {
+            const body = this.getBody(target.id);
+            const filePath = FileSystemUtils.joinPath(projectPath, target.path);
+            if (await FileSystemUtils.fileExists(filePath)) {
+                await this.updateBody(filePath, body);
+            }
+            else {
+                const tomlContent = this.generateTOML(target.id, body);
+                await FileSystemUtils.writeFile(filePath, tomlContent);
+            }
+            createdOrUpdated.push(target.path);
+        }
+        return createdOrUpdated;
+    }
+    generateTOML(id, body) {
+        const description = DESCRIPTIONS[id];
+        // TOML format with triple-quoted string for multi-line prompt
+        // Markers are inside the prompt value
+        return `description = "${description}"
+
+prompt = """
+${OPENSPEC_MARKERS.start}
+${body}
+${OPENSPEC_MARKERS.end}
+"""
+`;
+    }
+    // Override updateBody to handle TOML format
+    async updateBody(filePath, body) {
+        const content = await FileSystemUtils.readFile(filePath);
+        const startIndex = content.indexOf(OPENSPEC_MARKERS.start);
+        const endIndex = content.indexOf(OPENSPEC_MARKERS.end);
+        if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
+            throw new Error(`Missing OpenSpec markers in ${filePath}`);
+        }
+        const before = content.slice(0, startIndex + OPENSPEC_MARKERS.start.length);
+        const after = content.slice(endIndex);
+        const updatedContent = `${before}\n${body}\n${after}`;
+        await FileSystemUtils.writeFile(filePath, updatedContent);
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/core/configurators/slash/opencode.js

@@ -19,7 +19,12 @@ The user has requested the following change proposal. Use the openspec instructi
     apply: `---
 agent: build
 description: Implement an approved OpenSpec change and keep tasks in sync.
----`,
+---
+The user has requested to implement the following change proposal. Find the change proposal and follow the instructions below. If you're not sure or if ambiguous, ask for clarification from the user.
+<UserRequest>
+  $ARGUMENTS
+</UserRequest>
+`,
     archive: `---
 agent: build
 description: Archive a deployed OpenSpec change and update specs.

package/dist/core/configurators/slash/qoder.d.ts

@@ -0,0 +1,35 @@
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+/**
+ * Qoder Slash Command Configurator
+ *
+ * Manages OpenSpec slash commands for Qoder AI assistant.
+ * Creates three workflow commands: proposal, apply, and archive.
+ * Uses colon-separated command format (/openspec:proposal).
+ *
+ * @extends {SlashCommandConfigurator}
+ */
+export declare class QoderSlashCommandConfigurator extends SlashCommandConfigurator {
+    /** Unique identifier for Qoder tool */
+    readonly toolId = "qoder";
+    /** Indicates slash commands are available for this tool */
+    readonly isAvailable = true;
+    /**
+     * Get relative file path for a slash command
+     *
+     * @param {SlashCommandId} id - Command identifier (proposal, apply, or archive)
+     * @returns {string} Relative path from project root to command file
+     */
+    protected getRelativePath(id: SlashCommandId): string;
+    /**
+     * Get YAML frontmatter for a slash command
+     *
+     * Frontmatter defines how the command appears in Qoder's UI,
+     * including display name, description, and categorization.
+     *
+     * @param {SlashCommandId} id - Command identifier (proposal, apply, or archive)
+     * @returns {string} YAML frontmatter block with command metadata
+     */
+    protected getFrontmatter(id: SlashCommandId): string;
+}
+//# sourceMappingURL=qoder.d.ts.map

package/dist/core/configurators/slash/qoder.js

@@ -0,0 +1,76 @@
+import { SlashCommandConfigurator } from './base.js';
+/**
+ * File paths for Qoder slash commands
+ * Maps each OpenSpec workflow stage to its command file location
+ * Commands are stored in .qoder/commands/openspec/ directory
+ */
+const FILE_PATHS = {
+    // Create and validate new change proposals
+    proposal: '.qoder/commands/openspec/proposal.md',
+    // Implement approved changes with task tracking
+    apply: '.qoder/commands/openspec/apply.md',
+    // Archive completed changes and update specs
+    archive: '.qoder/commands/openspec/archive.md'
+};
+/**
+ * YAML frontmatter for Qoder slash commands
+ * Defines metadata displayed in Qoder's command palette
+ * Each command is categorized and tagged for easy discovery
+ */
+const FRONTMATTER = {
+    proposal: `---
+name: OpenSpec: Proposal
+description: Scaffold a new OpenSpec change and validate strictly.
+category: OpenSpec
+tags: [openspec, change]
+---`,
+    apply: `---
+name: OpenSpec: Apply
+description: Implement an approved OpenSpec change and keep tasks in sync.
+category: OpenSpec
+tags: [openspec, apply]
+---`,
+    archive: `---
+name: OpenSpec: Archive
+description: Archive a deployed OpenSpec change and update specs.
+category: OpenSpec
+tags: [openspec, archive]
+---`
+};
+/**
+ * Qoder Slash Command Configurator
+ *
+ * Manages OpenSpec slash commands for Qoder AI assistant.
+ * Creates three workflow commands: proposal, apply, and archive.
+ * Uses colon-separated command format (/openspec:proposal).
+ *
+ * @extends {SlashCommandConfigurator}
+ */
+export class QoderSlashCommandConfigurator extends SlashCommandConfigurator {
+    /** Unique identifier for Qoder tool */
+    toolId = 'qoder';
+    /** Indicates slash commands are available for this tool */
+    isAvailable = true;
+    /**
+     * Get relative file path for a slash command
+     *
+     * @param {SlashCommandId} id - Command identifier (proposal, apply, or archive)
+     * @returns {string} Relative path from project root to command file
+     */
+    getRelativePath(id) {
+        return FILE_PATHS[id];
+    }
+    /**
+     * Get YAML frontmatter for a slash command
+     *
+     * Frontmatter defines how the command appears in Qoder's UI,
+     * including display name, description, and categorization.
+     *
+     * @param {SlashCommandId} id - Command identifier (proposal, apply, or archive)
+     * @returns {string} YAML frontmatter block with command metadata
+     */
+    getFrontmatter(id) {
+        return FRONTMATTER[id];
+    }
+}
+//# sourceMappingURL=qoder.js.map

package/dist/core/configurators/slash/qwen.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Qwen slash command configurator for OpenSpec integration.
+ * This class handles the generation of Qwen-specific slash command files
+ * in the .qwen/commands directory structure.
+ *
+ * @implements {SlashCommandConfigurator}
+ */
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+/**
+ * QwenSlashCommandConfigurator class provides integration with Qwen Code
+ * by creating the necessary slash command files in the .qwen/commands directory.
+ *
+ * The slash commands include:
+ * - /openspec-proposal: Create an OpenSpec change proposal
+ * - /openspec-apply: Apply an approved OpenSpec change
+ * - /openspec-archive: Archive a deployed OpenSpec change
+ */
+export declare class QwenSlashCommandConfigurator extends SlashCommandConfigurator {
+    /** Unique identifier for the Qwen tool */
+    readonly toolId = "qwen";
+    /** Availability status for the Qwen tool */
+    readonly isAvailable = true;
+    /**
+     * Returns the relative file path for a given slash command ID.
+     * @param {SlashCommandId} id - The slash command identifier
+     * @returns {string} The relative path to the command file
+     */
+    protected getRelativePath(id: SlashCommandId): string;
+    /**
+     * Returns the YAML frontmatter for a given slash command ID.
+     * @param {SlashCommandId} id - The slash command identifier
+     * @returns {string} The YAML frontmatter string
+     */
+    protected getFrontmatter(id: SlashCommandId): string;
+}
+//# sourceMappingURL=qwen.d.ts.map

package/dist/core/configurators/slash/qwen.js

@@ -0,0 +1,74 @@
+/**
+ * Qwen slash command configurator for OpenSpec integration.
+ * This class handles the generation of Qwen-specific slash command files
+ * in the .qwen/commands directory structure.
+ *
+ * @implements {SlashCommandConfigurator}
+ */
+import { SlashCommandConfigurator } from './base.js';
+/**
+ * Mapping of slash command IDs to their corresponding file paths in .qwen/commands directory.
+ * @type {Record<SlashCommandId, string>}
+ */
+const FILE_PATHS = {
+    proposal: '.qwen/commands/openspec-proposal.md',
+    apply: '.qwen/commands/openspec-apply.md',
+    archive: '.qwen/commands/openspec-archive.md'
+};
+/**
+ * YAML frontmatter definitions for Qwen command files.
+ * These provide metadata for each slash command to ensure proper recognition by Qwen Code.
+ * @type {Record<SlashCommandId, string>}
+ */
+const FRONTMATTER = {
+    proposal: `---
+name: /openspec-proposal
+id: openspec-proposal
+category: OpenSpec
+description: Scaffold a new OpenSpec change and validate strictly.
+---`,
+    apply: `---
+name: /openspec-apply
+id: openspec-apply
+category: OpenSpec
+description: Implement an approved OpenSpec change and keep tasks in sync.
+---`,
+    archive: `---
+name: /openspec-archive
+id: openspec-archive
+category: OpenSpec
+description: Archive a deployed OpenSpec change and update specs.
+---`
+};
+/**
+ * QwenSlashCommandConfigurator class provides integration with Qwen Code
+ * by creating the necessary slash command files in the .qwen/commands directory.
+ *
+ * The slash commands include:
+ * - /openspec-proposal: Create an OpenSpec change proposal
+ * - /openspec-apply: Apply an approved OpenSpec change
+ * - /openspec-archive: Archive a deployed OpenSpec change
+ */
+export class QwenSlashCommandConfigurator extends SlashCommandConfigurator {
+    /** Unique identifier for the Qwen tool */
+    toolId = 'qwen';
+    /** Availability status for the Qwen tool */
+    isAvailable = true;
+    /**
+     * Returns the relative file path for a given slash command ID.
+     * @param {SlashCommandId} id - The slash command identifier
+     * @returns {string} The relative path to the command file
+     */
+    getRelativePath(id) {
+        return FILE_PATHS[id];
+    }
+    /**
+     * Returns the YAML frontmatter for a given slash command ID.
+     * @param {SlashCommandId} id - The slash command identifier
+     * @returns {string} The YAML frontmatter string
+     */
+    getFrontmatter(id) {
+        return FRONTMATTER[id];
+    }
+}
+//# sourceMappingURL=qwen.js.map

package/dist/core/configurators/slash/registry.js

@@ -1,5 +1,6 @@
 import { ClaudeSlashCommandConfigurator } from './claude.js';
 import { CodeBuddySlashCommandConfigurator } from './codebuddy.js';
+import { QoderSlashCommandConfigurator } from './qoder.js';
 import { CursorSlashCommandConfigurator } from './cursor.js';
 import { WindsurfSlashCommandConfigurator } from './windsurf.js';
 import { KiloCodeSlashCommandConfigurator } from './kilocode.js';
@@ -8,14 +9,19 @@ import { CodexSlashCommandConfigurator } from './codex.js';
 import { GitHubCopilotSlashCommandConfigurator } from './github-copilot.js';
 import { AmazonQSlashCommandConfigurator } from './amazon-q.js';
 import { FactorySlashCommandConfigurator } from './factory.js';
+import { GeminiSlashCommandConfigurator } from './gemini.js';
 import { AuggieSlashCommandConfigurator } from './auggie.js';
 import { ClineSlashCommandConfigurator } from './cline.js';
 import { CrushSlashCommandConfigurator } from './crush.js';
+import { CostrictSlashCommandConfigurator } from './costrict.js';
+import { QwenSlashCommandConfigurator } from './qwen.js';
+import { RooCodeSlashCommandConfigurator } from './roocode.js';
 export class SlashCommandRegistry {
     static configurators = new Map();
     static {
         const claude = new ClaudeSlashCommandConfigurator();
         const codeBuddy = new CodeBuddySlashCommandConfigurator();
+        const qoder = new QoderSlashCommandConfigurator();
         const cursor = new CursorSlashCommandConfigurator();
         const windsurf = new WindsurfSlashCommandConfigurator();
         const kilocode = new KiloCodeSlashCommandConfigurator();
@@ -24,11 +30,16 @@ export class SlashCommandRegistry {
         const githubCopilot = new GitHubCopilotSlashCommandConfigurator();
         const amazonQ = new AmazonQSlashCommandConfigurator();
         const factory = new FactorySlashCommandConfigurator();
+        const gemini = new GeminiSlashCommandConfigurator();
         const auggie = new AuggieSlashCommandConfigurator();
         const cline = new ClineSlashCommandConfigurator();
         const crush = new CrushSlashCommandConfigurator();
+        const costrict = new CostrictSlashCommandConfigurator();
+        const qwen = new QwenSlashCommandConfigurator();
+        const roocode = new RooCodeSlashCommandConfigurator();
         this.configurators.set(claude.toolId, claude);
         this.configurators.set(codeBuddy.toolId, codeBuddy);
+        this.configurators.set(qoder.toolId, qoder);
         this.configurators.set(cursor.toolId, cursor);
         this.configurators.set(windsurf.toolId, windsurf);
         this.configurators.set(kilocode.toolId, kilocode);
@@ -37,9 +48,13 @@ export class SlashCommandRegistry {
         this.configurators.set(githubCopilot.toolId, githubCopilot);
         this.configurators.set(amazonQ.toolId, amazonQ);
         this.configurators.set(factory.toolId, factory);
+        this.configurators.set(gemini.toolId, gemini);
         this.configurators.set(auggie.toolId, auggie);
         this.configurators.set(cline.toolId, cline);
         this.configurators.set(crush.toolId, crush);
+        this.configurators.set(costrict.toolId, costrict);
+        this.configurators.set(qwen.toolId, qwen);
+        this.configurators.set(roocode.toolId, roocode);
     }
     static register(configurator) {
         this.configurators.set(configurator.toolId, configurator);

package/dist/core/configurators/slash/roocode.d.ts

@@ -0,0 +1,9 @@
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+export declare class RooCodeSlashCommandConfigurator extends SlashCommandConfigurator {
+    readonly toolId = "roocode";
+    readonly isAvailable = true;
+    protected getRelativePath(id: SlashCommandId): string;
+    protected getFrontmatter(id: SlashCommandId): string | undefined;
+}
+//# sourceMappingURL=roocode.d.ts.map

package/dist/core/configurators/slash/roocode.js

@@ -0,0 +1,23 @@
+import { SlashCommandConfigurator } from './base.js';
+const NEW_FILE_PATHS = {
+    proposal: '.roo/commands/openspec-proposal.md',
+    apply: '.roo/commands/openspec-apply.md',
+    archive: '.roo/commands/openspec-archive.md'
+};
+export class RooCodeSlashCommandConfigurator extends SlashCommandConfigurator {
+    toolId = 'roocode';
+    isAvailable = true;
+    getRelativePath(id) {
+        return NEW_FILE_PATHS[id];
+    }
+    getFrontmatter(id) {
+        const descriptions = {
+            proposal: 'Scaffold a new OpenSpec change and validate strictly.',
+            apply: 'Implement an approved OpenSpec change and keep tasks in sync.',
+            archive: 'Archive a deployed OpenSpec change and update specs.'
+        };
+        const description = descriptions[id];
+        return `# OpenSpec: ${id.charAt(0).toUpperCase() + id.slice(1)}\n\n${description}`;
+    }
+}
+//# sourceMappingURL=roocode.js.map

package/dist/core/init.d.ts

@@ -39,6 +39,8 @@ export declare class InitCommand {
     private isToolConfigured;
     private createDirectoryStructure;
     private generateFiles;
+    private ensureTemplateFiles;
+    private writeTemplateFiles;
     private configureAITools;
     private configureRootAgentsStub;
     private displaySuccessMessage;

package/dist/core/init.js

@@ -6,7 +6,7 @@ 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, OPENSPEC_MARKERS, } from './config.js';
 import { PALETTE } from './styles/palette.js';
 const PROGRESS_SPINNER = {
     interval: 80,
@@ -254,7 +254,7 @@ export class InitCommand {
         const openspecPath = path.join(projectPath, openspecDir);
         // Validation happens silently in the background
         const extendMode = await this.validate(projectPath, openspecPath);
-        const existingToolStates = await this.getExistingToolStates(projectPath);
+        const existingToolStates = await this.getExistingToolStates(projectPath, extendMode);
         this.renderBanner(extendMode);
         // Get configuration (after validation to avoid prompts if validation fails)
         const config = await this.getConfiguration(existingToolStates, extendMode);
@@ -276,7 +276,9 @@ export class InitCommand {
             });
         }
         else {
-            ora({ stream: process.stdout }).info(PALETTE.midGray('ℹ OpenSpec already initialized. Skipping base scaffolding.'));
+            ora({ stream: process.stdout }).info(PALETTE.midGray('ℹ OpenSpec already initialized. Checking for missing files...'));
+            await this.createDirectoryStructure(openspecPath);
+            await this.ensureTemplateFiles(openspecPath, config);
         }
         // Step 2: Configure AI tools
         const toolSpinner = this.startSpinner('Configuring AI tools...');
@@ -413,25 +415,64 @@ export class InitCommand {
             initialSelected,
         });
     }
-    async getExistingToolStates(projectPath) {
-        const states = {};
-        for (const tool of AI_TOOLS) {
-            states[tool.value] = await this.isToolConfigured(projectPath, tool.value);
+    async getExistingToolStates(projectPath, extendMode) {
+        // Fresh initialization - no tools configured yet
+        if (!extendMode) {
+            return Object.fromEntries(AI_TOOLS.map(t => [t.value, false]));
         }
-        return states;
+        // Extend mode - check all tools in parallel for better performance
+        const entries = await Promise.all(AI_TOOLS.map(async (t) => [t.value, await this.isToolConfigured(projectPath, t.value)]));
+        return Object.fromEntries(entries);
     }
     async isToolConfigured(projectPath, toolId) {
+        // A tool is only considered "configured by OpenSpec" if its files contain OpenSpec markers.
+        // For tools with both config files and slash commands, BOTH must have markers.
+        // For slash commands, at least one file with markers is sufficient (not all required).
+        // Helper to check if a file exists and contains OpenSpec markers
+        const fileHasMarkers = async (absolutePath) => {
+            try {
+                const content = await FileSystemUtils.readFile(absolutePath);
+                return content.includes(OPENSPEC_MARKERS.start) && content.includes(OPENSPEC_MARKERS.end);
+            }
+            catch {
+                return false;
+            }
+        };
+        let hasConfigFile = false;
+        let hasSlashCommands = false;
+        // Check if the tool has a config file with OpenSpec markers
         const configFile = ToolRegistry.get(toolId)?.configFileName;
-        if (configFile &&
-            (await FileSystemUtils.fileExists(path.join(projectPath, configFile))))
-            return true;
+        if (configFile) {
+            const configPath = path.join(projectPath, configFile);
+            hasConfigFile = (await FileSystemUtils.fileExists(configPath)) && (await fileHasMarkers(configPath));
+        }
+        // Check if any slash command file exists with OpenSpec markers
         const slashConfigurator = SlashCommandRegistry.get(toolId);
-        if (!slashConfigurator)
-            return false;
-        for (const target of slashConfigurator.getTargets()) {
-            const absolute = slashConfigurator.resolveAbsolutePath(projectPath, target.id);
-            if (await FileSystemUtils.fileExists(absolute))
-                return true;
+        if (slashConfigurator) {
+            for (const target of slashConfigurator.getTargets()) {
+                const absolute = slashConfigurator.resolveAbsolutePath(projectPath, target.id);
+                if ((await FileSystemUtils.fileExists(absolute)) && (await fileHasMarkers(absolute))) {
+                    hasSlashCommands = true;
+                    break; // At least one file with markers is sufficient
+                }
+            }
+        }
+        // Tool is only configured if BOTH exist with markers
+        // OR if the tool has no config file requirement (slash commands only)
+        // OR if the tool has no slash commands requirement (config file only)
+        const hasConfigFileRequirement = configFile !== undefined;
+        const hasSlashCommandRequirement = slashConfigurator !== undefined;
+        if (hasConfigFileRequirement && hasSlashCommandRequirement) {
+            // Both are required - both must be present with markers
+            return hasConfigFile && hasSlashCommands;
+        }
+        else if (hasConfigFileRequirement) {
+            // Only config file required
+            return hasConfigFile;
+        }
+        else if (hasSlashCommandRequirement) {
+            // Only slash commands required
+            return hasSlashCommands;
         }
         return false;
     }
@@ -447,12 +488,22 @@ export class InitCommand {
         }
     }
     async generateFiles(openspecPath, config) {
+        await this.writeTemplateFiles(openspecPath, config, false);
+    }
+    async ensureTemplateFiles(openspecPath, config) {
+        await this.writeTemplateFiles(openspecPath, config, true);
+    }
+    async writeTemplateFiles(openspecPath, config, skipExisting) {
         const context = {
         // Could be enhanced with prompts for project details
         };
         const templates = TemplateManager.getTemplates(context);
         for (const template of templates) {
             const filePath = path.join(openspecPath, template.path);
+            // Skip if file exists and we're in skipExisting mode
+            if (skipExisting && (await FileSystemUtils.fileExists(filePath))) {
+                continue;
+            }
             const content = typeof template.content === 'function'
                 ? template.content(context)
                 : template.content;

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

@@ -1,2 +1,2 @@
-export declare const agentsTemplate = "# OpenSpec Instructions\n\nInstructions for AI coding assistants using OpenSpec for spec-driven development.\n\n## TL;DR Quick Checklist\n\n- Search existing work: `openspec spec list --long`, `openspec list` (use `rg` only for full-text search)\n- Decide scope: new capability vs modify existing capability\n- Pick a unique `change-id`: kebab-case, verb-led (`add-`, `update-`, `remove-`, `refactor-`)\n- Scaffold: `proposal.md`, `tasks.md`, `design.md` (only if needed), and delta specs per affected capability\n- Write deltas: use `## ADDED|MODIFIED|REMOVED|RENAMED Requirements`; include at least one `#### Scenario:` per requirement\n- Validate: `openspec validate [change-id] --strict` and fix issues\n- Request approval: Do not start implementation until proposal is approved\n\n## Three-Stage Workflow\n\n### Stage 1: Creating Changes\nCreate proposal when you need to:\n- Add features or functionality\n- Make breaking changes (API, schema)\n- Change architecture or patterns  \n- Optimize performance (changes behavior)\n- Update security patterns\n\nTriggers (examples):\n- \"Help me create a change proposal\"\n- \"Help me plan a change\"\n- \"Help me create a proposal\"\n- \"I want to create a spec proposal\"\n- \"I want to create a spec\"\n\nLoose matching guidance:\n- Contains one of: `proposal`, `change`, `spec`\n- With one of: `create`, `plan`, `make`, `start`, `help`\n\nSkip proposal for:\n- Bug fixes (restore intended behavior)\n- Typos, formatting, comments\n- Dependency updates (non-breaking)\n- Configuration changes\n- Tests for existing behavior\n\n**Workflow**\n1. Review `openspec/project.md`, `openspec list`, and `openspec list --specs` to understand current context.\n2. Choose a unique verb-led `change-id` and scaffold `proposal.md`, `tasks.md`, optional `design.md`, and spec deltas under `openspec/changes/<id>/`.\n3. Draft spec deltas using `## ADDED|MODIFIED|REMOVED Requirements` with at least one `#### Scenario:` per requirement.\n4. Run `openspec validate <id> --strict` and resolve any issues before sharing the proposal.\n\n### Stage 2: Implementing Changes\nTrack these steps as TODOs and complete them one by one.\n1. **Read proposal.md** - Understand what's being built\n2. **Read design.md** (if exists) - Review technical decisions\n3. **Read tasks.md** - Get implementation checklist\n4. **Implement tasks sequentially** - Complete in order\n5. **Confirm completion** - Ensure every item in `tasks.md` is finished before updating statuses\n6. **Update checklist** - After all work is done, set every task to `- [x]` so the list reflects reality\n7. **Approval gate** - Do not start implementation until the proposal is reviewed and approved\n\n### Stage 3: Archiving Changes\nAfter deployment, create separate PR to:\n- Move `changes/[name]/` \u2192 `changes/archive/YYYY-MM-DD-[name]/`\n- Update `specs/` if capabilities changed\n- Use `openspec archive <change-id> --skip-specs --yes` for tooling-only changes (always pass the change ID explicitly)\n- Run `openspec validate --strict` to confirm the archived change passes checks\n\n## Before Any Task\n\n**Context Checklist:**\n- [ ] Read relevant specs in `specs/[capability]/spec.md`\n- [ ] Check pending changes in `changes/` for conflicts\n- [ ] Read `openspec/project.md` for conventions\n- [ ] Run `openspec list` to see active changes\n- [ ] Run `openspec list --specs` to see existing capabilities\n\n**Before Creating Specs:**\n- Always check if capability already exists\n- Prefer modifying existing specs over creating duplicates\n- Use `openspec show [spec]` to review current state\n- If request is ambiguous, ask 1\u20132 clarifying questions before scaffolding\n\n### Search Guidance\n- Enumerate specs: `openspec spec list --long` (or `--json` for scripts)\n- Enumerate changes: `openspec list` (or `openspec change list --json` - deprecated but available)\n- Show details:\n  - Spec: `openspec show <spec-id> --type spec` (use `--json` for filters)\n  - Change: `openspec show <change-id> --json --deltas-only`\n- Full-text search (use ripgrep): `rg -n \"Requirement:|Scenario:\" openspec/specs`\n\n## Quick Start\n\n### CLI Commands\n\n```bash\n# Essential commands\nopenspec list                  # List active changes\nopenspec list --specs          # List specifications\nopenspec show [item]           # Display change or spec\nopenspec validate [item]       # Validate changes or specs\nopenspec archive <change-id> [--yes|-y]   # Archive after deployment (add --yes for non-interactive runs)\n\n# Project management\nopenspec init [path]           # Initialize OpenSpec\nopenspec update [path]         # Update instruction files\n\n# Interactive mode\nopenspec show                  # Prompts for selection\nopenspec validate              # Bulk validation mode\n\n# Debugging\nopenspec show [change] --json --deltas-only\nopenspec validate [change] --strict\n```\n\n### Command Flags\n\n- `--json` - Machine-readable output\n- `--type change|spec` - Disambiguate items\n- `--strict` - Comprehensive validation\n- `--no-interactive` - Disable prompts\n- `--skip-specs` - Archive without spec updates\n- `--yes`/`-y` - Skip confirmation prompts (non-interactive archive)\n\n## Directory Structure\n\n```\nopenspec/\n\u251C\u2500\u2500 project.md              # Project conventions\n\u251C\u2500\u2500 specs/                  # Current truth - what IS built\n\u2502   \u2514\u2500\u2500 [capability]/       # Single focused capability\n\u2502       \u251C\u2500\u2500 spec.md         # Requirements and scenarios\n\u2502       \u2514\u2500\u2500 design.md       # Technical patterns\n\u251C\u2500\u2500 changes/                # Proposals - what SHOULD change\n\u2502   \u251C\u2500\u2500 [change-name]/\n\u2502   \u2502   \u251C\u2500\u2500 proposal.md     # Why, what, impact\n\u2502   \u2502   \u251C\u2500\u2500 tasks.md        # Implementation checklist\n\u2502   \u2502   \u251C\u2500\u2500 design.md       # Technical decisions (optional; see criteria)\n\u2502   \u2502   \u2514\u2500\u2500 specs/          # Delta changes\n\u2502   \u2502       \u2514\u2500\u2500 [capability]/\n\u2502   \u2502           \u2514\u2500\u2500 spec.md # ADDED/MODIFIED/REMOVED\n\u2502   \u2514\u2500\u2500 archive/            # Completed changes\n```\n\n## Creating Change Proposals\n\n### Decision Tree\n\n```\nNew request?\n\u251C\u2500 Bug fix restoring spec behavior? \u2192 Fix directly\n\u251C\u2500 Typo/format/comment? \u2192 Fix directly  \n\u251C\u2500 New feature/capability? \u2192 Create proposal\n\u251C\u2500 Breaking change? \u2192 Create proposal\n\u251C\u2500 Architecture change? \u2192 Create proposal\n\u2514\u2500 Unclear? \u2192 Create proposal (safer)\n```\n\n### Proposal Structure\n\n1. **Create directory:** `changes/[change-id]/` (kebab-case, verb-led, unique)\n\n2. **Write proposal.md:**\n```markdown\n## Why\n[1-2 sentences on problem/opportunity]\n\n## What Changes\n- [Bullet list of changes]\n- [Mark breaking changes with **BREAKING**]\n\n## Impact\n- Affected specs: [list capabilities]\n- Affected code: [key files/systems]\n```\n\n3. **Create spec deltas:** `specs/[capability]/spec.md`\n```markdown\n## ADDED Requirements\n### Requirement: New Feature\nThe system SHALL provide...\n\n#### Scenario: Success case\n- **WHEN** user performs action\n- **THEN** expected result\n\n## MODIFIED Requirements\n### Requirement: Existing Feature\n[Complete modified requirement]\n\n## REMOVED Requirements\n### Requirement: Old Feature\n**Reason**: [Why removing]\n**Migration**: [How to handle]\n```\nIf multiple capabilities are affected, create multiple delta files under `changes/[change-id]/specs/<capability>/spec.md`\u2014one per capability.\n\n4. **Create tasks.md:**\n```markdown\n## 1. Implementation\n- [ ] 1.1 Create database schema\n- [ ] 1.2 Implement API endpoint\n- [ ] 1.3 Add frontend component\n- [ ] 1.4 Write tests\n```\n\n5. **Create design.md when needed:**\nCreate `design.md` if any of the following apply; otherwise omit it:\n- Cross-cutting change (multiple services/modules) or a new architectural pattern\n- New external dependency or significant data model changes\n- Security, performance, or migration complexity\n- Ambiguity that benefits from technical decisions before coding\n\nMinimal `design.md` skeleton:\n```markdown\n## Context\n[Background, constraints, stakeholders]\n\n## Goals / Non-Goals\n- Goals: [...]\n- Non-Goals: [...]\n\n## Decisions\n- Decision: [What and why]\n- Alternatives considered: [Options + rationale]\n\n## Risks / Trade-offs\n- [Risk] \u2192 Mitigation\n\n## Migration Plan\n[Steps, rollback]\n\n## Open Questions\n- [...]\n```\n\n## Spec File Format\n\n### Critical: Scenario Formatting\n\n**CORRECT** (use #### headers):\n```markdown\n#### Scenario: User login success\n- **WHEN** valid credentials provided\n- **THEN** return JWT token\n```\n\n**WRONG** (don't use bullets or bold):\n```markdown\n- **Scenario: User login**  \u274C\n**Scenario**: User login     \u274C\n### Scenario: User login      \u274C\n```\n\nEvery requirement MUST have at least one scenario.\n\n### Requirement Wording\n- Use SHALL/MUST for normative requirements (avoid should/may unless intentionally non-normative)\n\n### Delta Operations\n\n- `## ADDED Requirements` - New capabilities\n- `## MODIFIED Requirements` - Changed behavior\n- `## REMOVED Requirements` - Deprecated features\n- `## RENAMED Requirements` - Name changes\n\nHeaders matched with `trim(header)` - whitespace ignored.\n\n#### When to use ADDED vs MODIFIED\n- ADDED: Introduces a new capability or sub-capability that can stand alone as a requirement. Prefer ADDED when the change is orthogonal (e.g., adding \"Slash Command Configuration\") rather than altering the semantics of an existing requirement.\n- MODIFIED: Changes the behavior, scope, or acceptance criteria of an existing requirement. Always paste the full, updated requirement content (header + all scenarios). The archiver will replace the entire requirement with what you provide here; partial deltas will drop previous details.\n- RENAMED: Use when only the name changes. If you also change behavior, use RENAMED (name) plus MODIFIED (content) referencing the new name.\n\nCommon pitfall: Using MODIFIED to add a new concern without including the previous text. This causes loss of detail at archive time. If you aren\u2019t explicitly changing the existing requirement, add a new requirement under ADDED instead.\n\nAuthoring a MODIFIED requirement correctly:\n1) Locate the existing requirement in `openspec/specs/<capability>/spec.md`.\n2) Copy the entire requirement block (from `### Requirement: ...` through its scenarios).\n3) Paste it under `## MODIFIED Requirements` and edit to reflect the new behavior.\n4) Ensure the header text matches exactly (whitespace-insensitive) and keep at least one `#### Scenario:`.\n\nExample for RENAMED:\n```markdown\n## RENAMED Requirements\n- FROM: `### Requirement: Login`\n- TO: `### Requirement: User Authentication`\n```\n\n## Troubleshooting\n\n### Common Errors\n\n**\"Change must have at least one delta\"**\n- Check `changes/[name]/specs/` exists with .md files\n- Verify files have operation prefixes (## ADDED Requirements)\n\n**\"Requirement must have at least one scenario\"**\n- Check scenarios use `#### Scenario:` format (4 hashtags)\n- Don't use bullet points or bold for scenario headers\n\n**Silent scenario parsing failures**\n- Exact format required: `#### Scenario: Name`\n- Debug with: `openspec show [change] --json --deltas-only`\n\n### Validation Tips\n\n```bash\n# Always use strict mode for comprehensive checks\nopenspec validate [change] --strict\n\n# Debug delta parsing\nopenspec show [change] --json | jq '.deltas'\n\n# Check specific requirement\nopenspec show [spec] --json -r 1\n```\n\n## Happy Path Script\n\n```bash\n# 1) Explore current state\nopenspec spec list --long\nopenspec list\n# Optional full-text search:\n# rg -n \"Requirement:|Scenario:\" openspec/specs\n# rg -n \"^#|Requirement:\" openspec/changes\n\n# 2) Choose change id and scaffold\nCHANGE=add-two-factor-auth\nmkdir -p openspec/changes/$CHANGE/{specs/auth}\nprintf \"## Why\\n...\\n\\n## What Changes\\n- ...\\n\\n## Impact\\n- ...\\n\" > openspec/changes/$CHANGE/proposal.md\nprintf \"## 1. Implementation\\n- [ ] 1.1 ...\\n\" > openspec/changes/$CHANGE/tasks.md\n\n# 3) Add deltas (example)\ncat > openspec/changes/$CHANGE/specs/auth/spec.md << 'EOF'\n## ADDED Requirements\n### Requirement: Two-Factor Authentication\nUsers MUST provide a second factor during login.\n\n#### Scenario: OTP required\n- **WHEN** valid credentials are provided\n- **THEN** an OTP challenge is required\nEOF\n\n# 4) Validate\nopenspec validate $CHANGE --strict\n```\n\n## Multi-Capability Example\n\n```\nopenspec/changes/add-2fa-notify/\n\u251C\u2500\u2500 proposal.md\n\u251C\u2500\u2500 tasks.md\n\u2514\u2500\u2500 specs/\n    \u251C\u2500\u2500 auth/\n    \u2502   \u2514\u2500\u2500 spec.md   # ADDED: Two-Factor Authentication\n    \u2514\u2500\u2500 notifications/\n        \u2514\u2500\u2500 spec.md   # ADDED: OTP email notification\n```\n\nauth/spec.md\n```markdown\n## ADDED Requirements\n### Requirement: Two-Factor Authentication\n...\n```\n\nnotifications/spec.md\n```markdown\n## ADDED Requirements\n### Requirement: OTP Email Notification\n...\n```\n\n## Best Practices\n\n### Simplicity First\n- Default to <100 lines of new code\n- Single-file implementations until proven insufficient\n- Avoid frameworks without clear justification\n- Choose boring, proven patterns\n\n### Complexity Triggers\nOnly add complexity with:\n- Performance data showing current solution too slow\n- Concrete scale requirements (>1000 users, >100MB data)\n- Multiple proven use cases requiring abstraction\n\n### Clear References\n- Use `file.ts:42` format for code locations\n- Reference specs as `specs/auth/spec.md`\n- Link related changes and PRs\n\n### Capability Naming\n- Use verb-noun: `user-auth`, `payment-capture`\n- Single purpose per capability\n- 10-minute understandability rule\n- Split if description needs \"AND\"\n\n### Change ID Naming\n- Use kebab-case, short and descriptive: `add-two-factor-auth`\n- Prefer verb-led prefixes: `add-`, `update-`, `remove-`, `refactor-`\n- Ensure uniqueness; if taken, append `-2`, `-3`, etc.\n\n## Tool Selection Guide\n\n| Task | Tool | Why |\n|------|------|-----|\n| Find files by pattern | Glob | Fast pattern matching |\n| Search code content | Grep | Optimized regex search |\n| Read specific files | Read | Direct file access |\n| Explore unknown scope | Task | Multi-step investigation |\n\n## Error Recovery\n\n### Change Conflicts\n1. Run `openspec list` to see active changes\n2. Check for overlapping specs\n3. Coordinate with change owners\n4. Consider combining proposals\n\n### Validation Failures\n1. Run with `--strict` flag\n2. Check JSON output for details\n3. Verify spec file format\n4. Ensure scenarios properly formatted\n\n### Missing Context\n1. Read project.md first\n2. Check related specs\n3. Review recent archives\n4. Ask for clarification\n\n## Quick Reference\n\n### Stage Indicators\n- `changes/` - Proposed, not yet built\n- `specs/` - Built and deployed\n- `archive/` - Completed changes\n\n### File Purposes\n- `proposal.md` - Why and what\n- `tasks.md` - Implementation steps\n- `design.md` - Technical decisions\n- `spec.md` - Requirements and behavior\n\n### CLI Essentials\n```bash\nopenspec list              # What's in progress?\nopenspec show [item]       # View details\nopenspec validate --strict # Is it correct?\nopenspec archive <change-id> [--yes|-y]  # Mark complete (add --yes for automation)\n```\n\nRemember: Specs are truth. Changes are proposals. Keep them in sync.\n";
+export declare const agentsTemplate = "# OpenSpec Instructions\n\nInstructions for AI coding assistants using OpenSpec for spec-driven development.\n\n## TL;DR Quick Checklist\n\n- Search existing work: `openspec spec list --long`, `openspec list` (use `rg` only for full-text search)\n- Decide scope: new capability vs modify existing capability\n- Pick a unique `change-id`: kebab-case, verb-led (`add-`, `update-`, `remove-`, `refactor-`)\n- Scaffold: `proposal.md`, `tasks.md`, `design.md` (only if needed), and delta specs per affected capability\n- Write deltas: use `## ADDED|MODIFIED|REMOVED|RENAMED Requirements`; include at least one `#### Scenario:` per requirement\n- Validate: `openspec validate [change-id] --strict` and fix issues\n- Request approval: Do not start implementation until proposal is approved\n\n## Three-Stage Workflow\n\n### Stage 1: Creating Changes\nCreate proposal when you need to:\n- Add features or functionality\n- Make breaking changes (API, schema)\n- Change architecture or patterns  \n- Optimize performance (changes behavior)\n- Update security patterns\n\nTriggers (examples):\n- \"Help me create a change proposal\"\n- \"Help me plan a change\"\n- \"Help me create a proposal\"\n- \"I want to create a spec proposal\"\n- \"I want to create a spec\"\n\nLoose matching guidance:\n- Contains one of: `proposal`, `change`, `spec`\n- With one of: `create`, `plan`, `make`, `start`, `help`\n\nSkip proposal for:\n- Bug fixes (restore intended behavior)\n- Typos, formatting, comments\n- Dependency updates (non-breaking)\n- Configuration changes\n- Tests for existing behavior\n\n**Workflow**\n1. Review `openspec/project.md`, `openspec list`, and `openspec list --specs` to understand current context.\n2. Choose a unique verb-led `change-id` and scaffold `proposal.md`, `tasks.md`, optional `design.md`, and spec deltas under `openspec/changes/<id>/`.\n3. Draft spec deltas using `## ADDED|MODIFIED|REMOVED Requirements` with at least one `#### Scenario:` per requirement.\n4. Run `openspec validate <id> --strict` and resolve any issues before sharing the proposal.\n\n### Stage 2: Implementing Changes\nTrack these steps as TODOs and complete them one by one.\n1. **Read proposal.md** - Understand what's being built\n2. **Read design.md** (if exists) - Review technical decisions\n3. **Read tasks.md** - Get implementation checklist\n4. **Implement tasks sequentially** - Complete in order\n5. **Confirm completion** - Ensure every item in `tasks.md` is finished before updating statuses\n6. **Update checklist** - After all work is done, set every task to `- [x]` so the list reflects reality\n7. **Approval gate** - Do not start implementation until the proposal is reviewed and approved\n\n### Stage 3: Archiving Changes\nAfter deployment, create separate PR to:\n- Move `changes/[name]/` \u2192 `changes/archive/YYYY-MM-DD-[name]/`\n- Update `specs/` if capabilities changed\n- Use `openspec archive <change-id> --skip-specs --yes` for tooling-only changes (always pass the change ID explicitly)\n- Run `openspec validate --strict` to confirm the archived change passes checks\n\n## Before Any Task\n\n**Context Checklist:**\n- [ ] Read relevant specs in `specs/[capability]/spec.md`\n- [ ] Check pending changes in `changes/` for conflicts\n- [ ] Read `openspec/project.md` for conventions\n- [ ] Run `openspec list` to see active changes\n- [ ] Run `openspec list --specs` to see existing capabilities\n\n**Before Creating Specs:**\n- Always check if capability already exists\n- Prefer modifying existing specs over creating duplicates\n- Use `openspec show [spec]` to review current state\n- If request is ambiguous, ask 1\u20132 clarifying questions before scaffolding\n\n### Search Guidance\n- Enumerate specs: `openspec spec list --long` (or `--json` for scripts)\n- Enumerate changes: `openspec list` (or `openspec change list --json` - deprecated but available)\n- Show details:\n  - Spec: `openspec show <spec-id> --type spec` (use `--json` for filters)\n  - Change: `openspec show <change-id> --json --deltas-only`\n- Full-text search (use ripgrep): `rg -n \"Requirement:|Scenario:\" openspec/specs`\n\n## Quick Start\n\n### CLI Commands\n\n```bash\n# Essential commands\nopenspec list                  # List active changes\nopenspec list --specs          # List specifications\nopenspec show [item]           # Display change or spec\nopenspec validate [item]       # Validate changes or specs\nopenspec archive <change-id> [--yes|-y]   # Archive after deployment (add --yes for non-interactive runs)\n\n# Project management\nopenspec init [path]           # Initialize OpenSpec\nopenspec update [path]         # Update instruction files\n\n# Interactive mode\nopenspec show                  # Prompts for selection\nopenspec validate              # Bulk validation mode\n\n# Debugging\nopenspec show [change] --json --deltas-only\nopenspec validate [change] --strict\n```\n\n### Command Flags\n\n- `--json` - Machine-readable output\n- `--type change|spec` - Disambiguate items\n- `--strict` - Comprehensive validation\n- `--no-interactive` - Disable prompts\n- `--skip-specs` - Archive without spec updates\n- `--yes`/`-y` - Skip confirmation prompts (non-interactive archive)\n\n## Directory Structure\n\n```\nopenspec/\n\u251C\u2500\u2500 project.md              # Project conventions\n\u251C\u2500\u2500 specs/                  # Current truth - what IS built\n\u2502   \u2514\u2500\u2500 [capability]/       # Single focused capability\n\u2502       \u251C\u2500\u2500 spec.md         # Requirements and scenarios\n\u2502       \u2514\u2500\u2500 design.md       # Technical patterns\n\u251C\u2500\u2500 changes/                # Proposals - what SHOULD change\n\u2502   \u251C\u2500\u2500 [change-name]/\n\u2502   \u2502   \u251C\u2500\u2500 proposal.md     # Why, what, impact\n\u2502   \u2502   \u251C\u2500\u2500 tasks.md        # Implementation checklist\n\u2502   \u2502   \u251C\u2500\u2500 design.md       # Technical decisions (optional; see criteria)\n\u2502   \u2502   \u2514\u2500\u2500 specs/          # Delta changes\n\u2502   \u2502       \u2514\u2500\u2500 [capability]/\n\u2502   \u2502           \u2514\u2500\u2500 spec.md # ADDED/MODIFIED/REMOVED\n\u2502   \u2514\u2500\u2500 archive/            # Completed changes\n```\n\n## Creating Change Proposals\n\n### Decision Tree\n\n```\nNew request?\n\u251C\u2500 Bug fix restoring spec behavior? \u2192 Fix directly\n\u251C\u2500 Typo/format/comment? \u2192 Fix directly  \n\u251C\u2500 New feature/capability? \u2192 Create proposal\n\u251C\u2500 Breaking change? \u2192 Create proposal\n\u251C\u2500 Architecture change? \u2192 Create proposal\n\u2514\u2500 Unclear? \u2192 Create proposal (safer)\n```\n\n### Proposal Structure\n\n1. **Create directory:** `changes/[change-id]/` (kebab-case, verb-led, unique)\n\n2. **Write proposal.md:**\n```markdown\n# Change: [Brief description of change]\n\n## Why\n[1-2 sentences on problem/opportunity]\n\n## What Changes\n- [Bullet list of changes]\n- [Mark breaking changes with **BREAKING**]\n\n## Impact\n- Affected specs: [list capabilities]\n- Affected code: [key files/systems]\n```\n\n3. **Create spec deltas:** `specs/[capability]/spec.md`\n```markdown\n## ADDED Requirements\n### Requirement: New Feature\nThe system SHALL provide...\n\n#### Scenario: Success case\n- **WHEN** user performs action\n- **THEN** expected result\n\n## MODIFIED Requirements\n### Requirement: Existing Feature\n[Complete modified requirement]\n\n## REMOVED Requirements\n### Requirement: Old Feature\n**Reason**: [Why removing]\n**Migration**: [How to handle]\n```\nIf multiple capabilities are affected, create multiple delta files under `changes/[change-id]/specs/<capability>/spec.md`\u2014one per capability.\n\n4. **Create tasks.md:**\n```markdown\n## 1. Implementation\n- [ ] 1.1 Create database schema\n- [ ] 1.2 Implement API endpoint\n- [ ] 1.3 Add frontend component\n- [ ] 1.4 Write tests\n```\n\n5. **Create design.md when needed:**\nCreate `design.md` if any of the following apply; otherwise omit it:\n- Cross-cutting change (multiple services/modules) or a new architectural pattern\n- New external dependency or significant data model changes\n- Security, performance, or migration complexity\n- Ambiguity that benefits from technical decisions before coding\n\nMinimal `design.md` skeleton:\n```markdown\n## Context\n[Background, constraints, stakeholders]\n\n## Goals / Non-Goals\n- Goals: [...]\n- Non-Goals: [...]\n\n## Decisions\n- Decision: [What and why]\n- Alternatives considered: [Options + rationale]\n\n## Risks / Trade-offs\n- [Risk] \u2192 Mitigation\n\n## Migration Plan\n[Steps, rollback]\n\n## Open Questions\n- [...]\n```\n\n## Spec File Format\n\n### Critical: Scenario Formatting\n\n**CORRECT** (use #### headers):\n```markdown\n#### Scenario: User login success\n- **WHEN** valid credentials provided\n- **THEN** return JWT token\n```\n\n**WRONG** (don't use bullets or bold):\n```markdown\n- **Scenario: User login**  \u274C\n**Scenario**: User login     \u274C\n### Scenario: User login      \u274C\n```\n\nEvery requirement MUST have at least one scenario.\n\n### Requirement Wording\n- Use SHALL/MUST for normative requirements (avoid should/may unless intentionally non-normative)\n\n### Delta Operations\n\n- `## ADDED Requirements` - New capabilities\n- `## MODIFIED Requirements` - Changed behavior\n- `## REMOVED Requirements` - Deprecated features\n- `## RENAMED Requirements` - Name changes\n\nHeaders matched with `trim(header)` - whitespace ignored.\n\n#### When to use ADDED vs MODIFIED\n- ADDED: Introduces a new capability or sub-capability that can stand alone as a requirement. Prefer ADDED when the change is orthogonal (e.g., adding \"Slash Command Configuration\") rather than altering the semantics of an existing requirement.\n- MODIFIED: Changes the behavior, scope, or acceptance criteria of an existing requirement. Always paste the full, updated requirement content (header + all scenarios). The archiver will replace the entire requirement with what you provide here; partial deltas will drop previous details.\n- RENAMED: Use when only the name changes. If you also change behavior, use RENAMED (name) plus MODIFIED (content) referencing the new name.\n\nCommon pitfall: Using MODIFIED to add a new concern without including the previous text. This causes loss of detail at archive time. If you aren\u2019t explicitly changing the existing requirement, add a new requirement under ADDED instead.\n\nAuthoring a MODIFIED requirement correctly:\n1) Locate the existing requirement in `openspec/specs/<capability>/spec.md`.\n2) Copy the entire requirement block (from `### Requirement: ...` through its scenarios).\n3) Paste it under `## MODIFIED Requirements` and edit to reflect the new behavior.\n4) Ensure the header text matches exactly (whitespace-insensitive) and keep at least one `#### Scenario:`.\n\nExample for RENAMED:\n```markdown\n## RENAMED Requirements\n- FROM: `### Requirement: Login`\n- TO: `### Requirement: User Authentication`\n```\n\n## Troubleshooting\n\n### Common Errors\n\n**\"Change must have at least one delta\"**\n- Check `changes/[name]/specs/` exists with .md files\n- Verify files have operation prefixes (## ADDED Requirements)\n\n**\"Requirement must have at least one scenario\"**\n- Check scenarios use `#### Scenario:` format (4 hashtags)\n- Don't use bullet points or bold for scenario headers\n\n**Silent scenario parsing failures**\n- Exact format required: `#### Scenario: Name`\n- Debug with: `openspec show [change] --json --deltas-only`\n\n### Validation Tips\n\n```bash\n# Always use strict mode for comprehensive checks\nopenspec validate [change] --strict\n\n# Debug delta parsing\nopenspec show [change] --json | jq '.deltas'\n\n# Check specific requirement\nopenspec show [spec] --json -r 1\n```\n\n## Happy Path Script\n\n```bash\n# 1) Explore current state\nopenspec spec list --long\nopenspec list\n# Optional full-text search:\n# rg -n \"Requirement:|Scenario:\" openspec/specs\n# rg -n \"^#|Requirement:\" openspec/changes\n\n# 2) Choose change id and scaffold\nCHANGE=add-two-factor-auth\nmkdir -p openspec/changes/$CHANGE/{specs/auth}\nprintf \"## Why\\n...\\n\\n## What Changes\\n- ...\\n\\n## Impact\\n- ...\\n\" > openspec/changes/$CHANGE/proposal.md\nprintf \"## 1. Implementation\\n- [ ] 1.1 ...\\n\" > openspec/changes/$CHANGE/tasks.md\n\n# 3) Add deltas (example)\ncat > openspec/changes/$CHANGE/specs/auth/spec.md << 'EOF'\n## ADDED Requirements\n### Requirement: Two-Factor Authentication\nUsers MUST provide a second factor during login.\n\n#### Scenario: OTP required\n- **WHEN** valid credentials are provided\n- **THEN** an OTP challenge is required\nEOF\n\n# 4) Validate\nopenspec validate $CHANGE --strict\n```\n\n## Multi-Capability Example\n\n```\nopenspec/changes/add-2fa-notify/\n\u251C\u2500\u2500 proposal.md\n\u251C\u2500\u2500 tasks.md\n\u2514\u2500\u2500 specs/\n    \u251C\u2500\u2500 auth/\n    \u2502   \u2514\u2500\u2500 spec.md   # ADDED: Two-Factor Authentication\n    \u2514\u2500\u2500 notifications/\n        \u2514\u2500\u2500 spec.md   # ADDED: OTP email notification\n```\n\nauth/spec.md\n```markdown\n## ADDED Requirements\n### Requirement: Two-Factor Authentication\n...\n```\n\nnotifications/spec.md\n```markdown\n## ADDED Requirements\n### Requirement: OTP Email Notification\n...\n```\n\n## Best Practices\n\n### Simplicity First\n- Default to <100 lines of new code\n- Single-file implementations until proven insufficient\n- Avoid frameworks without clear justification\n- Choose boring, proven patterns\n\n### Complexity Triggers\nOnly add complexity with:\n- Performance data showing current solution too slow\n- Concrete scale requirements (>1000 users, >100MB data)\n- Multiple proven use cases requiring abstraction\n\n### Clear References\n- Use `file.ts:42` format for code locations\n- Reference specs as `specs/auth/spec.md`\n- Link related changes and PRs\n\n### Capability Naming\n- Use verb-noun: `user-auth`, `payment-capture`\n- Single purpose per capability\n- 10-minute understandability rule\n- Split if description needs \"AND\"\n\n### Change ID Naming\n- Use kebab-case, short and descriptive: `add-two-factor-auth`\n- Prefer verb-led prefixes: `add-`, `update-`, `remove-`, `refactor-`\n- Ensure uniqueness; if taken, append `-2`, `-3`, etc.\n\n## Tool Selection Guide\n\n| Task | Tool | Why |\n|------|------|-----|\n| Find files by pattern | Glob | Fast pattern matching |\n| Search code content | Grep | Optimized regex search |\n| Read specific files | Read | Direct file access |\n| Explore unknown scope | Task | Multi-step investigation |\n\n## Error Recovery\n\n### Change Conflicts\n1. Run `openspec list` to see active changes\n2. Check for overlapping specs\n3. Coordinate with change owners\n4. Consider combining proposals\n\n### Validation Failures\n1. Run with `--strict` flag\n2. Check JSON output for details\n3. Verify spec file format\n4. Ensure scenarios properly formatted\n\n### Missing Context\n1. Read project.md first\n2. Check related specs\n3. Review recent archives\n4. Ask for clarification\n\n## Quick Reference\n\n### Stage Indicators\n- `changes/` - Proposed, not yet built\n- `specs/` - Built and deployed\n- `archive/` - Completed changes\n\n### File Purposes\n- `proposal.md` - Why and what\n- `tasks.md` - Implementation steps\n- `design.md` - Technical decisions\n- `spec.md` - Requirements and behavior\n\n### CLI Essentials\n```bash\nopenspec list              # What's in progress?\nopenspec show [item]       # View details\nopenspec validate --strict # Is it correct?\nopenspec archive <change-id> [--yes|-y]  # Mark complete (add --yes for automation)\n```\n\nRemember: Specs are truth. Changes are proposals. Keep them in sync.\n";
 //# sourceMappingURL=agents-template.d.ts.map

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

@@ -160,6 +160,8 @@ New request?
 
 2. **Write proposal.md:**
 \`\`\`markdown
+# Change: [Brief description of change]
+
 ## Why
 [1-2 sentences on problem/opportunity]
 

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

@@ -0,0 +1,2 @@
+export { agentsRootStubTemplate as costrictTemplate } from './agents-root-stub.js';
+//# sourceMappingURL=costrict-template.d.ts.map

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

@@ -0,0 +1,2 @@
+export { agentsRootStubTemplate as costrictTemplate } from './agents-root-stub.js';
+//# sourceMappingURL=costrict-template.js.map

package/dist/core/templates/index.d.ts

@@ -8,6 +8,7 @@ export declare class TemplateManager {
     static getTemplates(context?: ProjectContext): Template[];
     static getClaudeTemplate(): string;
     static getClineTemplate(): string;
+    static getCostrictTemplate(): string;
     static getAgentsStandardTemplate(): string;
     static getSlashCommandBody(id: SlashCommandId): string;
 }

package/dist/core/templates/index.js

@@ -2,6 +2,7 @@ import { agentsTemplate } from './agents-template.js';
 import { projectTemplate } from './project-template.js';
 import { claudeTemplate } from './claude-template.js';
 import { clineTemplate } from './cline-template.js';
+import { costrictTemplate } from './costrict-template.js';
 import { agentsRootStubTemplate } from './agents-root-stub.js';
 import { getSlashCommandBody } from './slash-command-templates.js';
 export class TemplateManager {
@@ -23,6 +24,9 @@ export class TemplateManager {
     static getClineTemplate() {
         return clineTemplate;
     }
+    static getCostrictTemplate() {
+        return costrictTemplate;
+    }
     static getAgentsStandardTemplate() {
         return agentsRootStubTemplate;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -43,7 +43,7 @@
     "@changesets/cli": "^2.27.7",
     "@types/node": "^24.2.0",
     "@vitest/ui": "^3.2.4",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   },
   "dependencies": {