@open-product-primer/cli 0.1.1 → 0.2.0

package/dist/cli.js

@@ -8,15 +8,17 @@ const commander_1 = require("commander");
 const init_1 = require("./commands/init");
 const update_1 = require("./commands/update");
 const doctor_1 = require("./commands/doctor");
+const migrate_1 = require("./commands/migrate");
 const measure_1 = require("./commands/measure");
 const package_json_1 = __importDefault(require("../package.json"));
 const program = new commander_1.Command();
 program
-    .name('open-product-primer')
-    .description('Open Product Primer — product decisions, sequencing, and KPI tracking')
+    .name('oprim')
+    .description('oprim — product decisions, sequencing, and KPI tracking')
     .version(package_json_1.default.version);
 program.addCommand((0, init_1.initCommand)());
 program.addCommand((0, update_1.updateCommand)());
 program.addCommand((0, doctor_1.doctorCommand)());
+program.addCommand((0, migrate_1.migrateCommand)());
 program.addCommand((0, measure_1.measureCommand)());
 program.parse();

package/dist/commands/doctor.js

@@ -49,12 +49,22 @@ const AGENT_DIRS = {
 };
 function doctorCommand() {
     return new commander_1.Command('doctor')
-        .description('Check Open Product Primer install health and integration readiness')
+        .description('Check oprim install health and integration readiness')
         .action(() => {
         const projectRoot = process.cwd();
         const checks = [];
-        const primerDir = path.join(projectRoot, 'primer');
-        for (const dir of ['primer', 'primer/decisions', 'primer/bets', 'primer/reviews', 'primer/templates']) {
+        const primerDir = path.join(projectRoot, 'oprim');
+        const legacyPrimerExists = fs.existsSync(path.join(projectRoot, 'primer'));
+        const oprimExists = fs.existsSync(path.join(projectRoot, 'oprim'));
+        if (legacyPrimerExists && !oprimExists) {
+            checks.push({
+                name: 'migration: primer/ detected',
+                pass: false,
+                note: "Run 'oprim migrate' to rename primer/ to oprim/",
+                required: true,
+            });
+        }
+        for (const dir of ['oprim', 'oprim/decisions', 'oprim/bets', 'oprim/reviews', 'oprim/templates']) {
             const exists = fs.existsSync(path.join(projectRoot, dir));
             checks.push({
                 name: `scaffold: ${dir}/`,
@@ -66,14 +76,14 @@ function doctorCommand() {
         const configPath = path.join(primerDir, 'config.yaml');
         const configExists = fs.existsSync(configPath);
         checks.push({
-            name: 'config: primer/config.yaml',
+            name: 'config: oprim/config.yaml',
             pass: configExists,
             note: configExists ? undefined : "Run 'oprim init' to create",
             required: true,
         });
         const sequenceExists = fs.existsSync(path.join(primerDir, 'sequence.yaml'));
         checks.push({
-            name: 'config: primer/sequence.yaml',
+            name: 'config: oprim/sequence.yaml',
             pass: sequenceExists,
             note: sequenceExists ? undefined : "Run 'oprim init' to create",
             required: true,
@@ -117,6 +127,26 @@ function doctorCommand() {
                     : 'No bigquery metrics in criteria.yaml — not required',
             required: false,
         });
+        // ── Discovery checks — warn if bet is missing discovery.md ───────────────
+        const betsDir = path.join(primerDir, 'bets');
+        if (fs.existsSync(betsDir)) {
+            const betEntries = fs.readdirSync(betsDir, { withFileTypes: true });
+            for (const entry of betEntries) {
+                if (!entry.isDirectory())
+                    continue;
+                const betDir = path.join(betsDir, entry.name);
+                const hasDecision = fs.existsSync(path.join(betDir, 'bet-decision.md'));
+                if (!hasDecision)
+                    continue;
+                const hasDiscovery = fs.existsSync(path.join(betDir, 'discovery.md'));
+                checks.push({
+                    name: `discovery: ${entry.name}/discovery.md`,
+                    pass: hasDiscovery,
+                    note: hasDiscovery ? undefined : 'discovery.md missing — consider adding discovery context',
+                    required: false,
+                });
+            }
+        }
         // ── Agent environment checks ──────────────────────────────────────────────
         const configAgents = (0, detect_1.readAgentsFromConfig)(projectRoot);
         if (configAgents !== null) {
@@ -154,7 +184,7 @@ function doctorCommand() {
                 required: false,
             });
         }
-        console.log(chalk_1.default.bold('Open Product Primer') + ' — health check\n');
+        console.log(chalk_1.default.bold('oprim') + ' — health check\n');
         for (const check of checks) {
             const icon = check.pass ? chalk_1.default.green('✓') : check.required ? chalk_1.default.red('✗') : chalk_1.default.yellow('○');
             const label = check.pass ? chalk_1.default.white(check.name) : chalk_1.default.gray(check.name);

package/dist/commands/init.js

@@ -46,20 +46,20 @@ const install_agent_1 = require("../lib/install-agent");
 const templates_1 = require("../lib/templates");
 function initCommand() {
     return new commander_1.Command('init')
-        .description('Initialize Open Product Primer in the current repository')
+        .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)', (val, prev) => [...prev, val], [])
         .action(async (opts) => {
         const projectRoot = process.cwd();
         const projectName = opts.name ?? path.basename(projectRoot);
-        console.log(chalk_1.default.bold('Open Product Primer') + ' — initializing project workspace...\n');
+        console.log(chalk_1.default.bold('oprim') + ' — initializing project workspace...\n');
         const openspec = (0, detect_1.detectOpenSpec)(projectRoot);
         const graphify = (0, detect_1.detectGraphify)(projectRoot);
         if (openspec.detected)
             console.log(chalk_1.default.green('✓') + ' OpenSpec detected');
         if (graphify.detected)
             console.log(chalk_1.default.green('✓') + ' Graphify detected');
-        const primerDir = path.join(projectRoot, 'primer');
+        const primerDir = path.join(projectRoot, 'oprim');
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'decisions'));
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'bets'));
         (0, scaffold_1.ensureDir)(path.join(primerDir, 'reviews'));
@@ -70,15 +70,16 @@ function initCommand() {
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'bet-decision.md'), templates_1.betDecisionTemplate);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'criteria.yaml'), templates_1.criteriaTemplate);
         (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'kpi-review.md'), templates_1.kpiReviewTemplate);
+        (0, scaffold_1.writeFile)(path.join(primerDir, 'templates', 'discovery.md'), templates_1.discoveryTemplate);
         (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'decisions', '.gitkeep'), '');
         (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'bets', '.gitkeep'), '');
         (0, scaffold_1.writeFileIfAbsent)(path.join(primerDir, 'reviews', '.gitkeep'), '');
-        console.log('\n' + chalk_1.default.green('✓') + ' primer/ workspace created');
+        console.log('\n' + chalk_1.default.green('✓') + ' oprim/ workspace created');
         const configStatus = configWritten ? 'written' : 'preserved (already exists)';
         const sequenceStatus = sequenceWritten ? 'written' : 'preserved (already exists)';
-        console.log('  ' + chalk_1.default.gray('primer/config.yaml') + ' — ' + configStatus);
-        console.log('  ' + chalk_1.default.gray('primer/sequence.yaml') + ' — ' + sequenceStatus);
-        console.log('  ' + chalk_1.default.gray('primer/templates/') + ' — refreshed');
+        console.log('  ' + chalk_1.default.gray('oprim/config.yaml') + ' — ' + configStatus);
+        console.log('  ' + chalk_1.default.gray('oprim/sequence.yaml') + ' — ' + sequenceStatus);
+        console.log('  ' + chalk_1.default.gray('oprim/templates/') + ' — refreshed');
         // ── Agent selection ───────────────────────────────────────────────────────
         let selectedAgents;
         const flaggedAgents = opts.agent;

package/dist/commands/migrate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function migrateCommand(): Command;

package/dist/commands/migrate.js

@@ -0,0 +1,63 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateCommand = migrateCommand;
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+function migrateCommand() {
+    return new commander_1.Command('migrate')
+        .description('Rename primer/ to oprim/ in the current repository')
+        .action(() => {
+        const projectRoot = process.cwd();
+        const legacyDir = path.join(projectRoot, 'primer');
+        const targetDir = path.join(projectRoot, 'oprim');
+        if (fs.existsSync(targetDir)) {
+            console.log(chalk_1.default.green('✓') + ' oprim/ already exists — nothing to migrate.');
+            return;
+        }
+        if (!fs.existsSync(legacyDir)) {
+            console.error(chalk_1.default.red('✗') + ' No primer/ directory found — run ' + chalk_1.default.cyan('oprim init') + ' to create oprim/.');
+            process.exit(1);
+        }
+        fs.renameSync(legacyDir, targetDir);
+        console.log(chalk_1.default.green('✓') + ' Renamed ' + chalk_1.default.gray('primer/') + ' → ' + chalk_1.default.gray('oprim/'));
+        console.log('\nRun ' + chalk_1.default.cyan('oprim doctor') + ' to verify your setup.');
+    });
+}

package/dist/lib/detect.js

@@ -50,7 +50,7 @@ function detectGraphify(projectRoot) {
     return { detected, graphDir: detected ? 'graphify-out' : null };
 }
 function readAgentsFromConfig(projectRoot) {
-    const configPath = path.join(projectRoot, 'primer', 'config.yaml');
+    const configPath = path.join(projectRoot, 'oprim', 'config.yaml');
     if (!fs.existsSync(configPath))
         return null;
     const content = fs.readFileSync(configPath, 'utf-8');
@@ -71,7 +71,7 @@ function detectAvailableAgents(projectRoot) {
     return detected;
 }
 function writeAgentsToConfig(agents, projectRoot) {
-    const configPath = path.join(projectRoot, 'primer', 'config.yaml');
+    const configPath = path.join(projectRoot, 'oprim', 'config.yaml');
     if (!fs.existsSync(configPath))
         return;
     const content = fs.readFileSync(configPath, 'utf-8');

package/dist/lib/install-agent.js

@@ -155,10 +155,10 @@ ${body}`;
 function pdrSkill() {
     return `---
 name: oprim-pdr
-description: Create a new Product Decision Record in primer/decisions/ with auto-assigned ID and guided prompting
+description: Create a new Product Decision Record in oprim/decisions/ with auto-assigned ID and guided prompting
 ---
 
-Create a new Product Decision Record (PDR) in \`primer/decisions/\`.
+Create a new Product Decision Record (PDR) in \`oprim/decisions/\`.
 
 ## Steps
 
@@ -166,9 +166,9 @@ Create a new Product Decision Record (PDR) in \`primer/decisions/\`.
 If not provided, ask: "What is the title of this product decision?"
 
 ### 2. Assign the next PDR ID
-Scan \`primer/decisions/\` for files matching \`PDR-(\\d+)-\`. Extract all integers. Assign max+1, zero-padded to 3 digits. Default \`001\` if none found.
+Scan \`oprim/decisions/\` for files matching \`PDR-(\\d+)-\`. Extract all integers. Assign max+1, zero-padded to 3 digits. Default \`001\` if none found.
 Slug: title → lowercase → spaces to hyphens → remove non-alphanumeric (except hyphens).
-Output path: \`primer/decisions/PDR-NNN-<slug>.md\`
+Output path: \`oprim/decisions/PDR-NNN-<slug>.md\`
 
 ### 3. Gather content
 Ask: Context (what forced this decision), Decision (clear statement), Alternatives considered (why rejected), Consequences (positives / trade-offs / follow-ups), Evidence links (optional), Related bets (optional), Related OpenSpec changes (optional).
@@ -215,10 +215,10 @@ Read the superseded file → replace Status value with \`Superseded by PDR-NNN\`
 function betSkill() {
     return `---
 name: oprim-bet
-description: Create a new bet directory and bet-decision artifact in primer/bets/, and add the bet to primer/sequence.yaml backlog
+description: Create a new bet directory and bet-decision artifact in oprim/bets/, and add the bet to oprim/sequence.yaml backlog
 ---
 
-Create a new bet in \`primer/bets/\` and register it on the sequencing board.
+Create a new bet in \`oprim/bets/\` and register it on the sequencing board.
 
 ## Steps
 
@@ -226,15 +226,15 @@ Create a new bet in \`primer/bets/\` and register it on the sequencing board.
 If not provided, ask: "What is the title of this bet?"
 
 ### 2. Assign the next BET ID
-Scan \`primer/bets/\` for directories matching \`BET-(\\d+)$\`. Extract all integers. Assign max+1, zero-padded to 3 digits. Default \`001\` if none.
+Scan \`oprim/bets/\` for directories matching \`BET-(\\d+)$\`. Extract all integers. Assign max+1, zero-padded to 3 digits. Default \`001\` if none.
 
 ### 3. Check sequence.yaml exists
-If \`primer/sequence.yaml\` not found: report and stop — advise \`oprim init\`.
+If \`oprim/sequence.yaml\` not found: report and stop — advise \`oprim init\`.
 
 ### 4. Gather content
 Ask: Decision (Build now / Defer / Kill, default Build now), Owner, Review date (YYYY-MM-DD), Why now, Alternatives considered, Expected outcomes (metric: baseline → target in timeframe), Kill criteria / rollback trigger, PDR links (optional).
 
-### 5. Write primer/bets/BET-NNN/bet-decision.md
+### 5. Write oprim/bets/BET-NNN/bet-decision.md
 \`\`\`
 # Decision: BET-NNN <title>
 
@@ -261,7 +261,7 @@ Ask: Decision (Build now / Defer / Kill, default Build now), Owner, Review date
 - OpenSpec change: <to be filled when promoted>
 \`\`\`
 
-### 6. Append to primer/sequence.yaml backlog
+### 6. Append to oprim/sequence.yaml backlog
 Read → parse YAML → append → write back (2-space indentation):
 \`\`\`yaml
 - id: BET-NNN
@@ -271,7 +271,12 @@ Read → parse YAML → append → write back (2-space indentation):
   requires_pdrs: []
 \`\`\`
 
-### 7. Report what was created
+### 7. Prompt for optional discovery scaffolding
+Ask: "Do you want to scaffold a discovery.md now? (y/N)"
+- If "y": write \`oprim/bets/BET-NNN/discovery.md\` from the discovery template (same structure as \`oprim/templates/discovery.md\`).
+- If "n" or Enter: skip silently.
+
+### 8. Report what was created
 `;
 }
 function criteriaSkill() {
@@ -280,7 +285,7 @@ name: oprim-criteria
 description: Create or append to a criteria.yaml contract for a bet, with structured Amplitude and BigQuery source mapping
 ---
 
-Create or append to \`primer/bets/BET-NNN/criteria.yaml\`.
+Create or append to \`oprim/bets/BET-NNN/criteria.yaml\`.
 
 ## Steps
 
@@ -288,7 +293,7 @@ Create or append to \`primer/bets/BET-NNN/criteria.yaml\`.
 If not provided, ask: "Which bet are you adding criteria for? (e.g. BET-042)"
 
 ### 2. Verify bet exists
-If \`primer/bets/BET-NNN/\` not found: report and stop — advise \`/oprim:bet\` first.
+If \`oprim/bets/BET-NNN/\` not found: report and stop — advise \`/oprim:bet\` first.
 
 ### 3. Gather metric details
 Ask: metric ID (snake_case), metric name, baseline (numeric), target (numeric), timeframe, launch date (YYYY-MM-DD or TBD), segment (optional).
@@ -333,7 +338,7 @@ name: oprim-review
 description: Create a KPI review artifact for a completed bet, pre-filled from criteria.yaml with actuals gathered from the user
 ---
 
-Create a KPI review in \`primer/reviews/\`.
+Create a KPI review in \`oprim/reviews/\`.
 
 ## Steps
 
@@ -342,10 +347,10 @@ If not provided, ask: "Which bet are you reviewing? (e.g. BET-042)"
 
 ### 2. Load criteria and check for a run result
 
-Read \`primer/bets/BET-NNN/criteria.yaml\` if it exists (pre-fills baseline and target).
+Read \`oprim/bets/BET-NNN/criteria.yaml\` if it exists (pre-fills baseline and target).
 If not found: inform user and continue with empty metrics list.
 
-**Check for measurement run result:** Scan \`primer/bets/BET-NNN/measurements/\` for files matching \`run-*.yaml\`. If any exist, sort by filename (date-based) and read the most recent.
+**Check for measurement run result:** Scan \`oprim/bets/BET-NNN/measurements/\` for files matching \`run-*.yaml\`. If any exist, sort by filename (date-based) and read the most recent.
 
 **If a run result exists:** use it to pre-populate actuals and status for every metric. Skip step 3 for those metrics. Note the run date — include "Actuals from run: YYYY-MM-DD" in the review artifact.
 
@@ -363,7 +368,7 @@ Status logic:
 Ask: reviewer name, decision quality notes.
 
 ### 5. Output path
-\`primer/reviews/YYYY-MM-DD-BET-NNN-kpi.md\` (today's date)
+\`oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md\` (today's date)
 
 ### 6. Write the review file
 \`\`\`markdown
@@ -391,16 +396,16 @@ Ask: reviewer name, decision quality notes.
 }
 // ─── Cursor inline content (condensed versions for command files) ─────────────
 function pdrInlineContent() {
-    return `Create a new PDR in \`primer/decisions/\`. Scan for \`PDR-(\\d+)-\` to assign next ID (zero-padded, default 001). Gather: title, context, decision, alternatives, consequences, evidence, related bets/specs. Ask if superseding an existing PDR. Write \`primer/decisions/PDR-NNN-<slug>.md\`. If superseding: update old PDR Status to "Superseded by PDR-NNN". Report what was created.`;
+    return `Create a new PDR in \`oprim/decisions/\`. Scan for \`PDR-(\\d+)-\` to assign next ID (zero-padded, default 001). Gather: title, context, decision, alternatives, consequences, evidence, related bets/specs. Ask if superseding an existing PDR. Write \`oprim/decisions/PDR-NNN-<slug>.md\`. If superseding: update old PDR Status to "Superseded by PDR-NNN". Report what was created.`;
 }
 function betInlineContent() {
-    return `Create a new bet in \`primer/bets/\`. Scan \`BET-(\\d+)$\` dirs for next ID (zero-padded, default 001). Check \`primer/sequence.yaml\` exists (stop if not — advise oprim init). Gather: title, decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write \`primer/bets/BET-NNN/bet-decision.md\`. Append entry to sequence.yaml backlog: \`{id, title, blocked_by: [], unlocks: [], requires_pdrs: []}\`. Report what was created.`;
+    return `Create a new bet in \`oprim/bets/\`. Scan \`BET-(\\d+)$\` dirs for next ID (zero-padded, default 001). Check \`oprim/sequence.yaml\` exists (stop if not — advise oprim init). Gather: title, decision (default Build now), owner, review date, why-now, alternatives, expected outcomes, kill criteria, PDR links. Write \`oprim/bets/BET-NNN/bet-decision.md\`. 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/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.`;
 }
 function criteriaInlineContent() {
-    return `Add metrics to \`primer/bets/BET-NNN/criteria.yaml\`. Verify bet dir exists. Gather: metric ID, name, baseline, target, timeframe, launch date, segment. Ask source type (amplitude or bigquery). Amplitude: event, aggregation, denominator_event. BigQuery: table, metric_column, filter, aggregation, denominator_query. If file exists: append to metrics list (never overwrite). If not: create. Ask if adding more metrics. Report what was created.`;
+    return `Add metrics to \`oprim/bets/BET-NNN/criteria.yaml\`. Verify bet dir exists. Gather: metric ID, name, baseline, target, timeframe, launch date, segment. Ask source type (amplitude or bigquery). Amplitude: event, aggregation, denominator_event. BigQuery: table, metric_column, filter, aggregation, denominator_query. If file exists: append to metrics list (never overwrite). If not: create. Ask if adding more metrics. Report what was created.`;
 }
 function reviewInlineContent() {
-    return `Create KPI review in \`primer/reviews/YYYY-MM-DD-BET-NNN-kpi.md\`. Read \`criteria.yaml\` for pre-fill (baseline/target). Check \`primer/bets/BET-NNN/measurements/\` for \`run-*.yaml\` files — if found, use the most recent to pre-populate actuals and status (include "Actuals from run: YYYY-MM-DD" note). If no run result, ask for each metric's actual value. Status: actual >= target → hit, actual < target → missed, not provided → pending. Ask reviewer name and decision quality notes. Write review with metric table and Actions checklist. Report what was created.`;
+    return `Create KPI review in \`oprim/reviews/YYYY-MM-DD-BET-NNN-kpi.md\`. Read \`criteria.yaml\` for pre-fill (baseline/target). Check \`oprim/bets/BET-NNN/measurements/\` for \`run-*.yaml\` files — if found, use the most recent to pre-populate actuals and status (include "Actuals from run: YYYY-MM-DD" note). If no run result, ask for each metric's actual value. Status: actual >= target → hit, actual < target → missed, not provided → pending. Ask reviewer name and decision quality notes. Write review with metric table and Actions checklist. Report what was created.`;
 }
 // ─── Legacy content (promote / sequence remain inline) ───────────────────────
 function promoteContent() {
@@ -411,15 +416,24 @@ Promote a prioritized bet to an OpenSpec change and link criteria contracts.
 
 **Steps**
 
-1. **Locate the bet** — read \`primer/bets/BET-XXX/bet-decision.md\`
+1. **Locate the bet** — read \`oprim/bets/BET-XXX/bet-decision.md\`
 2. **Validate status** — decision must be "Build now"
 3. **Check authority boundary** — confirm primer artifact owns why/order/outcome only
-4. **Create OpenSpec change** — run \`openspec propose <change-name>\` or create change directory
+4. **Create OpenSpec change** — derive the change name as \`bet-NNN-<slug>\` where \`NNN\` is the zero-padded bet number (e.g. BET-004 → \`bet-004\`) and \`<slug>\` is a short kebab-case summary of the change. Then invoke the \`/openspec-propose\` skill (or \`/opsx:propose\`) with that name to create the change directory with **all required artifacts**: \`proposal.md\`, \`design.md\`, \`tasks.md\`, and \`specs/<capability>/spec.md\` for every capability listed under \`## Capabilities\`.
+   - Pass the bet decision content as context so the proposal reflects the bet's why/outcome
+   - **Do not manually create a partial change directory** — the propose skill ensures no artifact is omitted
+   - The spec file(s) are mandatory: each capability modified or added must have WHEN/THEN scenarios under \`## ADDED Requirements\` or \`## MODIFIED Requirements\`
 5. **Link artifacts**:
    - Add OpenSpec change path to bet-decision \`## Links\` section
-   - Add bet ID to OpenSpec proposal context
-6. **Copy criteria** — if \`primer/bets/BET-XXX/criteria.yaml\` exists, link it from OpenSpec proposal
-7. **Report** — show what was linked and what remains for engineering
+   - Add bet ID to OpenSpec proposal \`## Context\` section
+6. **Copy criteria** — if \`oprim/bets/BET-XXX/criteria.yaml\` exists, link it from OpenSpec proposal
+7. **Verify completeness** — confirm the change directory contains:
+   - \`proposal.md\`
+   - \`design.md\`
+   - \`tasks.md\`
+   - \`specs/<capability>/spec.md\` for each capability in \`## Capabilities\`
+   If any artifact is missing, create it before reporting done.
+8. **Report** — show what was linked and what remains for engineering
 `;
 }
 function sequenceContent() {
@@ -428,10 +442,10 @@ Validate the primer sequencing board and suggest rebalancing if needed.
 
 **Steps**
 
-1. **Read board** — load \`primer/sequence.yaml\`
+1. **Read board** — load \`oprim/sequence.yaml\`
 2. **Check WIP limits** — compare \`now\` count against \`wip_limits.now\`
 3. **Validate blockers** — for each bet in \`now\`, confirm all \`blocked_by\` entries are complete or absent
-4. **Validate PDR preconditions** — confirm all \`requires_pdrs\` entries exist in \`primer/decisions/\`
+4. **Validate PDR preconditions** — confirm all \`requires_pdrs\` entries exist in \`oprim/decisions/\`
 5. **Report violations** — list any WIP excess, unresolved blockers, or missing PDRs
 6. **Suggest moves** — recommend bets to defer to \`next\` or \`later\` to resolve violations
 `;

package/dist/lib/templates.d.ts

@@ -3,4 +3,5 @@ export declare const sequenceTemplate = "wip_limits:\n  now: 2\n\nnow: []\nnext:
 export declare const pdrTemplate = "# PDR-XXX: <Decision title>\n\n## Status\nProposed | Accepted | Deprecated | Superseded by PDR-YYY\n\n## Context\n<What forced this decision?>\n\n## Decision\n<Clear statement of what is decided>\n\n## Alternatives considered\n- <Alternative A and why rejected>\n- <Alternative B and why rejected>\n\n## Consequences\n- Positive: <...>\n- Trade-offs: <...>\n- Follow-ups: <...>\n\n## Evidence\n- <Research link>\n- <Data link>\n\n## Related\n- Bets: <BET-IDs>\n- OpenSpec: <change paths>\n- Supersedes: <PDR-ID or none>\n";
 export declare const betDecisionTemplate = "# Decision: BET-XXX <Bet title>\n\n## Status\n- Decision: Build now | Defer | Kill\n- Date: YYYY-MM-DD\n- Owner: <name>\n- Review date: YYYY-MM-DD\n\n## Why now\n- <prioritization rationale>\n\n## Alternatives considered\n- <alternative + reason>\n\n## Expected outcomes\n- <metric: baseline -> target in timeframe>\n\n## Kill criteria / rollback trigger\n- <condition and action>\n\n## Links\n- PDRs: <PDR-IDs>\n- OpenSpec change: <path once promoted>\n";
 export declare const criteriaTemplate = "metrics:\n  - id: metric_id\n    name: \"Metric name\"\n    baseline: 0.00\n    target: 0.00\n    timeframe: \"30 days post-launch\"\n    launch_date: \"YYYY-MM-DD\"\n    source:\n      type: amplitude\n      definition:\n        event: event_name\n        aggregation: unique_users\n        denominator_event: null\n    segment: null\n";
+export declare const discoveryTemplate = "# Discovery: BET-XXX <Bet title>\n\n## Problem Framing\n- **Problem statement**: <What problem are we solving and for whom?>\n- **Evidence this is real**: <Data, support tickets, user quotes, etc.>\n- **Why it matters**: <Business or user impact if left unsolved>\n\n## User Research Signals\n- **Research conducted**: <Interviews, surveys, usability tests, etc.>\n- **Key findings**: <What did we learn?>\n- **Assumptions to validate**: <What are we still unsure about?>\n\n## Competitive Context\n- **How others solve this**: <Competitor or adjacent solutions>\n- **Our differentiation**: <Why our approach is better or different>\n- **Gaps / opportunities**: <What's underserved in the market?>\n\n## Open Questions\n- [ ] <Question 1 \u2014 what needs to be answered before committing?>\n- [ ] <Question 2>\n- [ ] <Question 3>\n";
 export declare const kpiReviewTemplate = "# KPI Review: BET-XXX\n\n**Review date:** YYYY-MM-DD\n**Reviewed by:** <name>\n\n| Metric | Baseline | Target | Actual | Status |\n|--------|----------|--------|--------|--------|\n| <metric name> | - | - | - | pending |\n\n## Decision quality\n<Did outcomes validate the decision? What would you do differently?>\n\n## Actions\n- [ ] Update bet-decision outcome section\n- [ ] Update affected PDRs\n- [ ] Re-sequence impacted bets\n";

package/dist/lib/templates.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.kpiReviewTemplate = exports.criteriaTemplate = exports.betDecisionTemplate = exports.pdrTemplate = exports.sequenceTemplate = void 0;
+exports.kpiReviewTemplate = exports.discoveryTemplate = exports.criteriaTemplate = exports.betDecisionTemplate = exports.pdrTemplate = exports.sequenceTemplate = void 0;
 exports.configTemplate = configTemplate;
 function configTemplate(projectName, openspecEnabled, graphifyEnabled) {
     return `version: 1
@@ -101,6 +101,28 @@ exports.criteriaTemplate = `metrics:
         denominator_event: null
     segment: null
 `;
+exports.discoveryTemplate = `# Discovery: BET-XXX <Bet title>
+
+## Problem Framing
+- **Problem statement**: <What problem are we solving and for whom?>
+- **Evidence this is real**: <Data, support tickets, user quotes, etc.>
+- **Why it matters**: <Business or user impact if left unsolved>
+
+## User Research Signals
+- **Research conducted**: <Interviews, surveys, usability tests, etc.>
+- **Key findings**: <What did we learn?>
+- **Assumptions to validate**: <What are we still unsure about?>
+
+## Competitive Context
+- **How others solve this**: <Competitor or adjacent solutions>
+- **Our differentiation**: <Why our approach is better or different>
+- **Gaps / opportunities**: <What's underserved in the market?>
+
+## Open Questions
+- [ ] <Question 1 — what needs to be answered before committing?>
+- [ ] <Question 2>
+- [ ] <Question 3>
+`;
 exports.kpiReviewTemplate = `# KPI Review: BET-XXX
 
 **Review date:** YYYY-MM-DD

package/package.json

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