@ai-coders/context 0.3.0 → 0.3.1

package/README.md

@@ -4,6 +4,9 @@
 [![CI](https://github.com/vinilana/ai-coders-context/actions/workflows/ci.yml/badge.svg)](https://github.com/vinilana/ai-coders-context/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+<img width="663" height="192" alt="image" src="https://github.com/user-attachments/assets/4b07f61d-6800-420a-ae91-6e952cbc790d" />
+
+
 A lightweight CLI that scaffolds living documentation and AI-agent playbooks for any repository—no LLMs or API keys required. The generated structure gives teams a consistent starting point for knowledge sharing while keeping everything under version control.
 
 ## ⚙️ Requirements
@@ -54,6 +57,8 @@ npx @ai-coders/context plan release-readiness --output ./.context
 npx @ai-coders/context plan release-readiness --output ./.context --fill --dry-run
 ```
 
+> ℹ️ The CLI pings npm for fresh releases at startup. Set `AI_CONTEXT_DISABLE_UPDATE_CHECK=true` to skip the check.
+
 After running the command, inspect the generated structure:
 
 ```
@@ -123,7 +128,7 @@ Options:
   -k, --api-key <key>     API key for the selected LLM provider
   -m, --model <model>     LLM model to use (default: google/gemini-2.5-flash-preview-05-20)
   -p, --provider <name>   Provider (openrouter, openai, anthropic, gemini, grok)
-      --prompt <file>     Instruction prompt to follow (default: prompts/update_scaffold_prompt.md)
+      --prompt <file>     Instruction prompt to follow (optional; uses bundled instructions when omitted)
       --docs <keys...>    Doc keys to update (default: all)
       --agents <keys...>  Agent types to update (default: all)
       --dry-run           Preview changes without writing files
@@ -153,7 +158,7 @@ Options:
   -m, --model <model>     LLM model to use (default: x-ai/grok-4-fast:free)
   -p, --provider <name>   Provider (openrouter, openai, anthropic, gemini, grok)
       --base-url <url>    Custom base URL for provider APIs
-      --prompt <file>     Instruction prompt to follow (default: prompts/update_plan_prompt.md)
+      --prompt <file>     Instruction prompt to follow (optional; uses bundled instructions when omitted)
       --dry-run           Preview changes without writing files
       --include <patterns...>  Glob patterns to include during repository analysis
       --exclude <patterns...>  Glob patterns to exclude from repository analysis

package/dist/commands/shared/agents.d.ts

@@ -0,0 +1,2 @@
+export declare function getAgentFilesByTypes(types?: string[]): Set<string> | undefined;
+//# sourceMappingURL=agents.d.ts.map

package/dist/commands/shared/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/agents.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAW9E"}

package/dist/commands/shared/agents.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgentFilesByTypes = getAgentFilesByTypes;
+const agentTypes_1 = require("../../generators/agents/agentTypes");
+function getAgentFilesByTypes(types) {
+    if (!types || types.length === 0) {
+        return undefined;
+    }
+    const allowed = new Set(agentTypes_1.AGENT_TYPES);
+    const files = types
+        .filter(type => allowed.has(type))
+        .map(type => `${type}.md`);
+    return files.length ? new Set(files) : undefined;
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/shared/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/commands/shared/agents.ts"],"names":[],"mappings":";;AAEA,oDAWC;AAbD,mEAAiE;AAEjE,SAAgB,oBAAoB,CAAC,KAAgB;IACnD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,wBAAW,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK;SAChB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAkC,CAAC,CAAC;SAC/D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IAE7B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC"}

package/dist/commands/shared/selection.d.ts

@@ -0,0 +1,12 @@
+export interface SelectionParseResult {
+    selected?: string[];
+    invalid: string[];
+    provided: boolean;
+    explicitNone: boolean;
+}
+export declare function parseDocSelection(input: unknown): SelectionParseResult;
+export declare function parseAgentSelection(input: unknown): SelectionParseResult;
+export declare function shouldGenerateDocs(resolvedType: 'docs' | 'agents' | 'both', selection: SelectionParseResult): boolean;
+export declare function shouldGenerateAgents(resolvedType: 'docs' | 'agents' | 'both', selection: SelectionParseResult): boolean;
+export declare function determineScaffoldType(docSelection?: string[], agentSelection?: string[]): 'docs' | 'agents' | 'both';
+//# sourceMappingURL=selection.d.ts.map

package/dist/commands/shared/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/selection.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAmBtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAoBxE;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,EAAE,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAkBrH;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,EAAE,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAkBvH;AAED,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAOpH"}

package/dist/commands/shared/selection.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDocSelection = parseDocSelection;
+exports.parseAgentSelection = parseAgentSelection;
+exports.shouldGenerateDocs = shouldGenerateDocs;
+exports.shouldGenerateAgents = shouldGenerateAgents;
+exports.determineScaffoldType = determineScaffoldType;
+const guideRegistry_1 = require("../../generators/documentation/guideRegistry");
+const agentTypes_1 = require("../../generators/agents/agentTypes");
+function parseDocSelection(input) {
+    if (input === undefined) {
+        return { selected: undefined, invalid: [], provided: false, explicitNone: false };
+    }
+    if (Array.isArray(input) && input.length === 0) {
+        return { selected: [], invalid: [], provided: true, explicitNone: true };
+    }
+    const values = toStringArray(input);
+    const normalized = values.map(value => value.toLowerCase().replace(/\.md$/, ''));
+    const valid = Array.from(new Set(normalized.filter(key => guideRegistry_1.DOCUMENT_GUIDE_KEYS.includes(key))));
+    const invalid = normalized.filter(key => !guideRegistry_1.DOCUMENT_GUIDE_KEYS.includes(key));
+    if (values.length > 0 && valid.length === 0 && invalid.length > 0) {
+        return { selected: undefined, invalid, provided: true, explicitNone: false };
+    }
+    return { selected: valid.length > 0 ? valid : undefined, invalid, provided: true, explicitNone: false };
+}
+function parseAgentSelection(input) {
+    if (input === undefined) {
+        return { selected: undefined, invalid: [], provided: false, explicitNone: false };
+    }
+    if (Array.isArray(input) && input.length === 0) {
+        return { selected: [], invalid: [], provided: true, explicitNone: true };
+    }
+    const values = toStringArray(input);
+    const normalized = values.map(value => value.toLowerCase().replace(/\.md$/, ''));
+    const allowed = new Set(agentTypes_1.AGENT_TYPES);
+    const valid = Array.from(new Set(normalized.filter(value => allowed.has(value))));
+    const invalid = normalized.filter(value => !allowed.has(value));
+    if (values.length > 0 && valid.length === 0 && invalid.length > 0) {
+        return { selected: undefined, invalid, provided: true, explicitNone: false };
+    }
+    return { selected: valid.length > 0 ? valid : undefined, invalid, provided: true, explicitNone: false };
+}
+function shouldGenerateDocs(resolvedType, selection) {
+    if (selection.explicitNone) {
+        return false;
+    }
+    if (resolvedType === 'agents') {
+        return false;
+    }
+    if (!selection.provided) {
+        return resolvedType === 'docs' || resolvedType === 'both';
+    }
+    if (selection.selected && selection.selected.length === 0) {
+        return false;
+    }
+    return resolvedType === 'docs' || resolvedType === 'both';
+}
+function shouldGenerateAgents(resolvedType, selection) {
+    if (selection.explicitNone) {
+        return false;
+    }
+    if (resolvedType === 'docs') {
+        return false;
+    }
+    if (!selection.provided) {
+        return resolvedType === 'agents' || resolvedType === 'both';
+    }
+    if (selection.selected && selection.selected.length === 0) {
+        return false;
+    }
+    return resolvedType === 'agents' || resolvedType === 'both';
+}
+function determineScaffoldType(docSelection, agentSelection) {
+    const docsSelected = docSelection === undefined ? true : docSelection.length > 0;
+    const agentsSelected = agentSelection === undefined ? true : agentSelection.length > 0;
+    if (docsSelected && agentsSelected)
+        return 'both';
+    if (docsSelected)
+        return 'docs';
+    return 'agents';
+}
+function toStringArray(input) {
+    if (Array.isArray(input)) {
+        return input.map(item => item.toString().trim()).filter(Boolean);
+    }
+    if (input === null || input === undefined) {
+        return [];
+    }
+    return input
+        .toString()
+        .split(',')
+        .map(part => part.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=selection.js.map

package/dist/commands/shared/selection.js.map

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

package/dist/generators/plans/templates/planTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/plans/templates/planTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAkFvE"}
+{"version":3,"file":"planTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/plans/templates/planTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA8FvE"}

package/dist/generators/plans/templates/planTemplate.js

@@ -54,18 +54,30 @@ ${agentTableRows}
 | --- | --- | --- | --- |
 ${docsTableRows}
 
-## Working Stages
-### Stage 1 — Discovery & Alignment
-- TODO: Outline discovery tasks and the agent/owner who leads them.
-- TODO: Capture open questions that require clarification.
+## Working Phases
+### Phase 1 — Discovery & Alignment
+**Steps**
+1. TODO: Outline discovery tasks and assign the accountable owner.
+2. TODO: Capture open questions that require clarification.
 
-### Stage 2 — Implementation & Iteration
-- TODO: Note build tasks, pairing expectations, and review cadence.
-- TODO: Reference docs or playbooks to keep changes aligned.
+**Commit Checkpoint**
+- After completing this phase, capture the agreed context and create a commit (for example, \`git commit -m "chore(plan): complete phase 1 discovery"\`).
 
-### Stage 3 — Validation & Handoff
-- TODO: Detail testing, verification, and documentation updates.
-- TODO: Document evidence the team must capture for maintainers.
+### Phase 2 — Implementation & Iteration
+**Steps**
+1. TODO: Note build tasks, pairing expectations, and review cadence.
+2. TODO: Reference docs or playbooks to keep changes aligned.
+
+**Commit Checkpoint**
+- Summarize progress, update cross-links, and create a commit documenting the outcomes of this phase (for example, \`git commit -m "chore(plan): complete phase 2 implementation"\`).
+
+### Phase 3 — Validation & Handoff
+**Steps**
+1. TODO: Detail testing, verification, and documentation updates.
+2. TODO: Document evidence the team must capture for maintainers.
+
+**Commit Checkpoint**
+- Record the validation evidence and create a commit signalling the handoff completion (for example, \`git commit -m "chore(plan): complete phase 3 validation"\`).
 
 ## Agent Playbook Checklist
 1. Pick the agent that matches your task.

package/dist/generators/plans/templates/planTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"planTemplate.js","sourceRoot":"","sources":["../../../../src/generators/plans/templates/planTemplate.ts"],"names":[],"mappings":";;AAEA,gDAkFC;AAlFD,SAAgB,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEvD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM;QACjC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvD,CAAC,CAAC,4BAA4B,CAAC;IAEjC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM;QAClC,CAAC,CAAC,MAAM;aACH,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,KAAK,oDAAoD,KAAK,CAAC,KAAK,eAAe,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,cAAc,IAAI,CAAC;aACxJ,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,+KAA+K,CAAC;IAEpL,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM;QAC/B,CAAC,CAAC,IAAI;aACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,OAAO,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,aAAa,IAAI,CAAC;aAC1G,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,gHAAgH,CAAC;IAErH,OAAO;WACE,IAAI;gFACiE,KAAK;;;;;;;;;;EAUnF,aAAa;;;oBAGK,IAAI;IACpB,KAAK;;IAEL,OAAO,EAAE,IAAI,EAAE,IAAI,0EAA0E;;;;;;;;;;;;;EAa/F,cAAc;;;;;EAKd,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;qBAyBM,IAAI;CACxB,CAAC;AACF,CAAC"}
+{"version":3,"file":"planTemplate.js","sourceRoot":"","sources":["../../../../src/generators/plans/templates/planTemplate.ts"],"names":[],"mappings":";;AAEA,gDA8FC;AA9FD,SAAgB,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEvD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM;QACjC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvD,CAAC,CAAC,4BAA4B,CAAC;IAEjC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM;QAClC,CAAC,CAAC,MAAM;aACH,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,KAAK,oDAAoD,KAAK,CAAC,KAAK,eAAe,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,cAAc,IAAI,CAAC;aACxJ,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,+KAA+K,CAAC;IAEpL,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM;QAC/B,CAAC,CAAC,IAAI;aACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,OAAO,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,aAAa,IAAI,CAAC;aAC1G,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,gHAAgH,CAAC;IAErH,OAAO;WACE,IAAI;gFACiE,KAAK;;;;;;;;;;EAUnF,aAAa;;;oBAGK,IAAI;IACpB,KAAK;;IAEL,OAAO,EAAE,IAAI,EAAE,IAAI,0EAA0E;;;;;;;;;;;;;EAa/F,cAAc;;;;;EAKd,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAqCM,IAAI;CACxB,CAAC;AACF,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAwNA,iBAAe,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFrF;AA6BD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/E;AAED,wBAAsB,UAAU,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED,wBAAsB,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAED,wBAAsB,UAAU,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED,wBAAsB,aAAa,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA+OA,iBAAe,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFrF;AA6BD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/E;AAED,wBAAsB,UAAU,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED,wBAAsB,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAED,wBAAsB,UAAU,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED,wBAAsB,aAAa,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -56,6 +56,8 @@ const agentGenerator_1 = require("./generators/agents/agentGenerator");
 const planGenerator_1 = require("./generators/plans/planGenerator");
 const shared_1 = require("./generators/shared");
 const cliUI_1 = require("./utils/cliUI");
+const promptLoader_1 = require("./utils/promptLoader");
+const versionChecker_1 = require("./utils/versionChecker");
 const i18n_1 = require("./utils/i18n");
 const llmClientFactory_1 = require("./services/llmClientFactory");
 const guideRegistry_1 = require("./generators/documentation/guideRegistry");
@@ -71,7 +73,8 @@ const localeLabelKeys = {
 };
 const program = new commander_1.Command();
 const ui = new cliUI_1.CLIInterface(t);
-const VERSION = '0.3.0';
+const VERSION = '0.3.1';
+const PACKAGE_NAME = '@ai-coders/context';
 const DEFAULT_MODEL = 'x-ai/grok-4-fast:free';
 const DOC_CHOICES = guideRegistry_1.DOCUMENT_GUIDES.map(guide => ({
     name: `${guide.title} (${guide.key})`,
@@ -86,6 +89,22 @@ program
     .description(t('cli.description'))
     .version(VERSION);
 program.option('-l, --lang <locale>', t('global.options.lang'), initialLocale);
+let versionCheckPromise = null;
+function scheduleVersionCheck(force = false) {
+    if (!versionCheckPromise || force) {
+        versionCheckPromise = (0, versionChecker_1.checkForUpdates)({
+            packageName: PACKAGE_NAME,
+            currentVersion: VERSION,
+            ui,
+            t,
+            force
+        }).catch(() => { });
+    }
+    return versionCheckPromise;
+}
+program.hook('preAction', () => {
+    void scheduleVersionCheck();
+});
 program
     .command('init')
     .description(t('commands.init.description'))
@@ -135,7 +154,7 @@ program
     .option('-m, --model <model>', t('commands.fill.options.model'), DEFAULT_MODEL)
     .option('-p, --provider <provider>', t('commands.fill.options.provider'))
     .option('--base-url <url>', t('commands.fill.options.baseUrl'))
-    .option('--prompt <file>', t('commands.fill.options.prompt'), path.join(__dirname, '../prompts/update_scaffold_prompt.md'))
+    .option('--prompt <file>', t('commands.fill.options.prompt'))
     .option('--dry-run', t('commands.fill.options.dryRun'), false)
     .option('--all', t('commands.fill.options.all'), false)
     .option('--limit <number>', t('commands.fill.options.limit'), (value) => parseInt(value, 10))
@@ -169,7 +188,7 @@ program
     .option('-m, --model <model>', t('commands.plan.options.model'), DEFAULT_MODEL)
     .option('-p, --provider <provider>', t('commands.plan.options.provider'))
     .option('--base-url <url>', t('commands.plan.options.baseUrl'))
-    .option('--prompt <file>', t('commands.plan.options.prompt'), path.join(__dirname, '../prompts/update_plan_prompt.md'))
+    .option('--prompt <file>', t('commands.plan.options.prompt'))
     .option('--dry-run', t('commands.plan.options.dryRun'), false)
     .option('--include <patterns...>', t('commands.plan.options.include'))
     .option('--exclude <patterns...>', t('commands.plan.options.exclude'))
@@ -329,10 +348,6 @@ async function runGuidelines(..._args) {
     throw new Error(t('errors.commands.guidelinesRemoved'));
 }
 async function resolveLlmConfig(rawOptions, defaults) {
-    const promptPath = path.resolve(rawOptions.prompt || defaults.promptPath);
-    if (!(await fs.pathExists(promptPath))) {
-        throw new Error(t('errors.fill.promptMissing', { path: promptPath }));
-    }
     const providerEnvMap = llmClientFactory_1.LLMClientFactory.getEnvironmentVariables();
     const defaultModels = llmClientFactory_1.LLMClientFactory.getDefaultModels();
     let provider = rawOptions.provider;
@@ -404,7 +419,6 @@ async function resolveLlmConfig(rawOptions, defaults) {
         provider,
         model: model || defaults.fallbackModel,
         apiKey,
-        promptPath,
         baseUrl: rawOptions.baseUrl
     };
 }
@@ -423,10 +437,10 @@ async function runLlmFill(repoPath, rawOptions) {
     if (agentSelection.invalid.length > 0) {
         ui.displayWarning(t('warnings.agents.unknown', { values: agentSelection.invalid.join(', ') }));
     }
-    const { provider, model, apiKey, promptPath, baseUrl } = await resolveLlmConfig(rawOptions, {
-        promptPath: path.join(__dirname, '../prompts/update_scaffold_prompt.md'),
+    const { provider, model, apiKey, baseUrl } = await resolveLlmConfig(rawOptions, {
         fallbackModel: DEFAULT_MODEL
     });
+    const scaffoldPrompt = await (0, promptLoader_1.resolveScaffoldPrompt)(rawOptions.prompt, missingPath => t('errors.fill.promptMissing', { path: missingPath }));
     const docAllowlist = docSelection.explicitNone
         ? new Set()
         : (0, guideRegistry_1.getDocFilesByKeys)(docSelection.selected);
@@ -436,7 +450,6 @@ async function runLlmFill(repoPath, rawOptions) {
     const options = {
         repoPath: resolvedRepo,
         outputDir,
-        promptPath,
         provider,
         model,
         apiKey,
@@ -452,6 +465,18 @@ async function runLlmFill(repoPath, rawOptions) {
         selectedDocFiles: docAllowlist,
         selectedAgentFiles: agentAllowlist
     };
+    const scaffoldPromptDisplayPath = scaffoldPrompt.path
+        ? path.relative(process.cwd(), scaffoldPrompt.path) || scaffoldPrompt.path
+        : undefined;
+    if (scaffoldPrompt.source === 'custom' && scaffoldPromptDisplayPath) {
+        ui.displayInfo(t('info.prompt.title'), t('info.prompt.usingCustom', { path: scaffoldPromptDisplayPath }));
+    }
+    else if (scaffoldPrompt.source === 'package' && scaffoldPromptDisplayPath) {
+        ui.displayInfo(t('info.prompt.title'), t('info.prompt.usingPackage', { path: scaffoldPromptDisplayPath }));
+    }
+    else {
+        ui.displayInfo(t('info.prompt.title'), t('info.prompt.usingBundled'));
+    }
     ui.displayWelcome(VERSION);
     ui.displayProjectInfo(options.repoPath, options.outputDir, `fill:${options.provider}`);
     const fileMapper = new fileMapper_1.FileMapper(options.exclude);
@@ -462,7 +487,7 @@ async function runLlmFill(repoPath, rawOptions) {
         fileCount: repoStructure.totalFiles,
         directoryCount: repoStructure.directories.length
     }), 'success');
-    const systemPrompt = await fs.readFile(options.promptPath, 'utf-8');
+    const systemPrompt = scaffoldPrompt.content;
     const llmClient = llmClientFactory_1.LLMClientFactory.createClient({
         apiKey: options.apiKey,
         model: options.model,
@@ -585,10 +610,10 @@ async function runPlanFill(planName, rawOptions) {
     if (!(await fs.pathExists(repoPath))) {
         throw new Error(t('errors.common.repoMissing', { path: repoPath }));
     }
-    const { provider, model, apiKey, promptPath, baseUrl } = await resolveLlmConfig(rawOptions, {
-        promptPath: path.join(__dirname, '../prompts/update_plan_prompt.md'),
+    const { provider, model, apiKey, baseUrl } = await resolveLlmConfig(rawOptions, {
         fallbackModel: DEFAULT_MODEL
     });
+    const planPrompt = await (0, promptLoader_1.resolvePlanPrompt)(rawOptions.prompt, missingPath => t('errors.fill.promptMissing', { path: missingPath }));
     const planContent = await fs.readFile(planPath, 'utf-8');
     const docsIndexPath = path.join(docsDir, 'README.md');
     const agentsIndexPath = path.join(agentsDir, 'README.md');
@@ -596,6 +621,18 @@ async function runPlanFill(planName, rawOptions) {
     const agentsIndex = (await fs.pathExists(agentsIndexPath)) ? await fs.readFile(agentsIndexPath, 'utf-8') : undefined;
     const referencedDocs = await loadReferencedMarkdown(docsDir, extractPlanReferences(planContent, 'docs'));
     const referencedAgents = await loadReferencedMarkdown(agentsDir, extractPlanReferences(planContent, 'agents'));
+    const planPromptDisplayPath = planPrompt.path
+        ? path.relative(process.cwd(), planPrompt.path) || planPrompt.path
+        : undefined;
+    if (planPrompt.source === 'custom' && planPromptDisplayPath) {
+        ui.displayInfo(t('info.prompt.title'), t('info.prompt.usingCustom', { path: planPromptDisplayPath }));
+    }
+    else if (planPrompt.source === 'package' && planPromptDisplayPath) {
+        ui.displayInfo(t('info.prompt.title'), t('info.prompt.usingPackage', { path: planPromptDisplayPath }));
+    }
+    else {
+        ui.displayInfo(t('info.prompt.title'), t('info.prompt.usingBundled'));
+    }
     ui.displayWelcome(VERSION);
     ui.displayProjectInfo(repoPath, outputDir, `plan-fill:${provider}`);
     const fileMapper = new fileMapper_1.FileMapper(rawOptions.exclude);
@@ -604,7 +641,7 @@ async function runPlanFill(planName, rawOptions) {
     const repoStructure = await fileMapper.mapRepository(repoPath, rawOptions.include);
     const contextSummary = buildContextSummary(repoStructure);
     ui.updateSpinner(t('spinner.planFill.summaryReady'), 'success');
-    const systemPrompt = await fs.readFile(promptPath, 'utf-8');
+    const systemPrompt = planPrompt.content;
     const llmClient = llmClientFactory_1.LLMClientFactory.createClient({
         apiKey,
         model,
@@ -746,7 +783,7 @@ function buildPlanUserPrompt(context) {
         '- Preserve the YAML front matter and `ai-task` wrapper already in the plan.',
         '- Replace TODOs with concrete steps that align with the provided documentation and agent playbooks.',
         '- Keep the Agent Lineup and Documentation Touchpoints tables accurate and sorted.',
-        '- Ensure stages include owners, deliverables, and evidence expectations.',
+        '- Ensure the work is segmented into phases, each with numbered steps, named owners, deliverables, evidence expectations, and a concluding Git commit checkpoint.',
         '- Return only the full updated Markdown for this plan.'
     ];
     const sections = [
@@ -926,7 +963,7 @@ function formatAgentLabel(value) {
         .map(segment => segment.charAt(0).toUpperCase() + segment.slice(1))
         .join(' ');
 }
-async function runInteractive() {
+async function selectLocale(showWelcome) {
     const { locale } = await inquirer_1.default.prompt([
         {
             type: 'list',
@@ -942,28 +979,48 @@ async function runInteractive() {
     const normalizedLocale = (0, i18n_1.normalizeLocale)(locale);
     currentLocale = normalizedLocale;
     translateFn = (0, i18n_1.createTranslator)(normalizedLocale);
-    ui.displayWelcome(VERSION);
-    const { action } = await inquirer_1.default.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: t('prompts.main.action'),
-            choices: [
-                { name: t('prompts.main.choice.scaffold'), value: 'scaffold' },
-                { name: t('prompts.main.choice.fill'), value: 'fill' },
-                { name: t('prompts.main.choice.plan'), value: 'plan' }
-            ]
-        }
-    ]);
-    if (action === 'scaffold') {
-        await runInteractiveScaffold();
-    }
-    else if (action === 'fill') {
-        await runInteractiveLlmFill();
+    if (showWelcome) {
+        ui.displayWelcome(VERSION);
     }
-    else {
-        await runInteractivePlan();
+}
+async function runInteractive() {
+    await selectLocale(true);
+    let exitRequested = false;
+    while (!exitRequested) {
+        const { action } = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: t('prompts.main.action'),
+                choices: [
+                    { name: t('prompts.main.choice.scaffold'), value: 'scaffold' },
+                    { name: t('prompts.main.choice.fill'), value: 'fill' },
+                    { name: t('prompts.main.choice.plan'), value: 'plan' },
+                    { name: t('prompts.main.choice.changeLanguage'), value: 'changeLanguage' },
+                    { name: t('prompts.main.choice.exit'), value: 'exit' }
+                ]
+            }
+        ]);
+        if (action === 'changeLanguage') {
+            await selectLocale(true);
+            continue;
+        }
+        if (action === 'exit') {
+            exitRequested = true;
+            break;
+        }
+        if (action === 'scaffold') {
+            await runInteractiveScaffold();
+        }
+        else if (action === 'fill') {
+            await runInteractiveLlmFill();
+        }
+        else {
+            await runInteractivePlan();
+        }
+        ui.displayInfo(t('info.interactive.returning.title'), t('info.interactive.returning.detail'));
     }
+    ui.displaySuccess(t('success.interactive.goodbye'));
 }
 async function runInteractiveScaffold() {
     const { repoPath } = await inquirer_1.default.prompt([
@@ -1072,8 +1129,7 @@ async function runInteractiveLlmFill() {
     ]);
     const resolvedRepo = path.resolve(repoPath.trim() || '.');
     const defaultOutput = path.resolve(resolvedRepo, '.context');
-    const defaultPrompt = path.resolve(process.cwd(), 'prompts/update_scaffold_prompt.md');
-    const { outputDir, promptPath } = await inquirer_1.default.prompt([
+    const { outputDir, promptPath: promptPathInput } = await inquirer_1.default.prompt([
         {
             type: 'input',
             name: 'outputDir',
@@ -1084,9 +1140,10 @@ async function runInteractiveLlmFill() {
             type: 'input',
             name: 'promptPath',
             message: t('prompts.fill.promptPath'),
-            default: defaultPrompt
+            default: ''
         }
     ]);
+    const promptPath = promptPathInput.trim() ? path.resolve(promptPathInput.trim()) : undefined;
     const { dryRun, processAll } = await inquirer_1.default.prompt([
         {
             type: 'confirm',
@@ -1451,6 +1508,7 @@ function filterOutLocaleArgs(args) {
 }
 async function main() {
     const userArgs = process.argv.slice(2);
+    void scheduleVersionCheck();
     const meaningfulArgs = filterOutLocaleArgs(userArgs);
     if (meaningfulArgs.length === 0) {
         await runInteractive();