@open-product-primer/cli 2.6.0 → 2.8.0

package/dist/commands/init.js

@@ -48,7 +48,7 @@ function initCommand() {
     return new commander_1.Command('init')
         .description('Initialize oprim in the current repository')
         .option('--name <name>', 'project name (defaults to directory name)')
-        .option('--agent <name>', 'AI agent to install skills for (repeatable; supported: claude, cursor, codex, gemini, poolside, vibe)', (val, prev) => [...prev, val], [])
+        .option('--agent <name>', 'AI agent to install skills for (repeatable; supported: claude, cursor, codex, gemini, poolside, vibe, qwen, kimi)', (val, prev) => [...prev, val], [])
         .action(async (opts) => {
         const projectRoot = process.cwd();
         const projectName = opts.name ?? path.basename(projectRoot);

package/dist/commands/ovw.js

@@ -42,6 +42,7 @@ const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
 const yaml = __importStar(require("js-yaml"));
+const hyperlink_1 = require("../lib/hyperlink");
 function resolveBetDecisionPath(betsDir, betId) {
     if (!fs.existsSync(betsDir))
         return null;
@@ -128,15 +129,16 @@ function renderLane(label, bets, betsDir, showMeta) {
         return;
     }
     for (const bet of bets) {
+        const entry = (0, hyperlink_1.hyperlinkBetEntry)(betsDir, bet.id, `${bet.id}  ${bet.title}`);
         if (showMeta) {
             const meta = loadBetMeta(betsDir, bet.id);
             const inline = renderInlineMeta(meta);
             const blockers = renderBlockers(bet);
-            console.log(`  ${bet.id}  ${bet.title}  ${inline}${blockers}`);
+            console.log(`  ${entry}  ${inline}${blockers}`);
         }
         else {
             const blockers = renderBlockers(bet);
-            console.log(`  ${bet.id}  ${bet.title}${blockers}`);
+            console.log(`  ${entry}${blockers}`);
         }
     }
 }

package/dist/lib/detect.js

@@ -86,6 +86,10 @@ function detectAvailableAgents(projectRoot) {
         detected.push('poolside');
     if (fs.existsSync(path.join(projectRoot, '.vibe')))
         detected.push('vibe');
+    if (fs.existsSync(path.join(projectRoot, '.qwen')))
+        detected.push('qwen');
+    if (fs.existsSync(path.join(projectRoot, '.kimi')))
+        detected.push('kimi');
     return detected;
 }
 function writeAgentsToConfig(agents, projectRoot) {

package/dist/lib/hyperlink.d.ts

@@ -0,0 +1,7 @@
+/** Wraps `text` in an OSC 8 terminal hyperlink escape sequence targeting `uri`. */
+export declare function osc8(text: string, uri: string): string;
+/**
+ * Resolves `betIdInput` to its `bet-decision.md` path under `betsDir` and returns an OSC 8
+ * hyperlink wrapping `text`. Falls back to plain `text` if the bet can't be resolved.
+ */
+export declare function hyperlinkBetEntry(betsDir: string, betIdInput: string, text: string): string;

package/dist/lib/hyperlink.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.osc8 = osc8;
+exports.hyperlinkBetEntry = hyperlinkBetEntry;
+const path = __importStar(require("path"));
+const spec_delta_1 = require("./spec-delta");
+/** Wraps `text` in an OSC 8 terminal hyperlink escape sequence targeting `uri`. */
+function osc8(text, uri) {
+    return `\x1b]8;;${uri}\x1b\\${text}\x1b]8;;\x1b\\`;
+}
+function fileUri(absPath) {
+    return 'file://' + encodeURI(absPath.split(path.sep).join('/'));
+}
+/**
+ * Resolves `betIdInput` to its `bet-decision.md` path under `betsDir` and returns an OSC 8
+ * hyperlink wrapping `text`. Falls back to plain `text` if the bet can't be resolved.
+ */
+function hyperlinkBetEntry(betsDir, betIdInput, text) {
+    const dirName = (0, spec_delta_1.resolveBetDirectory)(betsDir, betIdInput);
+    if (!dirName)
+        return text;
+    const decisionPath = path.join(betsDir, dirName, 'bet-decision.md');
+    return osc8(text, fileUri(decisionPath));
+}

package/dist/lib/install-agent.d.ts

@@ -1,4 +1,4 @@
-export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini' | 'poolside' | 'vibe';
+export type Agent = 'claude' | 'cursor' | 'codex' | 'gemini' | 'poolside' | 'vibe' | 'qwen' | 'kimi';
 export declare const SUPPORTED_AGENTS: readonly Agent[];
 export declare function promptFrameworkSelection(projectRoot: string): Promise<string>;
 export declare function resolveSpecFramework(projectRoot: string): string;
@@ -11,6 +11,8 @@ export declare const CLAUDE_SKILLS: Record<string, string>;
 export declare const CLAUDE_COMMANDS: Record<string, string>;
 export declare const POOLSIDE_SKILLS: Record<string, string>;
 export declare const VIBE_SKILLS: Record<string, string>;
+export declare const QWEN_SKILLS: Record<string, string>;
+export declare const KIMI_SKILLS: Record<string, string>;
 export declare const CURSOR_SKILLS: Record<string, string>;
 export declare const CURSOR_COMMANDS: Record<string, string>;
 export declare function specAuthoringSkill(): string;
@@ -19,3 +21,5 @@ export declare function codexInstructions(): string;
 export declare function geminiInstructions(): string;
 export declare function poolsideInstructions(): string;
 export declare function vibeInstructions(): string;
+export declare function qwenInstructions(): string;
+export declare function kimiInstructions(): string;

package/dist/lib/install-agent.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.VIBE_SKILLS = exports.POOLSIDE_SKILLS = exports.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.OPRIM_CONTEXT_SKILL_STEP = exports.SUPPORTED_AGENTS = void 0;
+exports.CURSOR_COMMANDS = exports.CURSOR_SKILLS = exports.KIMI_SKILLS = exports.QWEN_SKILLS = exports.VIBE_SKILLS = exports.POOLSIDE_SKILLS = exports.CLAUDE_COMMANDS = exports.CLAUDE_SKILLS = exports.OPRIM_CONTEXT_SKILL_STEP = exports.SUPPORTED_AGENTS = void 0;
 exports.promptFrameworkSelection = promptFrameworkSelection;
 exports.resolveSpecFramework = resolveSpecFramework;
 exports.promptAgentSelection = promptAgentSelection;
@@ -49,6 +49,8 @@ exports.codexInstructions = codexInstructions;
 exports.geminiInstructions = geminiInstructions;
 exports.poolsideInstructions = poolsideInstructions;
 exports.vibeInstructions = vibeInstructions;
+exports.qwenInstructions = qwenInstructions;
+exports.kimiInstructions = kimiInstructions;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -57,7 +59,16 @@ const detect_1 = require("./detect");
 const config_merge_1 = require("./config-merge");
 const workflow_schema_1 = require("./workflow-schema");
 const workflow_renderer_1 = require("./workflow-renderer");
-exports.SUPPORTED_AGENTS = ['claude', 'cursor', 'codex', 'gemini', 'poolside', 'vibe'];
+exports.SUPPORTED_AGENTS = [
+    'claude',
+    'cursor',
+    'codex',
+    'gemini',
+    'poolside',
+    'vibe',
+    'qwen',
+    'kimi',
+];
 // oprim/config.yaml (via integrations.spec_framework) is the source of truth for the
 // selected speccing framework; .claude/hooks/config.json is checked only as a fallback for
 // projects that installed before that key existed.
@@ -126,6 +137,8 @@ async function promptAgentSelection(projectRoot) {
             { name: 'Gemini CLI', value: 'gemini', checked: detected.includes('gemini') },
             { name: 'Poolside', value: 'poolside', checked: detected.includes('poolside') },
             { name: 'Mistral Vibe', value: 'vibe', checked: detected.includes('vibe') },
+            { name: 'Qwen Code', value: 'qwen', checked: detected.includes('qwen') },
+            { name: 'Kimi CLI', value: 'kimi', checked: detected.includes('kimi') },
         ],
     });
 }
@@ -142,8 +155,8 @@ async function promptOkfFrontmatter() {
 }
 // Workflow ids installed as Claude/Poolside/Cursor skill files — see packages/cli/src/workflows/.
 // Order matches the pre-refactor CLAUDE_SKILLS/POOLSIDE_SKILLS/CURSOR_SKILLS declaration order.
-const CLAUDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence', 'context'];
-const POOLSIDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence'];
+const CLAUDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence', 'context', 'explore', 'reconcile'];
+const POOLSIDE_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review', 'archive', 'sequence', 'explore', 'reconcile'];
 const CURSOR_SKILL_WORKFLOW_IDS = ['pdr', 'bet', 'note', 'criteria', 'review'];
 // Claude command wrappers (thin, invoke skill) — filename -> workflow id. Order matches the
 // pre-refactor CLAUDE_COMMANDS declaration order.
@@ -152,6 +165,8 @@ const CLAUDE_COMMAND_WORKFLOWS = [
     { filename: 'sequence.md', id: 'sequence' },
     { filename: 'archive.md', id: 'archive' },
     { filename: 'context-init.md', id: 'context' },
+    { filename: 'explore.md', id: 'explore' },
+    { filename: 'reconcile.md', id: 'reconcile' },
 ];
 // Cursor command files (full inline). Order matches the pre-refactor CURSOR_COMMANDS declaration order.
 const CURSOR_COMMAND_WORKFLOW_IDS = ['promote', 'sequence', 'pdr', 'bet', 'note', 'criteria', 'review'];
@@ -314,6 +329,78 @@ function installAgentSkills(agent, projectRoot, framework = 'openspec', pdrSurfa
             console.log(chalk_1.default.dim('  .vibe/ created — Mistral Vibe will discover these files automatically.'));
         }
     }
