@fission-ai/openspec 0.6.0 → 0.7.0

package/README.md

@@ -84,6 +84,9 @@ These tools have built-in OpenSpec commands. Select the OpenSpec integration whe
 | **Claude Code** | `/openspec:proposal`, `/openspec:apply`, `/openspec:archive` |
 | **Cursor** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` |
 | **OpenCode** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` |
+| **Kilo Code** | `/openspec-proposal.md`, `/openspec-apply.md`, `/openspec-archive.md` (`.kilocode/workflows/`) |
+
+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`.
 
 #### AGENTS.md Compatible
 These tools automatically read workflow instructions from `openspec/AGENTS.md`. Ask them to follow the OpenSpec workflow if they need a reminder. Learn more about the [AGENTS.md convention](https://agents.md/).
@@ -121,8 +124,8 @@ openspec init
 ```
 
 **What happens during initialization:**
-- You'll be prompted to select your AI tool (Claude Code, Cursor, etc.)
-- OpenSpec automatically configures slash commands or `AGENTS.md` based on your selection
+- You'll be prompted to pick any natively supported AI tools (Claude Code, Cursor, OpenCode, 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
 
 **After setup:**

package/dist/core/config.js

@@ -4,9 +4,10 @@ export const OPENSPEC_MARKERS = {
     end: '<!-- OPENSPEC:END -->'
 };
 export const AI_TOOLS = [
-    { name: 'Claude Code (✅ OpenSpec custom slash commands available)', value: 'claude', available: true, successLabel: 'Claude Code' },
-    { name: 'Cursor (✅ OpenSpec custom slash commands available)', value: 'cursor', available: true, successLabel: 'Cursor' },
-    { name: 'OpenCode (✅ OpenSpec custom slash commands available)', value: 'opencode', available: true, successLabel: 'OpenCode' },
-    { name: 'AGENTS.md (works with Codex, Amp, Copilot, …)', value: 'agents', available: true, successLabel: 'your AGENTS.md-compatible assistant' }
+    { name: 'Claude Code', value: 'claude', available: true, successLabel: 'Claude Code' },
+    { name: 'Cursor', value: 'cursor', available: true, successLabel: 'Cursor' },
+    { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode' },
+    { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code' },
+    { name: 'AGENTS.md (works with Codex, Amp, VS Code, GitHub Copilot, …)', value: 'agents', available: false, successLabel: 'your AGENTS.md-compatible assistant' }
 ];
 //# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { SlashCommandConfigurator } from "./base.js";
+const FILE_PATHS = {
+    proposal: ".kilocode/workflows/openspec-proposal.md",
+    apply: ".kilocode/workflows/openspec-apply.md",
+    archive: ".kilocode/workflows/openspec-archive.md"
+};
+export class KiloCodeSlashCommandConfigurator extends SlashCommandConfigurator {
+    toolId = "kilocode";
+    isAvailable = true;
+    getRelativePath(id) {
+        return FILE_PATHS[id];
+    }
+    getFrontmatter(_id) {
+        return undefined;
+    }
+}
+//# sourceMappingURL=kilocode.js.map

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

@@ -1,14 +1,17 @@
 import { ClaudeSlashCommandConfigurator } from './claude.js';
 import { CursorSlashCommandConfigurator } from './cursor.js';
+import { KiloCodeSlashCommandConfigurator } from './kilocode.js';
 import { OpenCodeSlashCommandConfigurator } from './opencode.js';
 export class SlashCommandRegistry {
     static configurators = new Map();
     static {
         const claude = new ClaudeSlashCommandConfigurator();
         const cursor = new CursorSlashCommandConfigurator();
+        const kilocode = new KiloCodeSlashCommandConfigurator();
         const opencode = new OpenCodeSlashCommandConfigurator();
         this.configurators.set(claude.toolId, claude);
         this.configurators.set(cursor.toolId, cursor);
+        this.configurators.set(kilocode.toolId, kilocode);
         this.configurators.set(opencode.toolId, opencode);
     }
     static register(configurator) {

package/dist/core/init.d.ts

@@ -3,9 +3,16 @@ type ToolLabel = {
     annotation?: string;
 };
 type ToolWizardChoice = {
+    kind: 'heading' | 'info';
+    value: string;
+    label: ToolLabel;
+    selectable: false;
+} | {
+    kind: 'option';
     value: string;
     label: ToolLabel;
     configured: boolean;
+    selectable: true;
 };
 type ToolWizardConfig = {
     extendMode: boolean;
@@ -29,6 +36,7 @@ export declare class InitCommand {
     private createDirectoryStructure;
     private generateFiles;
     private configureAITools;
+    private configureRootAgentsStub;
     private displaySuccessMessage;
     private formatToolNames;
     private renderBanner;

package/dist/core/init.js

@@ -33,16 +33,27 @@ const parseToolLabel = (raw) => {
         annotation: match[2].trim(),
     };
 };
+const isSelectableChoice = (choice) => choice.selectable;
+const ROOT_STUB_CHOICE_VALUE = '__root_stub__';
+const OTHER_TOOLS_HEADING_VALUE = '__heading-other__';
+const LIST_SPACER_VALUE = '__list-spacer__';
 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 selectableChoices = config.choices.filter(isSelectableChoice);
+    const initialCursorIndex = config.choices.findIndex((choice) => choice.selectable);
+    const [cursor, setCursor] = useState(initialCursorIndex === -1 ? 0 : initialCursorIndex);
+    const [selected, setSelected] = useState(() => {
+        const initial = new Set((config.initialSelected ?? []).filter((value) => selectableChoices.some((choice) => choice.value === value)));
+        return selectableChoices
+            .map((choice) => choice.value)
+            .filter((value) => initial.has(value));
+    });
     const [error, setError] = useState(null);
     const selectedSet = new Set(selected);
-    const pageSize = Math.max(Math.min(config.choices.length, 7), 1);
+    const pageSize = Math.max(config.choices.length, 1);
     const updateSelected = (next) => {
-        const ordered = config.choices
+        const ordered = selectableChoices
             .map((choice) => choice.value)
             .filter((value) => next.has(value));
         setSelected(ordered);
@@ -51,8 +62,13 @@ const toolSelectionWizard = createPrompt((config, done) => {
         items: config.choices,
         active: cursor,
         pageSize,
-        loop: config.choices.length > 1,
+        loop: false,
         renderItem: ({ item, isActive }) => {
+            if (!item.selectable) {
+                const prefix = item.kind === 'info' ? '  ' : '';
+                const textColor = item.kind === 'heading' ? PALETTE.lightGray : PALETTE.midGray;
+                return `${PALETTE.midGray(' ')} ${PALETTE.midGray(' ')} ${textColor(`${prefix}${item.label.primary}`)}`;
+            }
             const isSelected = selectedSet.has(item.value);
             const cursorSymbol = isActive
                 ? PALETTE.white('›')
@@ -61,10 +77,32 @@ const toolSelectionWizard = createPrompt((config, done) => {
                 ? PALETTE.white('◉')
                 : PALETTE.midGray('○');
             const nameColor = isActive ? PALETTE.white : PALETTE.midGray;
-            const label = `${nameColor(item.label.primary)}${item.configured ? PALETTE.midGray(' (already configured)') : ''}`;
+            const annotation = item.label.annotation
+                ? PALETTE.midGray(` (${item.label.annotation})`)
+                : '';
+            const configuredNote = item.configured
+                ? PALETTE.midGray(' (already configured)')
+                : '';
+            const label = `${nameColor(item.label.primary)}${annotation}${configuredNote}`;
             return `${cursorSymbol} ${indicator} ${label}`;
         },
     });
+    const moveCursor = (direction) => {
+        if (selectableChoices.length === 0) {
+            return;
+        }
+        let nextIndex = cursor;
+        while (true) {
+            nextIndex = nextIndex + direction;
+            if (nextIndex < 0 || nextIndex >= config.choices.length) {
+                return;
+            }
+            if (config.choices[nextIndex]?.selectable) {
+                setCursor(nextIndex);
+                return;
+            }
+        }
+    };
     useKeypress((key) => {
         if (step === 'intro') {
             if (isEnterKey(key)) {
@@ -74,20 +112,18 @@ const toolSelectionWizard = createPrompt((config, done) => {
         }
         if (step === 'select') {
             if (isUpKey(key)) {
-                const previousIndex = cursor <= 0 ? config.choices.length - 1 : cursor - 1;
-                setCursor(previousIndex);
+                moveCursor(-1);
                 setError(null);
                 return;
             }
             if (isDownKey(key)) {
-                const nextIndex = cursor >= config.choices.length - 1 ? 0 : cursor + 1;
-                setCursor(nextIndex);
+                moveCursor(1);
                 setError(null);
                 return;
             }
             if (isSpaceKey(key)) {
                 const current = config.choices[cursor];
-                if (!current)
+                if (!current || !current.selectable)
                     return;
                 const next = new Set(selected);
                 if (next.has(current.value)) {
@@ -101,16 +137,13 @@ const toolSelectionWizard = createPrompt((config, done) => {
                 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([]);
+                const next = new Set();
+                updateSelected(next);
                 setError(null);
             }
             return;
@@ -119,7 +152,7 @@ const toolSelectionWizard = createPrompt((config, done) => {
             if (isEnterKey(key)) {
                 const finalSelection = config.choices
                     .map((choice) => choice.value)
-                    .filter((value) => selectedSet.has(value));
+                    .filter((value) => selectedSet.has(value) && value !== ROOT_STUB_CHOICE_VALUE);
                 done(finalSelection);
                 return;
             }
@@ -129,9 +162,21 @@ const toolSelectionWizard = createPrompt((config, done) => {
             }
         }
     });
-    const selectedNames = config.choices
-        .filter((choice) => selectedSet.has(choice.value))
-        .map((choice) => choice.label.primary);
+    const rootStubChoice = selectableChoices.find((choice) => choice.value === ROOT_STUB_CHOICE_VALUE);
+    const rootStubSelected = rootStubChoice
+        ? selectedSet.has(ROOT_STUB_CHOICE_VALUE)
+        : false;
+    const nativeChoices = selectableChoices.filter((choice) => choice.value !== ROOT_STUB_CHOICE_VALUE);
+    const selectedNativeChoices = nativeChoices.filter((choice) => selectedSet.has(choice.value));
+    const formatSummaryLabel = (choice) => {
+        const annotation = choice.label.annotation
+            ? PALETTE.midGray(` (${choice.label.annotation})`)
+            : '';
+        const configuredNote = choice.configured
+            ? PALETTE.midGray(' (already configured)')
+            : '';
+        return `${PALETTE.white(choice.label.primary)}${annotation}${configuredNote}`;
+    };
     const stepIndex = step === 'intro' ? 1 : step === 'select' ? 2 : 3;
     const lines = [];
     lines.push(PALETTE.midGray(`Step ${stepIndex}/${totalSteps}`));
@@ -154,13 +199,16 @@ const toolSelectionWizard = createPrompt((config, done) => {
         lines.push('');
         lines.push(page);
         lines.push('');
-        if (selectedNames.length === 0) {
-            lines.push(`${PALETTE.midGray('Selected')}: ${PALETTE.midGray('None selected yet')}`);
+        lines.push(PALETTE.midGray('Selected configuration:'));
+        if (rootStubSelected && rootStubChoice) {
+            lines.push(`  ${PALETTE.white('-')} ${formatSummaryLabel(rootStubChoice)}`);
+        }
+        if (selectedNativeChoices.length === 0) {
+            lines.push(`  ${PALETTE.midGray('- No natively supported providers selected')}`);
         }
         else {
-            lines.push(PALETTE.midGray('Selected:'));
-            selectedNames.forEach((name) => {
-                lines.push(`  ${PALETTE.white('-')} ${PALETTE.white(name)}`);
+            selectedNativeChoices.forEach((choice) => {
+                lines.push(`  ${PALETTE.white('-')} ${formatSummaryLabel(choice)}`);
             });
         }
     }
@@ -168,12 +216,15 @@ const toolSelectionWizard = createPrompt((config, done) => {
         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.'));
+        if (rootStubSelected && rootStubChoice) {
+            lines.push(`${PALETTE.white('▌')} ${formatSummaryLabel(rootStubChoice)}`);
+        }
+        if (selectedNativeChoices.length === 0) {
+            lines.push(PALETTE.midGray('No natively supported providers selected. Universal instructions will still be applied.'));
         }
         else {
-            selectedNames.forEach((name) => {
-                lines.push(`${PALETTE.white('▌')} ${PALETTE.white(name)}`);
+            selectedNativeChoices.forEach((choice) => {
+                lines.push(`${PALETTE.white('▌')} ${formatSummaryLabel(choice)}`);
             });
         }
     }
@@ -197,13 +248,6 @@ export class InitCommand {
         this.renderBanner(extendMode);
         // Get configuration (after validation to avoid prompts if validation fails)
         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));
@@ -226,13 +270,13 @@ export class InitCommand {
         }
         // Step 2: Configure AI tools
         const toolSpinner = this.startSpinner('Configuring AI tools...');
-        await this.configureAITools(projectPath, openspecDir, config.aiTools);
+        const rootStubStatus = await this.configureAITools(projectPath, openspecDir, config.aiTools);
         toolSpinner.stopAndPersist({
             symbol: PALETTE.white('▌'),
             text: PALETTE.white('AI tools configured'),
         });
         // Success message
-        this.displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode);
+        this.displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode, rootStubStatus);
     }
     async validate(projectPath, _openspecPath) {
         const extendMode = await FileSystemUtils.directoryExists(_openspecPath);
@@ -248,25 +292,64 @@ export class InitCommand {
     }
     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
+            ? 'Which natively supported AI tools would you like to add or refresh?'
+            : 'Which natively supported AI tools do you use?';
+        const initialNativeSelection = extendMode
             ? availableTools
                 .filter((tool) => existingTools[tool.value])
                 .map((tool) => tool.value)
             : [];
-        return this.prompt({
-            extendMode,
-            baseMessage,
-            choices: availableTools.map((tool) => ({
+        const initialSelected = Array.from(new Set(initialNativeSelection));
+        const choices = [
+            {
+                kind: 'heading',
+                value: '__heading-native__',
+                label: {
+                    primary: 'Natively supported providers (✔ OpenSpec custom slash commands available)',
+                },
+                selectable: false,
+            },
+            ...availableTools.map((tool) => ({
+                kind: 'option',
                 value: tool.value,
                 label: parseToolLabel(tool.name),
                 configured: Boolean(existingTools[tool.value]),
+                selectable: true,
             })),
+            ...(availableTools.length
+                ? [
+                    {
+                        kind: 'info',
+                        value: LIST_SPACER_VALUE,
+                        label: { primary: '' },
+                        selectable: false,
+                    },
+                ]
+                : []),
+            {
+                kind: 'heading',
+                value: OTHER_TOOLS_HEADING_VALUE,
+                label: {
+                    primary: 'Other tools (use Universal AGENTS.md for Codex, Amp, VS Code, GitHub Copilot, …)',
+                },
+                selectable: false,
+            },
+            {
+                kind: 'option',
+                value: ROOT_STUB_CHOICE_VALUE,
+                label: {
+                    primary: 'Universal AGENTS.md',
+                    annotation: 'always available',
+                },
+                configured: extendMode,
+                selectable: true,
+            },
+        ];
+        return this.prompt({
+            extendMode,
+            baseMessage,
+            choices,
             initialSelected,
         });
     }
@@ -316,6 +399,7 @@ export class InitCommand {
         }
     }
     async configureAITools(projectPath, openspecDir, toolIds) {
+        const rootStubStatus = await this.configureRootAgentsStub(projectPath, openspecDir);
         for (const toolId of toolIds) {
             const configurator = ToolRegistry.get(toolId);
             if (configurator && configurator.isAvailable) {
@@ -326,8 +410,19 @@ export class InitCommand {
                 await slashConfigurator.generateAll(projectPath, openspecDir);
             }
         }
+        return rootStubStatus;
     }
-    displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode) {
+    async configureRootAgentsStub(projectPath, openspecDir) {
+        const configurator = ToolRegistry.get('agents');
+        if (!configurator || !configurator.isAvailable) {
+            return 'skipped';
+        }
+        const stubPath = path.join(projectPath, configurator.configFileName);
+        const existed = await FileSystemUtils.fileExists(stubPath);
+        await configurator.configure(projectPath, openspecDir);
+        return existed ? 'updated' : 'created';
+    }
+    displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode, rootStubStatus) {
         console.log(); // Empty line for spacing
         const successHeadline = extendMode
             ? 'OpenSpec tool configuration updated!'
@@ -336,6 +431,12 @@ export class InitCommand {
         console.log();
         console.log(PALETTE.lightGray('Tool summary:'));
         const summaryLines = [
+            rootStubStatus === 'created'
+                ? `${PALETTE.white('▌')} ${PALETTE.white('Root AGENTS.md stub created for other assistants')}`
+                : null,
+            rootStubStatus === 'updated'
+                ? `${PALETTE.lightGray('▌')} ${PALETTE.lightGray('Root AGENTS.md stub refreshed for other assistants')}`
+                : null,
             created.length
                 ? `${PALETTE.white('▌')} ${PALETTE.white('Created:')} ${this.formatToolNames(created)}`
                 : null,
@@ -375,7 +476,7 @@ export class InitCommand {
             .map((tool) => tool.successLabel ?? tool.name)
             .filter((name) => Boolean(name));
         if (names.length === 0)
-            return PALETTE.lightGray('your AI assistant');
+            return PALETTE.lightGray('your AGENTS.md-compatible assistant');
         if (names.length === 1)
             return PALETTE.white(names[0]);
         const base = names.slice(0, -1).map((name) => PALETTE.white(name));

package/dist/core/templates/slash-command-templates.js

@@ -1,14 +1,14 @@
 const baseGuardrails = `**Guardrails**
 - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
 - Keep changes tightly scoped to the requested outcome.
-- Refer to \`openspec/AGENTS.md\` if you need additional OpenSpec conventions or clarifications.`;
+- Refer to \`openspec/AGENTS.md\` (located inside the \`openspec/\` directory—run \`ls openspec\` or \`openspec update\` if you don't see it) if you need additional OpenSpec conventions or clarifications.`;
 const proposalGuardrails = `${baseGuardrails}\n- Identify any vague or ambiguous details and ask the necessary follow-up questions before editing files.`;
 const proposalSteps = `**Steps**
 1. Review \`openspec/project.md\`, run \`openspec list\` and \`openspec list --specs\`, and inspect related code or docs (e.g., via \`rg\`/\`ls\`) to ground the proposal in current behaviour; note any gaps that require clarification.
 2. Choose a unique verb-led \`change-id\` and scaffold \`proposal.md\`, \`tasks.md\`, and \`design.md\` (when needed) under \`openspec/changes/<id>/\`.
 3. Map the change into concrete capabilities or requirements, breaking multi-scope efforts into distinct spec deltas with clear relationships and sequencing.
 4. Capture architectural reasoning in \`design.md\` when the solution spans multiple systems, introduces new patterns, or demands trade-off discussion before committing to specs.
-5. Draft spec deltas in \`changes/<id>/specs/\` using \`## ADDED|MODIFIED|REMOVED Requirements\` with at least one \`#### Scenario:\` per requirement and cross-reference related capabilities when relevant.
+5. Draft spec deltas in \`changes/<id>/specs/<capability>/spec.md\` (one folder per capability) using \`## ADDED|MODIFIED|REMOVED Requirements\` with at least one \`#### Scenario:\` per requirement and cross-reference related capabilities when relevant.
 6. Draft \`tasks.md\` as an ordered list of small, verifiable work items that deliver user-visible progress, include validation (tests, tooling), and highlight dependencies or parallelizable work.
 7. Validate with \`openspec validate <id> --strict\` and resolve every issue before sharing the proposal.`;
 const proposalReferences = `**Reference**

package/dist/core/validation/constants.d.ts

@@ -26,7 +26,7 @@ export declare const VALIDATION_MESSAGES: {
     readonly REQUIREMENT_TOO_LONG: "Requirement text is very long (>500 characters). Consider breaking it down.";
     readonly DELTA_DESCRIPTION_TOO_BRIEF: "Delta description is too brief";
     readonly DELTA_MISSING_REQUIREMENTS: "Delta should include requirements";
-    readonly GUIDE_NO_DELTAS: "No deltas found. Ensure your change has a specs/ directory with .md files using delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one \"#### Scenario:\" block. Tip: run \"openspec change show <change-id> --json --deltas-only\" to inspect parsed deltas.";
+    readonly GUIDE_NO_DELTAS: "No deltas found. Ensure your change has a specs/ directory with capability folders (e.g. specs/http-server/spec.md) containing .md files that use delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one \"#### Scenario:\" block. Tip: run \"openspec change show <change-id> --json --deltas-only\" to inspect parsed deltas.";
     readonly GUIDE_MISSING_SPEC_SECTIONS: "Missing required sections. Expected headers: \"## Purpose\" and \"## Requirements\". Example:\n## Purpose\n[brief purpose]\n\n## Requirements\n### Requirement: Clear requirement statement\nUsers SHALL ...\n\n#### Scenario: Descriptive name\n- **WHEN** ...\n- **THEN** ...";
     readonly GUIDE_MISSING_CHANGE_SECTIONS: "Missing required sections. Expected headers: \"## Why\" and \"## What Changes\". Ensure deltas are documented in specs/ using delta headers.";
     readonly GUIDE_SCENARIO_FORMAT: "Scenarios must use level-4 headers. Convert bullet lists into:\n#### Scenario: Short name\n- **WHEN** ...\n- **THEN** ...\n- **AND** ...";

package/dist/core/validation/constants.js

@@ -32,7 +32,7 @@ export const VALIDATION_MESSAGES = {
     DELTA_DESCRIPTION_TOO_BRIEF: 'Delta description is too brief',
     DELTA_MISSING_REQUIREMENTS: 'Delta should include requirements',
     // Guidance snippets (appended to primary messages for remediation)
-    GUIDE_NO_DELTAS: 'No deltas found. Ensure your change has a specs/ directory with .md files using delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one "#### Scenario:" block. Tip: run "openspec change show <change-id> --json --deltas-only" to inspect parsed deltas.',
+    GUIDE_NO_DELTAS: 'No deltas found. Ensure your change has a specs/ directory with capability folders (e.g. specs/http-server/spec.md) containing .md files that use delta headers (## ADDED/MODIFIED/REMOVED/RENAMED Requirements) and that each requirement includes at least one "#### Scenario:" block. Tip: run "openspec change show <change-id> --json --deltas-only" to inspect parsed deltas.',
     GUIDE_MISSING_SPEC_SECTIONS: 'Missing required sections. Expected headers: "## Purpose" and "## Requirements". Example:\n## Purpose\n[brief purpose]\n\n## Requirements\n### Requirement: Clear requirement statement\nUsers SHALL ...\n\n#### Scenario: Descriptive name\n- **WHEN** ...\n- **THEN** ...',
     GUIDE_MISSING_CHANGE_SECTIONS: 'Missing required sections. Expected headers: "## Why" and "## What Changes". Ensure deltas are documented in specs/ using delta headers.',
     GUIDE_SCENARIO_FORMAT: 'Scenarios must use level-4 headers. Convert bullet lists into:\n#### Scenario: Short name\n- **WHEN** ...\n- **THEN** ...\n- **AND** ...',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",