@fission-ai/openspec 1.13.1 → 1.14.0

package/dist/core/change-status-policy.js

@@ -10,14 +10,45 @@ export function summarizePlanningHome(planningHome) {
     };
 }
 export function buildActionContext(input) {
+    const scope = editScope(input);
+    // Keys stay in the published contract order.
     return {
         mode: 'repo-local',
         sourceOfTruth: 'repo',
         planningArtifacts: input.artifactIds,
         linkedContext: [],
-        allowedEditRoots: [input.projectRoot],
+        allowedEditRoots: scope.allowedEditRoots,
         requiresAffectedAreaSelection: false,
-        constraints: ['Repo-local change artifacts and implementation edits are scoped to this project.'],
+        constraints: scope.constraints,
+    };
+}
+/**
+ * A store holds planning artifacts only. The CLI does not route tasks to
+ * repos, so it names the declaring project on the current path as the edit
+ * root and has the agent ask before going anywhere else (#2013).
+ */
+function editScope(input) {
+    if (!input.store) {
+        return {
+            allowedEditRoots: [input.projectRoot],
+            constraints: ['Repo-local change artifacts and implementation edits are scoped to this project.'],
+        };
+    }
+    const planning = `Change artifacts live in store '${input.store.id}' (${input.projectRoot}).`;
+    const { implementationRoot } = input.store;
+    if (implementationRoot) {
+        return {
+            allowedEditRoots: [implementationRoot, input.projectRoot],
+            constraints: [
+                `${planning} Implementation edits go in ${implementationRoot}, the project on the current path that declares this store; ask the user before editing any other repository.`,
+            ],
+        };
+    }
+    return {
+        allowedEditRoots: [input.projectRoot],
+        constraints: [
+            `${planning} OpenSpec could not determine which repository implements this change; ask the user which repository to edit, and make implementation edits there.`,
+        ],
     };
 }
 export function resolveNextStep(input) {

package/dist/core/command-generation/adapters/atomcode.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AtomCode Command Adapter
+ *
+ * Formats project commands for AtomCode.
+ * https://github.com/atomgit-atomcode/atomcode#custom-commands
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * AtomCode adapter for command generation.
+ * File path: .atomcode/commands/opsx-<id>.md
+ * Frontmatter: name, description, args
+ *
+ * AtomCode's custom-command parser reads name and args literally without YAML
+ * unquoting, so these controlled identifiers must stay unquoted.
+ * The command name matches the filename.
+ *
+ * `args` mirrors what the workflow actually accepts. AtomCode executes an
+ * `args: none` command straight from the slash menu, while `optional` completes
+ * to `/name ` and waits for a second Enter. Advertising arguments a workflow
+ * never reads would cost every user that extra keystroke, so only workflows
+ * carrying an `**Input**:` contract declare `optional` and receive $ARGUMENTS.
+ */
+export declare const atomcodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=atomcode.d.ts.map

package/dist/core/command-generation/adapters/atomcode.js

@@ -0,0 +1,46 @@
+/**
+ * AtomCode Command Adapter
+ *
+ * Formats project commands for AtomCode.
+ * https://github.com/atomgit-atomcode/atomcode#custom-commands
+ */
+import path from 'path';
+import { stringify } from 'yaml';
+/** A workflow declares its invocation input with an `**Input**:` heading. */
+const INPUT_HEADING = /^\*\*Input\*\*:/m;
+/**
+ * AtomCode adapter for command generation.
+ * File path: .atomcode/commands/opsx-<id>.md
+ * Frontmatter: name, description, args
+ *
+ * AtomCode's custom-command parser reads name and args literally without YAML
+ * unquoting, so these controlled identifiers must stay unquoted.
+ * The command name matches the filename.
+ *
+ * `args` mirrors what the workflow actually accepts. AtomCode executes an
+ * `args: none` command straight from the slash menu, while `optional` completes
+ * to `/name ` and waits for a second Enter. Advertising arguments a workflow
+ * never reads would cost every user that extra keystroke, so only workflows
+ * carrying an `**Input**:` contract declare `optional` and receive $ARGUMENTS.
+ */
+export const atomcodeAdapter = {
+    toolId: 'atomcode',
+    getFilePath(commandId) {
+        return path.join('.atomcode', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        // Keep ordinary descriptions plain for the literal custom-command parser,
+        // while keeping special values valid YAML for frontmatter consumers.
+        const description = stringify({ description: content.description }, { lineWidth: 0, blockQuote: false });
+        const acceptsInput = INPUT_HEADING.test(content.body);
+        const argumentsBlock = acceptsInput ? '\n**Provided arguments**: $ARGUMENTS\n' : '';
+        return `---
+name: opsx-${content.id}
+${description}args: ${acceptsInput ? 'optional' : 'none'}
+---
+${argumentsBlock}
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=atomcode.js.map

package/dist/core/command-generation/adapters/codestudio.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Code Studio Command Adapter
+ *
+ * Formats commands for Syncfusion Code Studio following its .prompt.md specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Code Studio adapter for command generation.
+ * File path: .codestudio/prompts/opsx-<id>.prompt.md
+ * Frontmatter: description
+ */
+export declare const codeStudioAdapter: ToolCommandAdapter;
+//# sourceMappingURL=codestudio.d.ts.map

package/dist/core/command-generation/adapters/codestudio.js

@@ -0,0 +1,27 @@
+/**
+ * Code Studio Command Adapter
+ *
+ * Formats commands for Syncfusion Code Studio following its .prompt.md specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Code Studio adapter for command generation.
+ * File path: .codestudio/prompts/opsx-<id>.prompt.md
+ * Frontmatter: description
+ */
+export const codeStudioAdapter = {
+    toolId: 'codestudio',
+    getFilePath(commandId) {
+        return path.join('.codestudio', 'prompts', `opsx-${commandId}.prompt.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=codestudio.js.map

package/dist/core/command-generation/adapters/continue.js

@@ -16,12 +16,16 @@ export const continueAdapter = {
         return path.join('.continue', 'prompts', `opsx-${commandId}.prompt`);
     },
     formatFile(content) {
+        // Continue injects an invoked prompt into the model context. Smaller local
+        // models can otherwise mistake the workflow name for a tool to call (#925).
         return `---
 name: ${escapeYamlValue(`opsx-${content.id}`)}
 description: ${escapeYamlValue(content.description)}
 invokable: true
 ---
 
+This workflow prompt is already active. Follow its instructions directly. Do not call a tool named after this workflow.
+
 ${content.body}
 `;
     },

package/dist/core/command-generation/adapters/easycode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * EasyCode Command Adapter
+ *
+ * Formats commands for OrionStarAI/EasyCode using its TOML command format.
+ * https://github.com/OrionStarAI/EasyCode
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * EasyCode adapter for command generation.
+ * File path: .easycode/commands/opsx/<id>.toml
+ *
+ * Format:
+ *   description = "<basic-string>"         single-line, backslash/quote-safe
+ *   prompt = """<multiline-string>"""       multiline, backslash/triple-quote-safe
+ */
+export declare const easycodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=easycode.d.ts.map

package/dist/core/command-generation/adapters/easycode.js

@@ -0,0 +1,28 @@
+/**
+ * EasyCode Command Adapter
+ *
+ * Formats commands for OrionStarAI/EasyCode using its TOML command format.
+ * https://github.com/OrionStarAI/EasyCode
+ */
+import path from 'path';
+import { escapeTomlBasicString, escapeTomlMultilineBasicString } from '../toml.js';
+/**
+ * EasyCode adapter for command generation.
+ * File path: .easycode/commands/opsx/<id>.toml
+ *
+ * Format:
+ *   description = "<basic-string>"         single-line, backslash/quote-safe
+ *   prompt = """<multiline-string>"""       multiline, backslash/triple-quote-safe
+ */
+export const easycodeAdapter = {
+    toolId: 'easycode',
+    getFilePath(commandId) {
+        return path.join('.easycode', 'commands', 'opsx', `${commandId}.toml`);
+    },
+    formatFile(content) {
+        const safeDesc = escapeTomlBasicString(content.description);
+        const safeBody = escapeTomlMultilineBasicString(content.body);
+        return `description = "${safeDesc}"\n\nprompt = """\n${safeBody}\n"""\n`;
+    },
+};
+//# sourceMappingURL=easycode.js.map

package/dist/core/command-generation/adapters/gemini.js

@@ -4,41 +4,7 @@
  * Formats commands for Gemini CLI following its TOML specification.
  */
 import path from 'path';
-/**
- * Control characters (C0 except tab/newline/carriage return, plus DEL) are
- * invalid inside TOML strings and must be written as escapes.
- */
-const TOML_CONTROL_CHARS = new RegExp('[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]', 'g');
-/**
- * TOML basic strings are escape-active: a backslash or double quote in the
- * value breaks the file if written raw. Newlines cannot appear in a
- * single-line basic string at all, so they are escaped too.
- */
-function escapeTomlBasicString(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/"/g, '\\"')
-        .replace(/\n/g, '\\n')
-        .replace(/\r/g, '\\r')
-        .replace(/\t/g, '\\t')
-        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
-}
-/**
- * Multiline basic strings keep raw newlines and tabs, but backslashes are
- * still escape-active, any run of three quotes would end the string, and the
- * same control characters are invalid as in single-line basic strings — a
- * lone carriage return included (only LF and CRLF may appear raw; CRLF is
- * normalized away so the emitted file is single-convention). Escapes are
- * introduced after backslash-doubling so they are not re-doubled.
- */
-function escapeTomlMultilineBasicString(value) {
-    return value
-        .replace(/\r\n/g, '\n')
-        .replace(/\\/g, '\\\\')
-        .replace(/"""/g, '""\\"')
-        .replace(/\r/g, '\\r')
-        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
-}
+import { escapeTomlBasicString, escapeTomlMultilineBasicString } from '../toml.js';
 /**
  * Gemini adapter for command generation.
  * File path: .gemini/commands/opsx/<id>.toml

package/dist/core/command-generation/adapters/gigacode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GigaCode Command Adapter
+ *
+ * Formats commands for GigaCode using its Markdown custom command format.
+ * Project commands live in `.gigacode/commands/` and accept an optional
+ * `description` field in YAML frontmatter.
+ *
+ * @see https://gitverse.ru/docs/ai/ai-assistant-gigacode/gigacode-cli/commands
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * GigaCode adapter for command generation.
+ * File path: .gigacode/commands/opsx-<id>.md
+ * Format: Markdown with description frontmatter
+ */
+export declare const gigacodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=gigacode.d.ts.map

package/dist/core/command-generation/adapters/gigacode.js

@@ -0,0 +1,31 @@
+/**
+ * GigaCode Command Adapter
+ *
+ * Formats commands for GigaCode using its Markdown custom command format.
+ * Project commands live in `.gigacode/commands/` and accept an optional
+ * `description` field in YAML frontmatter.
+ *
+ * @see https://gitverse.ru/docs/ai/ai-assistant-gigacode/gigacode-cli/commands
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * GigaCode adapter for command generation.
+ * File path: .gigacode/commands/opsx-<id>.md
+ * Format: Markdown with description frontmatter
+ */
+export const gigacodeAdapter = {
+    toolId: 'gigacode',
+    getFilePath(commandId) {
+        return path.join('.gigacode', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=gigacode.js.map

package/dist/core/command-generation/adapters/index.d.ts

@@ -5,20 +5,24 @@
  */
 export { amazonQAdapter } from './amazon-q.js';
 export { antigravityAdapter } from './antigravity.js';
+export { atomcodeAdapter } from './atomcode.js';
 export { auggieAdapter } from './auggie.js';
 export { bobAdapter } from './bob.js';
 export { claudeAdapter } from './claude.js';
 export { clineAdapter } from './cline.js';
 export { commandCodeAdapter } from './command-code.js';
 export { codebuddyAdapter } from './codebuddy.js';
+export { codeStudioAdapter } from './codestudio.js';
 export { continueAdapter } from './continue.js';
 export { costrictAdapter } from './costrict.js';
 export { crushAdapter } from './crush.js';
 export { cursorAdapter } from './cursor.js';
 export { devinAdapter } from './devin.js';
+export { easycodeAdapter } from './easycode.js';
 export { factoryAdapter } from './factory.js';
 export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
+export { gigacodeAdapter } from './gigacode.js';
 export { iflowAdapter } from './iflow.js';
 export { junieAdapter } from './junie.js';
 export { kilocodeAdapter } from './kilocode.js';

package/dist/core/command-generation/adapters/index.js

@@ -5,20 +5,24 @@
  */
 export { amazonQAdapter } from './amazon-q.js';
 export { antigravityAdapter } from './antigravity.js';
+export { atomcodeAdapter } from './atomcode.js';
 export { auggieAdapter } from './auggie.js';
 export { bobAdapter } from './bob.js';
 export { claudeAdapter } from './claude.js';
 export { clineAdapter } from './cline.js';
 export { commandCodeAdapter } from './command-code.js';
 export { codebuddyAdapter } from './codebuddy.js';
+export { codeStudioAdapter } from './codestudio.js';
 export { continueAdapter } from './continue.js';
 export { costrictAdapter } from './costrict.js';
 export { crushAdapter } from './crush.js';
 export { cursorAdapter } from './cursor.js';
 export { devinAdapter } from './devin.js';
+export { easycodeAdapter } from './easycode.js';
 export { factoryAdapter } from './factory.js';
 export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
+export { gigacodeAdapter } from './gigacode.js';
 export { iflowAdapter } from './iflow.js';
 export { junieAdapter } from './junie.js';
 export { kilocodeAdapter } from './kilocode.js';

package/dist/core/command-generation/adapters/kilocode.d.ts

@@ -7,7 +7,7 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Kilo Code adapter for command generation.
- * File path: .kilocode/workflows/opsx-<id>.md
+ * File path: .kilo/command/opsx-<id>.md
  * Format: Plain markdown without frontmatter
  */
 export declare const kilocodeAdapter: ToolCommandAdapter;

package/dist/core/command-generation/adapters/kilocode.js

@@ -7,13 +7,13 @@
 import path from 'path';
 /**
  * Kilo Code adapter for command generation.
- * File path: .kilocode/workflows/opsx-<id>.md
+ * File path: .kilo/command/opsx-<id>.md
  * Format: Plain markdown without frontmatter
  */
 export const kilocodeAdapter = {
     toolId: 'kilocode',
     getFilePath(commandId) {
-        return path.join('.kilocode', 'workflows', `opsx-${commandId}.md`);
+        return path.join('.kilo', 'command', `opsx-${commandId}.md`);
     },
     formatFile(content) {
         return `${content.body}

package/dist/core/command-generation/registry.js

@@ -6,6 +6,7 @@
  */
 import { amazonQAdapter } from './adapters/amazon-q.js';
 import { antigravityAdapter } from './adapters/antigravity.js';
+import { atomcodeAdapter } from './adapters/atomcode.js';
 import { auggieAdapter } from './adapters/auggie.js';
 import { bobAdapter } from './adapters/bob.js';
 import { claudeAdapter } from './adapters/claude.js';
@@ -13,13 +14,16 @@ import { clineAdapter } from './adapters/cline.js';
 import { commandCodeAdapter } from './adapters/command-code.js';
 import { devinAdapter } from './adapters/devin.js';
 import { codebuddyAdapter } from './adapters/codebuddy.js';
+import { codeStudioAdapter } from './adapters/codestudio.js';
 import { continueAdapter } from './adapters/continue.js';
 import { costrictAdapter } from './adapters/costrict.js';
 import { crushAdapter } from './adapters/crush.js';
 import { cursorAdapter } from './adapters/cursor.js';
+import { easycodeAdapter } from './adapters/easycode.js';
 import { factoryAdapter } from './adapters/factory.js';
 import { geminiAdapter } from './adapters/gemini.js';
 import { githubCopilotAdapter } from './adapters/github-copilot.js';
+import { gigacodeAdapter } from './adapters/gigacode.js';
 import { iflowAdapter } from './adapters/iflow.js';
 import { junieAdapter } from './adapters/junie.js';
 import { kilocodeAdapter } from './adapters/kilocode.js';
@@ -43,6 +47,7 @@ export class CommandAdapterRegistry {
     static {
         CommandAdapterRegistry.register(amazonQAdapter);
         CommandAdapterRegistry.register(antigravityAdapter);
+        CommandAdapterRegistry.register(atomcodeAdapter);
         CommandAdapterRegistry.register(auggieAdapter);
         CommandAdapterRegistry.register(bobAdapter);
         CommandAdapterRegistry.register(claudeAdapter);
@@ -50,13 +55,16 @@ export class CommandAdapterRegistry {
         CommandAdapterRegistry.register(commandCodeAdapter);
         CommandAdapterRegistry.register(devinAdapter);
         CommandAdapterRegistry.register(codebuddyAdapter);
+        CommandAdapterRegistry.register(codeStudioAdapter);
         CommandAdapterRegistry.register(continueAdapter);
         CommandAdapterRegistry.register(costrictAdapter);
         CommandAdapterRegistry.register(crushAdapter);
         CommandAdapterRegistry.register(cursorAdapter);
+        CommandAdapterRegistry.register(easycodeAdapter);
         CommandAdapterRegistry.register(factoryAdapter);
         CommandAdapterRegistry.register(geminiAdapter);
         CommandAdapterRegistry.register(githubCopilotAdapter);
+        CommandAdapterRegistry.register(gigacodeAdapter);
         CommandAdapterRegistry.register(iflowAdapter);
         CommandAdapterRegistry.register(junieAdapter);
         CommandAdapterRegistry.register(kilocodeAdapter);

package/dist/core/command-generation/toml.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared TOML string escaping for command adapters.
+ */
+/**
+ * TOML basic strings are escape-active: a backslash or double quote in the
+ * value breaks the file if written raw. Newlines cannot appear in a
+ * single-line basic string at all, so they are escaped too.
+ */
+export declare function escapeTomlBasicString(value: string): string;
+/**
+ * Multiline basic strings keep raw newlines and tabs, but backslashes are
+ * still escape-active, any run of three quotes would end the string, and the
+ * same control characters are invalid as in single-line basic strings — a
+ * lone carriage return included (only LF and CRLF may appear raw; CRLF is
+ * normalized away so the emitted file is single-convention). Escapes are
+ * introduced after backslash-doubling so they are not re-doubled.
+ */
+export declare function escapeTomlMultilineBasicString(value: string): string;
+//# sourceMappingURL=toml.d.ts.map

package/dist/core/command-generation/toml.js

@@ -0,0 +1,39 @@
+/**
+ * Shared TOML string escaping for command adapters.
+ */
+/**
+ * Control characters (C0 except tab/newline/carriage return, plus DEL) are
+ * invalid inside TOML strings and must be written as escapes.
+ */
+const TOML_CONTROL_CHARS = new RegExp('[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]', 'g');
+/**
+ * TOML basic strings are escape-active: a backslash or double quote in the
+ * value breaks the file if written raw. Newlines cannot appear in a
+ * single-line basic string at all, so they are escaped too.
+ */
+export function escapeTomlBasicString(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+/**
+ * Multiline basic strings keep raw newlines and tabs, but backslashes are
+ * still escape-active, any run of three quotes would end the string, and the
+ * same control characters are invalid as in single-line basic strings — a
+ * lone carriage return included (only LF and CRLF may appear raw; CRLF is
+ * normalized away so the emitted file is single-convention). Escapes are
+ * introduced after backslash-doubling so they are not re-doubled.
+ */
+export function escapeTomlMultilineBasicString(value) {
+    return value
+        .replace(/\r\n/g, '\n')
+        .replace(/\\/g, '\\\\')
+        .replace(/"""/g, '""\\"')
+        .replace(/\r/g, '\\r')
+        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+//# sourceMappingURL=toml.js.map

package/dist/core/command-surface.js

@@ -13,7 +13,7 @@ export function resolveCommandSurfaceCapability(toolId) {
     if (CommandAdapterRegistry.has(toolId)) {
         return 'adapter-backed';
     }
-    if (toolId === 'codex') {
+    if (toolId === 'codex' || toolId === 'warp') {
         return 'skills-invocable';
     }
     return 'none';

package/dist/core/completions/command-registry.js

@@ -54,6 +54,17 @@ export const COMMAND_REGISTRY = [
             },
         ],
     },
+    {
+        name: 'version',
+        description: 'Report the installed OpenSpec version and update availability',
+        flags: [
+            COMMON_FLAGS.json,
+            {
+                name: 'check',
+                description: 'Check the registry for a newer version',
+            },
+        ],
+    },
     {
         name: 'list',
         description: 'List items (changes by default, or specs with --specs)',
@@ -66,6 +77,14 @@ export const COMMAND_REGISTRY = [
                 name: 'changes',
                 description: 'List changes explicitly (default)',
             },
+            {
+                name: 'archived',
+                description: 'Show only archived changes',
+            },
+            {
+                name: 'all',
+                description: 'Show both active and archived changes',
+            },
             {
                 name: 'sort',
                 description: 'Sort order: "recent" (default) or "name"',

package/dist/core/completions/installers/zsh-installer.js

@@ -194,8 +194,10 @@ export class ZshInstaller {
             }
             // Remove lines between markers (inclusive)
             lines.splice(startIndex, endIndex - startIndex + 1);
-            // Remove trailing empty lines at the start if the markers were at the top
-            while (lines.length > 0 && lines[0].trim() === '') {
+            // Install puts the block at the top of the file followed by one blank
+            // separator line; drop that line too so the file reads as it did before.
+            // Everything else, including blank lines the user had at the top, is left as is.
+            if (startIndex === 0 && lines.length > 0 && lines[0].trim() === '') {
                 lines.shift();
             }
             // Write back

package/dist/core/config-prompts.js

@@ -19,13 +19,13 @@ export function serializeConfig(config) {
     else {
         // Context section with comments
         lines.push('# Project context (optional)');
-        lines.push('# This is shown to AI when creating artifacts.');
-        lines.push('# Add your tech stack, conventions, style guides, domain knowledge, etc.');
+        lines.push('# Add only constraints that should guide OpenSpec artifacts and workflows.');
+        lines.push('# Include constraints an agent cannot infer by reading the code.');
+        lines.push('# Keep general project documentation and discoverable codebase facts out.');
         lines.push('# Example:');
         lines.push('#   context: |');
-        lines.push('#     Tech stack: TypeScript, React, Node.js');
-        lines.push('#     We use conventional commits');
-        lines.push('#     Domain: e-commerce platform');
+        lines.push('#     Designs and tasks must cover Windows, macOS, and Linux');
+        lines.push('#     Write all artifacts in Spanish');
         lines.push('');
     }
     // Rules section with comments
@@ -35,7 +35,7 @@ export function serializeConfig(config) {
     lines.push('#   rules:');
     lines.push('#     proposal:');
     lines.push('#       - Keep proposals under 500 words');
-    lines.push('#       - Always include a "Non-goals" section');
+    lines.push('#       - Always state what is out of scope');
     lines.push('#     tasks:');
     lines.push('#       - Break tasks into chunks of max 2 hours');
     lines.push('');