+    else if (agent === 'qwen') {
+        const qwenDir = path.join(projectRoot, '.qwen');
+        const dirCreated = !fs.existsSync(qwenDir);
+        const skillsBase = path.join(qwenDir, 'skills');
+        for (const id of POOLSIDE_SKILL_WORKFLOW_IDS) {
+            const schema = (0, workflow_schema_1.loadWorkflowSchema)(id, projectRoot);
+            if (!schema.qwen.skill || !schema.skillName)
+                continue;
+            (0, scaffold_1.writeFile)(path.join(skillsBase, schema.skillName, 'SKILL.md'), (0, workflow_renderer_1.renderSkillBody)(id, projectRoot));
+            console.log(chalk_1.default.green('✓') + ` .qwen/skills/${schema.skillName}/SKILL.md`);
+        }
+        const qwenSpecSkillPath = path.join(skillsBase, 'oprim-spec', 'SKILL.md');
+        if (framework === 'native') {
+            (0, scaffold_1.writeFile)(qwenSpecSkillPath, (0, workflow_renderer_1.renderSkillBody)('spec-authoring', projectRoot));
+            console.log(chalk_1.default.green('✓') + ' .qwen/skills/oprim-spec/SKILL.md');
+        }
+        else if (fs.existsSync(qwenSpecSkillPath)) {
+            fs.unlinkSync(qwenSpecSkillPath);
+            try {
+                fs.rmdirSync(path.dirname(qwenSpecSkillPath));
+            }
+            catch { /* not empty or already gone */ }
+            console.log(chalk_1.default.dim('  removed .qwen/skills/oprim-spec/SKILL.md'));
+        }
+        const agentsFile = path.join(projectRoot, 'AGENTS.md');
+        writeAgentInstructionFile(agentsFile, qwenInstructions());
+        console.log(chalk_1.default.green('✓') + ' AGENTS.md (oprim section written)');
+        if (dirCreated) {
+            console.log(chalk_1.default.dim('  .qwen/ created — Qwen Code will discover these files automatically.'));
+        }
+    }
+    else if (agent === 'kimi') {
+        // Kimi CLI is a split-path install: .kimi/ is the detection signal, but skills are
+        // discovered from a project-root .skills/ directory, not .kimi/skills/ — see
+        // kimi-cli-agent-support spec.
+        const kimiDir = path.join(projectRoot, '.kimi');
+        const kimiDirCreated = !fs.existsSync(kimiDir);
+        if (kimiDirCreated) {
+            fs.mkdirSync(kimiDir, { recursive: true });
+        }
+        const skillsBase = path.join(projectRoot, '.skills');
+        const skillsDirCreated = !fs.existsSync(skillsBase);
+        for (const id of POOLSIDE_SKILL_WORKFLOW_IDS) {
+            const schema = (0, workflow_schema_1.loadWorkflowSchema)(id, projectRoot);
+            if (!schema.kimi.skill || !schema.skillName)
+                continue;
+            (0, scaffold_1.writeFile)(path.join(skillsBase, schema.skillName, 'SKILL.md'), (0, workflow_renderer_1.renderSkillBody)(id, projectRoot));
+            console.log(chalk_1.default.green('✓') + ` .skills/${schema.skillName}/SKILL.md`);
+        }
+        const kimiSpecSkillPath = path.join(skillsBase, 'oprim-spec', 'SKILL.md');
+        if (framework === 'native') {
+            (0, scaffold_1.writeFile)(kimiSpecSkillPath, (0, workflow_renderer_1.renderSkillBody)('spec-authoring', projectRoot));
+            console.log(chalk_1.default.green('✓') + ' .skills/oprim-spec/SKILL.md');
+        }
+        else if (fs.existsSync(kimiSpecSkillPath)) {
+            fs.unlinkSync(kimiSpecSkillPath);
+            try {
+                fs.rmdirSync(path.dirname(kimiSpecSkillPath));
+            }
+            catch { /* not empty or already gone */ }
+            console.log(chalk_1.default.dim('  removed .skills/oprim-spec/SKILL.md'));
+        }
+        const agentsFile = path.join(projectRoot, 'AGENTS.md');
+        writeAgentInstructionFile(agentsFile, kimiInstructions());
+        console.log(chalk_1.default.green('✓') + ' AGENTS.md (oprim section written)');
+        if (kimiDirCreated) {
+            console.log(chalk_1.default.dim('  .kimi/ created — Kimi CLI will discover this directory automatically.'));
+        }
+        if (skillsDirCreated) {
+            console.log(chalk_1.default.dim('  .skills/ created — Kimi CLI will discover these files automatically.'));
+        }
+    }
     else if (agent === 'codex') {
         const agentsFile = path.join(projectRoot, 'AGENTS.md');
         writeAgentInstructionFile(agentsFile, codexInstructions());
@@ -478,6 +565,14 @@ exports.VIBE_SKILLS = Object.fromEntries(POOLSIDE_SKILL_WORKFLOW_IDS.map((id) =>
     const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
     return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
 }));
+exports.QWEN_SKILLS = Object.fromEntries(POOLSIDE_SKILL_WORKFLOW_IDS.map((id) => {
+    const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
+    return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
+}));
+exports.KIMI_SKILLS = Object.fromEntries(POOLSIDE_SKILL_WORKFLOW_IDS.map((id) => {
+    const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
+    return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
+}));
 exports.CURSOR_SKILLS = Object.fromEntries(CURSOR_SKILL_WORKFLOW_IDS.map((id) => {
     const schema = (0, workflow_schema_1.loadWorkflowSchema)(id);
     return [schema.skillName, (0, workflow_renderer_1.renderSkillBody)(id)];
@@ -672,3 +767,9 @@ function poolsideInstructions() {
 function vibeInstructions() {
     return (0, workflow_renderer_1.renderAgentInstructions)();
 }
+function qwenInstructions() {
+    return (0, workflow_renderer_1.renderAgentInstructions)();
+}
+function kimiInstructions() {
+    return (0, workflow_renderer_1.renderAgentInstructions)();
+}

package/dist/lib/workflow-renderer.js

@@ -8,7 +8,7 @@ exports.renderAgentInstructions = renderAgentInstructions;
 const workflow_schema_1 = require("./workflow-schema");
 // Fixed order the pre-refactor oprimWorkflowsInline() concatenated its per-workflow sections in —
 // preserved here so Codex/Gemini/Poolside output is unchanged.
-const INLINE_SECTION_ORDER = ['bet', 'note', 'criteria', 'pdr', 'review', 'archive', 'sequence'];
+const INLINE_SECTION_ORDER = ['bet', 'note', 'criteria', 'pdr', 'review', 'archive', 'sequence', 'explore', 'reconcile'];
 function claudeWrapper(name, description, body) {
     return `---
 name: "${name}"

package/dist/lib/workflow-schema.d.ts

@@ -16,6 +16,12 @@ export interface WorkflowSchema {
     vibe: {
         skill: boolean;
     };
+    qwen: {
+        skill: boolean;
+    };
+    kimi: {
+        skill: boolean;
+    };
     inline: boolean;
     variants: string[] | null;
 }

package/dist/lib/workflow-schema.js

@@ -68,9 +68,12 @@ function parseSchema(raw, filePath) {
     const claude = requireField(obj, 'claude', filePath);
     const cursor = requireField(obj, 'cursor', filePath);
     const poolside = requireField(obj, 'poolside', filePath);
-    // vibe is optional and mirrors poolside by default — see mistral-vibe-agent-support spec.
-    // This keeps existing bundled/forked schemas (none declare a `vibe:` key) working unchanged.
+    // vibe/qwen/kimi are optional and mirror poolside by default — see mistral-vibe-agent-support,
+    // qwen-code-agent-support, and kimi-cli-agent-support specs. This keeps existing bundled/forked
+    // schemas (none declare a `vibe:`/`qwen:`/`kimi:` key) working unchanged.
     const vibe = obj.vibe ?? poolside;
+    const qwen = obj.qwen ?? poolside;
+    const kimi = obj.kimi ?? poolside;
     requireField(obj, 'inline', filePath);
     return {
         id: obj.id,
@@ -82,6 +85,8 @@ function parseSchema(raw, filePath) {
         cursor: { skill: Boolean(cursor.skill), command: cursor.command ?? null },
         poolside: { skill: Boolean(poolside.skill) },
         vibe: { skill: Boolean(vibe.skill) },
+        qwen: { skill: Boolean(qwen.skill) },
+        kimi: { skill: Boolean(kimi.skill) },
         inline: Boolean(obj.inline),
         variants: obj.variants ?? null,
     };

package/dist/workflows/bet.cursor-command.md

@@ -1 +1 @@
-Create a new bet in `oprim/bets/pending/`. First explain: "A bet is a product decision you're committing to explore — a problem worth solving, a hypothesis worth testing, or a direction worth taking. You'll name it, explain why now, and set a kill criterion." Then show: "Naming tip: verb + object [for context] — Good: 'Improve bet naming for scannability' / Bad: 'Naming'". Scan `oprim/bets/pending/BET-(\d+)` and `oprim/bets/archived/BET-(\d+)` dirs for next ID (zero-padded, default 001). Check `oprim/sequence.yaml` exists (stop if not — advise oprim init). Read `oprim/config.yaml`'s `rules.bet` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged. After receiving the title, validate: if fewer than 4 words OR fewer than 25 characters, warn "this title may be too vague", suggest a reformulation, and ask "Proceed anyway? (y/N)" — if "n", prompt for a revised title. Gather: decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write `oprim/bets/pending/BET-NNN/bet-decision.md` with an inline naming tip comment in the header. Append entry to sequence.yaml backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`. Then ask: "Do you want to scaffold a discovery.md now? (y/N)" — if "y", write `oprim/bets/pending/BET-NNN/discovery.md` from the discovery template (sections: Problem Framing, User Research Signals, Competitive Context, Open Questions); if "n" or Enter, skip silently. Report what was created.
+Create a new bet in `oprim/bets/pending/`. First explain: "A bet is a product decision you're committing to explore — a problem worth solving, a hypothesis worth testing, or a direction worth taking. You'll name it, explain why now, and set a kill criterion." Then show: "Naming tip: verb + object [for context] — Good: 'Improve bet naming for scannability' / Bad: 'Naming'". Scan `oprim/bets/pending/BET-(\d+)` and `oprim/bets/archived/BET-(\d+)` dirs for next ID (zero-padded, default 001). Check `oprim/sequence.yaml` exists (stop if not — advise oprim init). Read `oprim/config.yaml`'s `rules.bet` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged. After receiving the title, validate: if fewer than 4 words OR fewer than 25 characters, warn "this title may be too vague", suggest a reformulation, and ask "Proceed anyway? (y/N)" — if "n", prompt for a revised title. Gather: decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write `oprim/bets/pending/BET-NNN/bet-decision.md` with an inline naming tip comment in the header. Append entry to sequence.yaml backlog: `{title, id, blocked_by: [], unlocks: [], requires_pdrs: []}`. Then ask: "Do you want to scaffold a discovery.md now? (y/N)" — if "y", write `oprim/bets/pending/BET-NNN/discovery.md` from the discovery template (sections: Problem Framing, User Research Signals, Competitive Context, Open Questions); if "n" or Enter, skip silently. Report what was created.

package/dist/workflows/bet.inline.md

@@ -8,6 +8,6 @@ Create a new bet in `oprim/bets/pending/` and register it on the sequencing boar
 4b. Read `oprim/config.yaml`'s `rules.bet` — if non-empty, apply it as additional guidance and reflect it in the generated content; if empty, behavior is unchanged.
 5. Gather: decision (default Build now), owner, review date (YYYY-MM-DD), why now, alternatives, expected outcomes, kill criteria, PDR links.
 6. Write `oprim/bets/pending/BET-NNN/bet-decision.md` with all fields.
-7. Append to `oprim/sequence.yaml` backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`.
+7. Append to `oprim/sequence.yaml` backlog: `{title, id, blocked_by: [], unlocks: [], requires_pdrs: []}`.
 8. Ask: "Scaffold a discovery.md now? (y/N)" — if "y", write `oprim/bets/pending/BET-NNN/discovery.md`.
 9. Report what was created.

package/dist/workflows/bet.template.md

@@ -99,8 +99,8 @@ Prepend the frontmatter block from step 4b, if one was prepared.
 ### 6. Append to oprim/sequence.yaml backlog
 Read → parse YAML → append → write back (2-space indentation):
 ```yaml
-- id: BET-NNN
-  title: "<title>"
+- title: "<title>"
+  id: BET-NNN
   blocked_by: []
   unlocks: []
   requires_pdrs: []

package/dist/workflows/explore.inline.md

@@ -0,0 +1,9 @@
+### Problem exploration (oprim-explore)
+Investigate a problem or opportunity and compare candidate framings, before any decision artifact is written. Read-only and non-committal — never writes a `bet-decision.md`.
+
+1. Ask for the problem or opportunity (a sentence or two).
+2. Surface related PDRs: scan `oprim/decisions/PDR-*.md`, extract keywords from the problem statement, list matches by filename/title/body relevance.
+3. Surface related notes: scan `oprim/notes/NOTE-*.md` the same way.
+4. Surface related bets: scan `oprim/bets/pending/` and `oprim/bets/archived/` for bet-decisions with similar titles or "Why now" content — flag archived matches explicitly, since they may mean this ground has been covered before.
+5. Ask for candidate approaches/framings (description + main tradeoff each) and present them side by side without recommending one, unless asked.
+6. Report what was surfaced and, if the user has converged on a candidate, tell them to run `/oprim:bet` to draft the decision — explore does not create the bet itself.

package/dist/workflows/explore.schema.yaml

@@ -0,0 +1,13 @@
+id: explore
+skillName: oprim-explore
+title: "OPRIM: Explore"
+description: Investigate a problem and compare candidate framings before a bet is drafted
+claude:
+  skill: true
+  command: explore.md
+cursor:
+  skill: false
+  command: null
+poolside:
+  skill: true
+inline: true

package/dist/workflows/explore.template.md

@@ -0,0 +1,54 @@
+---
+name: oprim-explore
+description: Investigate a problem and compare candidate framings before a bet is drafted
+---
+
+Investigate a problem or opportunity and compare candidate framings, before any decision artifact is written. This is oprim's think-first phase — it sits upstream of `/oprim:bet`, not in place of it.
+
+**Interactive prompts:** Use the **AskUserQuestion tool** for every question in this skill — do not write questions as plain text.
+
+## What you're doing
+
+Explore is read-only and non-committal: it never writes a `bet-decision.md`. Use it when you've noticed a problem or opportunity but haven't yet converged on what to build, or when there are multiple plausible approaches worth weighing before committing to one. Once a candidate framing is worth committing to, hand off to `/oprim:bet` to draft the decision artifact — that boundary is deliberate, so explore doesn't duplicate `oprim-bet`'s job or drift into writing decisions itself.
+
+## Steps
+
+### 1. Get the problem or opportunity
+If not provided, ask: "What problem or opportunity do you want to explore? (a sentence or two)"
+
+### 2. Surface related PDRs
+Scan `oprim/decisions/` for files matching `PDR-*.md`. If the directory is empty or missing, skip this step. Otherwise, extract 3–10 keywords from the problem statement (subject-area nouns, capability names, bet IDs). For each PDR file, read the filename and first 25 lines; a PDR is relevant if any keyword appears in its filename, title, or body (case-insensitive). List matches:
+
+**Related product decisions:**
+- PDR-NNN: <title> — <Status> (`oprim/decisions/PDR-NNN-<slug>.md`)
+
+If none match, state that plainly and continue.
+
+### 3. Surface related notes
+Scan `oprim/notes/` for files matching `NOTE-*.md`. Using the same keywords from step 2, list notes whose title or body mention them:
+
+**Related notes:**
+- NOTE-NNN: <title> (`oprim/notes/NOTE-NNN-<slug>.md`)
+
+If `oprim/notes/` is empty or missing, or nothing matches, state that plainly and continue.
+
+### 4. Surface related bets
+Scan `oprim/bets/pending/` and `oprim/bets/archived/` for `bet-decision.md` files whose title or `## Why now` section mentions the keywords from step 2. List matches, noting whether each is pending or archived:
+
+**Related bets:**
+- BET-NNN: <title> — <pending/archived> (`oprim/bets/<pending|archived>/BET-NNN.../bet-decision.md`)
+
+An archived match with a similar problem statement is worth flagging explicitly — it may mean this ground has been covered before.
+
+### 5. Gather candidate framings
+Ask: "What are the candidate approaches or framings worth comparing? (list as many as you'd like — one is fine if you already have a clear direction)"
+
+For each candidate, ask for:
+- A one-line description
+- The main tradeoff or risk (what makes this candidate weaker than the alternatives, or what's uncertain about it)
+
+### 6. Compare candidates
+Present the candidates side by side (name, description, main tradeoff). Do not recommend one over another unless asked — the point of explore is to lay out the comparison clearly, not to decide for the user.
+
+### 7. Report and hand off
+Summarize what was surfaced (PDRs, notes, bets, candidate comparison). If the user has converged on a candidate worth committing to, tell them to run `/oprim:bet` to draft the decision artifact — explore does not create one itself. If no candidate has converged yet, note that explicitly and suggest gathering more information before drafting a bet.

package/dist/workflows/promote.native.template.md

@@ -24,6 +24,6 @@ Promote an atomic note into a bet, or a prioritized bet into a capability spec.
 2. **Assign the next BET ID** — scan both `oprim/bets/pending/` and `oprim/bets/archived/` for directories matching `BET-(\d+)(-[^/]*)?`, max+1 zero-padded to 3 digits (default 001) — same convention `oprim-bet` uses
 3. **Derive the slug** from the note's title (lowercase, non-alphanumeric → hyphen, collapse/trim hyphens, truncate to 40 chars at a hyphen boundary)
 4. **Draft the bet** — write `oprim/bets/pending/BET-NNN-<slug>/bet-decision.md` from the standard bet-decision structure, pre-filling only `## Why now` from the note's body. Leave `Alternatives considered`, `Expected outcomes`, and `Kill criteria / rollback trigger` as template placeholders — draft from the note, don't fabricate content it doesn't support. Ask for `Owner` and `Review date`; default `Decision: Build now` and `Date` to today.
-5. **Register the new bet** — append to `oprim/sequence.yaml` backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`
+5. **Register the new bet** — append to `oprim/sequence.yaml` backlog: `{title, id, blocked_by: [], unlocks: [], requires_pdrs: []}`
 6. **Link back** — add `Bets: BET-NNN` to the note (creating or extending its `## Bets` section)
 7. **Report** — show the new bet's path and flag that `Alternatives considered`, `Expected outcomes`, and `Kill criteria` still need authoring before this bet can itself be promoted

package/dist/workflows/promote.none.template.md

@@ -20,6 +20,6 @@ Promote an atomic note into a bet, or a prioritized bet into a capability spec.
 2. **Assign the next BET ID** — scan both `oprim/bets/pending/` and `oprim/bets/archived/` for directories matching `BET-(\d+)(-[^/]*)?`, max+1 zero-padded to 3 digits (default 001) — same convention `oprim-bet` uses
 3. **Derive the slug** from the note's title (lowercase, non-alphanumeric → hyphen, collapse/trim hyphens, truncate to 40 chars at a hyphen boundary)
 4. **Draft the bet** — write `oprim/bets/pending/BET-NNN-<slug>/bet-decision.md` from the standard bet-decision structure, pre-filling only `## Why now` from the note's body. Leave `Alternatives considered`, `Expected outcomes`, and `Kill criteria / rollback trigger` as template placeholders — draft from the note, don't fabricate content it doesn't support. Ask for `Owner` and `Review date`; default `Decision: Build now` and `Date` to today.
-5. **Register the new bet** — append to `oprim/sequence.yaml` backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`
+5. **Register the new bet** — append to `oprim/sequence.yaml` backlog: `{title, id, blocked_by: [], unlocks: [], requires_pdrs: []}`
 6. **Link back** — add `Bets: BET-NNN` to the note (creating or extending its `## Bets` section)
 7. **Report** — show the new bet's path and flag that `Alternatives considered`, `Expected outcomes`, and `Kill criteria` still need authoring before this bet can itself be promoted

package/dist/workflows/promote.openspec.template.md

@@ -35,6 +35,6 @@ Promote an atomic note into a bet, or a prioritized bet into a capability spec.
 2. **Assign the next BET ID** — scan both `oprim/bets/pending/` and `oprim/bets/archived/` for directories matching `BET-(\d+)(-[^/]*)?`, max+1 zero-padded to 3 digits (default 001) — same convention `oprim-bet` uses
 3. **Derive the slug** from the note's title (lowercase, non-alphanumeric → hyphen, collapse/trim hyphens, truncate to 40 chars at a hyphen boundary)
 4. **Draft the bet** — write `oprim/bets/pending/BET-NNN-<slug>/bet-decision.md` from the standard bet-decision structure, pre-filling only `## Why now` from the note's body. Leave `Alternatives considered`, `Expected outcomes`, and `Kill criteria / rollback trigger` as template placeholders — draft from the note, don't fabricate content it doesn't support. Ask for `Owner` and `Review date`; default `Decision: Build now` and `Date` to today.
-5. **Register the new bet** — append to `oprim/sequence.yaml` backlog: `{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}`
+5. **Register the new bet** — append to `oprim/sequence.yaml` backlog: `{title, id, blocked_by: [], unlocks: [], requires_pdrs: []}`
 6. **Link back** — add `Bets: BET-NNN` to the note (creating or extending its `## Bets` section)
 7. **Report** — show the new bet's path and flag that `Alternatives considered`, `Expected outcomes`, and `Kill criteria` still need authoring before this bet can itself be promoted

package/dist/workflows/reconcile.inline.md

@@ -0,0 +1,8 @@
+### Artifact reconciliation (oprim-reconcile)
+Detect and fix drift across linked oprim artifacts (PDR ↔ bet, bet ↔ review). Never batch-applies a fix — every proposed change is confirmed individually before being written.
+
+1. Scan every `bet-decision.md` under `oprim/bets/pending/` and `oprim/bets/archived/`: check each `## Links` reference (PDRs, Notes, Spec (delta), OpenSpec change) actually resolves to an existing file/path.
+2. Scan every `oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md` filename: check the referenced BET-NNN still exists in pending or archived bets.
+3. If nothing is found, report "No drift detected" and stop.
+4. Otherwise, list every drift entry, propose a specific fix per entry (e.g. remove a dangling ID from a `## Links` line), and ask "Apply this fix? (y/N)" one item at a time — apply only confirmed fixes.
+5. Report how many drift entries were found, fixed, and left unresolved.

package/dist/workflows/reconcile.schema.yaml

@@ -0,0 +1,13 @@
+id: reconcile
+skillName: oprim-reconcile
+title: "OPRIM: Reconcile"
+description: Detect and fix drift across linked oprim artifacts (PDR, bet, criteria, review)
+claude:
+  skill: true
+  command: reconcile.md
+cursor:
+  skill: false
+  command: null
+poolside:
+  skill: true
+inline: true

package/dist/workflows/reconcile.template.md

@@ -0,0 +1,51 @@
+---
+name: oprim-reconcile
+description: Detect and fix drift across linked oprim artifacts (PDR, bet, criteria, review)
+---
+
+Detect drift across linked oprim artifacts — PDR ↔ bet, bet ↔ criteria, bet ↔ review — and fix it with the user's per-item confirmation. Reconcile never batch-applies a fix; every proposed change is surfaced individually before it's written.
+
+**Interactive prompts:** Use the **AskUserQuestion tool** for every question in this skill — do not write questions as plain text.
+
+## What you're doing
+
+oprim artifacts reference each other (a bet's `## Links` section names PDRs, notes, and specs; a review's filename names the bet it reviews) but nothing currently checks those references stay valid as artifacts are renamed, moved, or archived. Reconcile is a read-then-confirm-then-write pass over that link graph — it detects drift, proposes a specific fix per item, and only writes a fix the user confirms. This is distinct from `oprim doctor`, which reports sequencing-board and skill-drift issues but never writes a fix itself.
+
+## Steps
+
+### 1. Scan bet-decision `## Links` sections
+For every `bet-decision.md` under `oprim/bets/pending/` and `oprim/bets/archived/`, read its `## Links` section and check each reference:
+- `PDRs: PDR-NNN, ...` — for each ID (skip "None"), verify a matching `oprim/decisions/PDR-NNN-*.md` exists
+- `Notes: NOTE-NNN, ...` — for each ID, verify a matching `oprim/notes/NOTE-NNN-*.md` exists
+- `Spec (delta): <path>` — verify the path exists
+- `OpenSpec change: <path>` — skip if the value is still a placeholder (e.g. "to be filled when promoted" or "None"); otherwise verify the path exists
+
+Record a drift entry for every reference that fails to resolve: which bet, which link line, which ID/path is missing.
+
+### 2. Scan review filenames against bets
+For every `oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md` file, extract `BET-NNN` and verify a matching bet directory exists in either `oprim/bets/pending/` or `oprim/bets/archived/`. Record a drift entry for any review whose bet can't be found.
+
+### 3. Scan criteria.yaml placement
+For every `oprim/bets/pending/BET-NNN.../criteria.yaml`, this is only valid while the bet is pending — it's expected to travel with the bet directory on archive, so no separate reference check is needed here. Skip this step; it exists to document why criteria.yaml isn't independently checked.
+
+### 4. Report detected drift
+If no drift was found in steps 1–2, report "No drift detected across PDR/bet/criteria/review links" and stop.
+
+Otherwise, list every drift entry found:
+
+**Detected drift:**
+- BET-NNN `## Links`: `PDRs` references PDR-XXX, which does not exist at `oprim/decisions/PDR-XXX-*.md`
+- `oprim/reviews/<file>` references BET-NNN, which does not exist in `oprim/bets/pending/` or `oprim/bets/archived/`
+
+### 5. Propose and confirm a fix, one item at a time
+For each drift entry, propose a specific fix:
+- A dangling PDR/Notes ID in a `## Links` line → propose removing that ID from the comma-separated list (or replacing the line with "None" if it was the only entry)
+- A `Spec (delta)` or `OpenSpec change` path that no longer resolves → propose removing that link line entirely
+- A review referencing a bet that no longer exists → propose no automatic fix (the bet may have been renamed rather than deleted); ask the user to identify the correct BET-NNN or confirm the review is orphaned and should be left as-is
+
+Ask: "Apply this fix? (y/N)" for each entry individually.
+- If confirmed: apply only that fix to the relevant file, then move to the next drift entry.
+- If declined: leave the artifact unchanged and move to the next drift entry.
+
+### 6. Report what was fixed
+Summarize: how many drift entries were found, how many fixes were applied, how many were declined or left for manual follow-up.

package/dist/workflows/sequence.template.md

@@ -79,7 +79,7 @@ Ask: "Apply this change? (y/N)"
 
 ### 5. Write sequence.yaml
 
-Read `oprim/sequence.yaml`. Remove the bet entry from its current lane. Insert it into the target lane. Write back with 2-space indentation. Do not modify any other entries.
+Read `oprim/sequence.yaml`. Remove the bet entry from its current lane. If the entry's fields are ordered `id:` before `title:`, reorder them to `title:` before `id:` (leave `blocked_by`, `unlocks`, `requires_pdrs` order unchanged). Insert the entry into the target lane. Write back with 2-space indentation. Do not modify any other entries.
 
 ### 6. Regenerate view
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-product-primer/cli",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Open Product Primer CLI — product decisions, sequencing, and KPI tracking for repositories",
   "keywords": [
     "product",