jettypod 4.2.1 → 4.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jettypod",
-  "version": "4.2.1",
+  "version": "4.2.2",
   "description": "AI-powered development workflow manager with TDD, BDD, and automatic test generation",
   "main": "jettypod.js",
   "bin": {

package/skills-templates/feature-planning/SKILL.md

@@ -142,18 +142,9 @@ Based on chosen approach, generate:
    - All Then steps (verify outcomes)
 
 3. **Update database** with scenario file path:
-   ```javascript
-   // After creating scenario file AND step definitions
-   const { getDb } = require('../../lib/database');
-   const db = getDb();
-
-   db.run(
-     `UPDATE work_items SET scenario_file = ? WHERE id = ?`,
-     ['features/[feature-slug].feature', featureId],
-     (err) => {
-       if (err) console.error('Failed to update scenario_file:', err);
-     }
-   );
+   ```bash
+   # After creating scenario file AND step definitions
+   sqlite3 .jettypod/work.db "UPDATE work_items SET scenario_file = 'features/[feature-slug].feature' WHERE id = <feature-id>"
    ```
 
 **Template for speed mode (happy path only):**

package/skills-templates/production-mode/SKILL.md

@@ -36,45 +36,24 @@ When this skill is activated, you are helping implement a production mode chore
 
 **MUST RUN FIRST:** Detect which scenario applies to this feature.
 
-**Code to detect context:**
+**To detect context, check these conditions:**
 
-```javascript
-const { detectContext } = require('../../lib/production-context-detector');
-const { getCurrentWork } = require('../../lib/current-work');
-const { getDb } = require('../../lib/database');
+```bash
+# Get current work and parent feature
+jettypod work current
 
-try {
-  const currentWork = getCurrentWork();
+# Check for production scenarios in the feature file
+# (Look for scenarios tagged with @production or containing production-related keywords)
 
-  if (!currentWork) {
-    console.error('❌ No current work found. Run: jettypod work start <chore-id>');
-    return;
-  }
+# Check for production chores
+sqlite3 .jettypod/work.db "SELECT COUNT(*) FROM work_items WHERE parent_id = <feature-id> AND type = 'chore' AND mode = 'production'"
 
-  if (!currentWork.parent_id) {
-    console.error('❌ Current work has no parent feature.');
-    return;
-  }
-
-  const featureId = currentWork.parent_id;
-  const scenario = await detectContext(featureId);
-
-  console.log(`📋 Detected: ${scenario}`);
-
-  // Proceed with appropriate workflow
-  if (scenario === 'SCENARIO_A') {
-    // Fresh from stable mode - quick validation
-  } else if (scenario === 'SCENARIO_B') {
-    // Gap in time - re-validation
-  } else {
-    // Scenario C - generate from standards
-  }
-} catch (err) {
-  console.error('❌ Context detection failed:', err.message);
-  return;
-}
+# Check when stable mode was completed (for time gap detection)
+sqlite3 .jettypod/work.db "SELECT completed_at FROM work_items WHERE parent_id = <feature-id> AND type = 'chore' AND mode = 'stable' AND status = 'done' ORDER BY completed_at DESC LIMIT 1"
 ```
 
+Based on these checks, determine which scenario applies.
+
 **Three Scenarios:**
 
 **Scenario A: Fresh from Stable (Hot Context)**
@@ -100,29 +79,16 @@ try {
 
 **For all scenarios:** Read production standards file.
 
-```javascript
-const { readStandards, standardsFileExists } = require('../../lib/production-standards-reader');
-
-try {
-  if (!standardsFileExists()) {
-    console.error('❌ Production standards file not found.');
-    console.log('Run external-transition first to generate production standards.');
-    return;
-  }
-
-  const standards = await readStandards();
-  console.log(`📋 Loaded ${standards.standards.length} production standards`);
-  console.log(`Preset: ${standards.preset}`);
+```bash
+# Check if production standards file exists
+ls .jettypod/production-standards.json
 
-  // Show domains
-  const domains = await getDomains();
-  console.log(`Domains: ${domains.join(', ')}`);
-} catch (err) {
-  console.error('❌ Failed to read production standards:', err.message);
-  return;
-}
+# Read the production standards
+cat .jettypod/production-standards.json
 ```
 
+If the file doesn't exist, run external-transition first to generate production standards.
+
 ---
 
 ### Step 2A: Validate Scenarios (Scenario A - Hot Context)
@@ -241,204 +207,63 @@ try {
 
 **For Scenario C only:** Generate production scenarios from standards.
 
-```javascript
-const { generateScenariosFromStandards } = require('../../lib/production-scenario-generator');
-const { appendScenarios } = require('../../lib/production-scenario-appender');
-const { getDb } = require('../../lib/database');
-
-try {
-  console.log('✨ Generating production scenarios from standards...');
-
-  // Get feature
-  const db = getDb();
-  const feature = await new Promise((resolve, reject) => {
-    db.get('SELECT * FROM work_items WHERE id = ?', [featureId], (err, row) => {
-      if (err) reject(err);
-      resolve(row);
-    });
-  });
-
-  if (!feature.scenario_file) {
-    console.error('❌ Feature has no scenario file.');
-    return;
-  }
+```bash
+# Get feature details
+sqlite3 .jettypod/work.db "SELECT id, title, scenario_file FROM work_items WHERE id = <feature-id>"
 
-  // Generate scenarios
-  const scenarios = await generateScenariosFromStandards(standards);
-
-  console.log(`✅ Generated ${scenarios.length} production scenarios`);
-  console.log('Domains covered:', [...new Set(standards.standards.map(s => s.domain))].join(', '));
-
-  // Append to feature file
-  await appendScenarios(feature.scenario_file, scenarios);
-  console.log(`✅ Appended scenarios to ${feature.scenario_file}`);
-
-  // Create production chores if none exist
-  const { generateChoresFromStandards } = require('../../lib/production-chore-generator');
-  const chores = generateChoresFromStandards(standards, feature.title);
-
-  console.log(`\n📋 Proposed ${chores.length} production chores:`);
-  chores.forEach((chore, i) => {
-    console.log(`\n${i + 1}. ${chore.title}`);
-    console.log(`   ${chore.description.split('\n')[0]}`);
-  });
-
-  console.log('\n✅ Production scenarios ready. Create chores to implement them.');
-} catch (err) {
-  console.error('❌ Scenario generation failed:', err.message);
-  return;
-}
+# Use jettypod to generate production scenarios
+jettypod work elevate <feature-id> production
 ```
 
+This will:
+1. Read production standards from `.jettypod/production-standards.json`
+2. Generate production scenarios based on applicable standards
+3. Append scenarios to the feature file
+4. Create production chores
+
 ---
 
 ### Step 3: Implement Production Chore
 
 **For all scenarios:** Implement the current production chore with test-driven iteration.
 
-```javascript
-const { getCurrentWork } = require('../../lib/current-work');
-const { getDb } = require('../../lib/database');
-const {
-  MAX_ITERATIONS,
-  TEST_TIMEOUT,
-  runBddTestWithTimeout,
-  runBddScenarioWithTimeout,
-  getScenarioLineByName,
-  parseTestProgress,
-  extractErrors,
-  findNewlyPassingSteps
-} = require('../../.claude/skills/speed-mode/test-runner');
-const fs = require('fs');
-const path = require('path');
-
-try {
-  const currentWork = getCurrentWork();
-
-  console.log(`\n🚀 Implementing: ${currentWork.title}`);
-  console.log(`Description: ${currentWork.description}`);
-
-  // Get parent feature and scenario file
-  const db = getDb();
-  const feature = await new Promise((resolve, reject) => {
-    db.get('SELECT * FROM work_items WHERE id = ?', [currentWork.parent_id], (err, row) => {
-      if (err) reject(err);
-      resolve(row);
-    });
-  });
-
-  if (!feature.scenario_file) {
-    console.error('❌ Feature has no scenario file.');
-    return;
-  }
+**Get current work and identify target scenario:**
 
-  // Identify which production scenario this chore addresses
-  // Parse from chore description (e.g., "Scenario: Rate limiting on login")
-  const scenarioMatch = currentWork.description.match(/Scenario:\s*(.+?)(?:\n|$)/i);
-  if (!scenarioMatch) {
-    console.error('❌ Cannot identify target scenario from chore description.');
-    console.log('Suggestion: Update chore description to reference specific scenario.');
-    return;
-  }
-
-  const targetScenarioName = scenarioMatch[1].trim();
-  const scenarioLine = getScenarioLineByName(feature.scenario_file, targetScenarioName);
+```bash
+# Get current chore details
+jettypod work current
 
-  if (!scenarioLine) {
-    console.error(`❌ Cannot find scenario "${targetScenarioName}" in ${feature.scenario_file}`);
-    return;
-  }
+# Get parent feature's scenario file
+sqlite3 .jettypod/work.db "SELECT scenario_file FROM work_items WHERE id = <parent-feature-id>"
+```
 
-  console.log(`\n📋 Target scenario: ${targetScenarioName} (line ${scenarioLine})`);
+Parse the chore description to find which scenario it addresses (look for "Scenario: ..." in the description).
 
-  // RED→GREEN iteration loop for production implementation
-  let iteration = 0;
-  let scenarioPasses = false;
-  let previousResult = null;
+**RED→GREEN iteration loop:**
 
-  console.log('\n🔴 Establishing RED baseline...\n');
-  const baselineResult = await runBddScenarioWithTimeout(feature.scenario_file, scenarioLine, TEST_TIMEOUT);
+1. **Establish RED baseline:**
+   ```bash
+   npx cucumber-js <scenario-file> --name "<scenario-name>" --format progress
+   ```
 
-  if (!baselineResult.timedOut) {
-    const baselineProgress = parseTestProgress(baselineResult.stdout + baselineResult.stderr);
-    console.log(`RED Baseline: ${baselineProgress.total - baselineProgress.passed} of ${baselineProgress.total} steps failing\n`);
-  }
+2. **Iterate until scenario passes (max 10 iterations):**
+   - Implement production hardening using Edit/Write tools
+   - Run the target scenario to check progress
+   - Parse output to track passing/failing steps
+   - Address first failing step each iteration
 
-  while (!scenarioPasses && iteration < MAX_ITERATIONS) {
-    iteration++;
-    console.log(`\n━━━ Iteration ${iteration}/${MAX_ITERATIONS} ━━━`);
-
-    // 1. Implement production hardening based on standard
-    console.log('✍️  Implementing production hardening...');
-    // [Claude Code uses Edit/Write tools to implement standard requirements]
-
-    // 2. Run target scenario only
-    console.log('🧪 Running target scenario...');
-    const result = await runBddScenarioWithTimeout(feature.scenario_file, scenarioLine, TEST_TIMEOUT);
-
-    if (result.timedOut) {
-      console.error('❌ Tests timed out');
-      break;
-    }
-
-    const currentResult = parseTestProgress(result.stdout + result.stderr);
-    const newlyPassing = previousResult ? findNewlyPassingSteps(previousResult, currentResult) : [];
-
-    console.log(`\n📊 Progress: ${currentResult.passed}/${currentResult.total} steps passing`);
-
-    if (newlyPassing.length > 0) {
-      console.log(`\n✅ Newly passing:`);
-      newlyPassing.forEach(step => console.log(`  • ${step}`));
-    }
-
-    // Check if target scenario passes
-    if (currentResult.passed === currentResult.total && currentResult.total > 0) {
-      console.log('\n✅ Target scenario passing!');
-
-      // Run full verification (all scenarios) once for regression detection
-      console.log('\n🔍 Running full verification (all scenarios)...');
-      const fullResult = await runBddTestWithTimeout(feature.scenario_file, TEST_TIMEOUT);
-
-      if (fullResult.timedOut) {
-        console.log('⚠️  Full verification timed out');
-      } else if (fullResult.exitCode !== 0) {
-        const fullProgress = parseTestProgress(fullResult.stdout + fullResult.stderr);
-        console.log(`⚠️  Full verification found regressions: ${fullProgress.total - fullProgress.passed} scenarios failing`);
-        console.log('Continuing iterations to fix regressions...');
-        scenarioPasses = false;
-      } else {
-        console.log('✅ Full verification passed - all scenarios passing!');
-        scenarioPasses = true;
-      }
-    } else {
-      console.log(`\n❌ ${currentResult.total - currentResult.passed} steps still failing`);
-
-      const errors = extractErrors(result.stdout + result.stderr);
-      if (errors.errors.length > 0) {
-        console.log('\n🔧 Next failure to address:');
-        const firstError = errors.errors[0];
-        console.log(`  Step: ${firstError.step}`);
-        console.log(`  Error: ${firstError.message}`);
-      }
-    }
-
-    previousResult = currentResult;
-  }
-
-  if (!scenarioPasses) {
-    console.error(`\n❌ Maximum iterations (${MAX_ITERATIONS}) reached without passing scenario`);
-    console.log('Review implementation against production standard acceptance criteria.');
-    return;
-  }
+3. **Full verification when target passes:**
+   ```bash
+   npx cucumber-js <scenario-file> --format progress
+   ```
 
-  console.log('\n✅ Production chore implementation complete');
-  console.log('All scenarios passing with production standards enforced.');
+   Ensure all scenarios still pass (no regressions).
 
-} catch (err) {
-  console.error('❌ Implementation failed:', err.message);
-  return;
-}
-```
+**Implementation focus for production chores:**
+- Security measures per standards (rate limiting, input sanitization, etc.)
+- Performance targets per standards
+- Monitoring and observability
+- Compliance requirements
 
 ---
 

package/skills-templates/speed-mode/SKILL.md

@@ -103,46 +103,28 @@ The validation will require you to:
 4. Read the parent feature's scenario file
 5. Parse the Gherkin and identify what needs to be implemented
 
-**Code to check for breadcrumbs:**
+**To get current work and check for breadcrumbs:**
 
-```javascript
-// --- Setup and imports ---
-const { getCurrentWork } = require('../../lib/current-work');
-const { getDb } = require('../../lib/database');
-const fs = require('fs');
-const path = require('path');
+```bash
+# Get current work item with description
+jettypod work current
 
-(async () => {
-  const currentWork = await getCurrentWork();
+# Get parent feature details including scenario_file
+jettypod work show <parent-feature-id>
 
-  // --- Check for breadcrumbs ---
-  const hasBreadcrumbs = currentWork.description &&
-    currentWork.description.includes('Scenario steps addressed:') &&
-    currentWork.description.includes('Implementation guidance:') &&
-    currentWork.description.includes('Verification:');
-
-  // --- Get parent feature from database ---
-  const db = getDb();
-  const feature = await new Promise((resolve, reject) => {
-    db.get('SELECT * FROM work_items WHERE id = ?', [currentWork.parent_id], (err, row) => {
-      if (err) reject(err);
-      else resolve(row);
-    });
-  });
+# Or query database directly
+sqlite3 .jettypod/work.db "SELECT id, title, description, parent_id FROM work_items WHERE status = 'in_progress' AND type = 'chore'"
+sqlite3 .jettypod/work.db "SELECT id, title, scenario_file FROM work_items WHERE id = <parent-feature-id>"
+```
 
-  // --- Validate scenario file exists ---
-  if (!feature.scenario_file) {
-    console.error('No scenario file found for this feature');
-    return;
-  }
+**Check for breadcrumbs** by examining the chore's description for:
+- "Scenario steps addressed:"
+- "Implementation guidance:"
+- "Verification:"
 
-  // --- Read scenario content ---
-  const scenarioPath = path.join(process.cwd(), feature.scenario_file);
-  const scenarioContent = fs.readFileSync(scenarioPath, 'utf8');
+If all three sections exist, use them. Otherwise, fall back to autonomous analysis.
 
-  // Parse and analyze...
-})();
-```
+**Then read the scenario file** using the Read tool on the path returned by `scenario_file`.
 
 **Parse Gherkin:**
 - Extract first `Scenario:` block (happy path)
@@ -202,27 +184,16 @@ Now analyzing codebase to propose implementation...
 
 **Check for architectural decisions:**
 
-**⚠️ IMPORTANT - USE EXACT CODE BELOW:**
-- Import from `./lib/decisions-helpers` (NOT `../../lib/decisions-helpers` or `./features/decisions/index.js`)
-- Function returns a Promise, must use `await`
-
-**Execute this EXACT code (copy/paste as-is):**
+```bash
+# Get the epic ID for this feature
+sqlite3 .jettypod/work.db "SELECT epic_id FROM work_items WHERE id = <feature-id>"
 
-```javascript
-const { getDecisionsForEpic } = require('./lib/decisions-helpers');
-const { getDb } = require('./lib/database');
-const db = getDb();
-
-// Get epic from current work
-db.get('SELECT epic_id FROM work_items WHERE id = ?', [currentWork.parent_id], async (err, feature) => {
-  if (feature && feature.epic_id) {
-    const decisions = await getDecisionsForEpic(feature.epic_id);
-    console.log('Epic decisions:', JSON.stringify(decisions, null, 2));
-    // Decisions constrain your implementation approach
-  }
-});
+# Get decisions for this epic
+sqlite3 .jettypod/work.db "SELECT title, decision, rationale FROM discovery_decisions WHERE work_item_id = <epic-id>"
 ```
 
+Decisions constrain your implementation approach - use them to guide technology choices and patterns.
+
 **If breadcrumbs exist (from feature-planning):**
 - Parse "Files to create/modify" section - these are your target files
 - Parse "Patterns to follow" section - read these reference files first
@@ -322,74 +293,24 @@ If user adjusts: revise proposal and confirm again.
 
 Before writing any implementation code, run tests to establish the RED state:
 
-```javascript
-// --- Imports ---
-const { runBddScenarioWithTimeout, getFirstScenarioLine, parseTestProgress, extractErrors } = require('./.claude/skills/speed-mode/test-runner');
-const { getCurrentWork } = require('./lib/current-work');
-const { getDb } = require('./lib/database');
-
-(async () => {
-  // --- Get current work and parent feature ---
-  const currentWork = await getCurrentWork();
-  const db = getDb();
-
-  const feature = await new Promise((resolve, reject) => {
-    db.get('SELECT * FROM work_items WHERE id = ?', [currentWork.parent_id], (err, row) => {
-      if (err) reject(err);
-      else resolve(row);
-    });
-  });
-
-  if (!feature.scenario_file) {
-    console.error('No scenario file found for this feature');
-    return;
-  }
-
-  console.log('🔴 Establishing RED baseline...\n');
+```bash
+# Get current work and parent feature's scenario file
+jettypod work current
+# Note the parent_id from output
 
-  // --- Find happy path scenario ---
-  const happyPathLine = getFirstScenarioLine(feature.scenario_file);
-  if (!happyPathLine) {
-    console.error('No scenario found in feature file');
-    return;
-  }
+sqlite3 .jettypod/work.db "SELECT scenario_file FROM work_items WHERE id = <parent-feature-id>"
+# This gives you the path to the .feature file
 
-  // --- Run tests before implementation ---
-  const result = await runBddScenarioWithTimeout(feature.scenario_file, happyPathLine);
-  let progress = { passed: 0, total: 0, failedSteps: [] };
-
-  // --- Handle timeout ---
-  if (result.timedOut) {
-    console.log('⚠️  Test execution timed out - tests may be hanging');
-    console.log('Proceeding with implementation...\n');
-  } else {
-    // --- Parse and display results ---
-    progress = parseTestProgress(result.stdout + result.stderr);
-    const errors = extractErrors(result.stdout + result.stderr);
-
-    console.log(`RED Baseline: ${progress.total - progress.passed} of ${progress.total} steps failing`);
-    console.log('\nFailing steps:');
-    progress.failedSteps.forEach(step => console.log(`  ✖ ${step}`));
-
-    // --- Show first error ---
-    if (errors.errors.length > 0) {
-      console.log('\nFirst error:');
-      const firstError = errors.errors[0];
-      console.log(`  Step: ${firstError.step}`);
-      console.log(`  Error: ${firstError.message}`);
-    }
+# Run BDD tests to establish RED baseline
+npx cucumber-js <scenario-file-path> --format progress
+```
 
-    console.log('\n🎯 Goal: Make all steps pass\n');
-  }
+Parse the output to identify:
+- Total steps and how many are failing
+- Which specific steps are failing
+- The first error message
 
-  // --- Store baseline for iteration loop ---
-  global.redBaseline = {
-    passed: progress.passed,
-    total: progress.total,
-    failedSteps: progress.failedSteps
-  };
-})();
-```
+This establishes your RED baseline - all or most steps should be failing initially.
 
 **Display RED baseline:**
 ```
@@ -908,50 +829,20 @@ Chores created:
      │ • If session interrupted, re-query to get current count                │
      └─────────────────────────────────────────────────────────────────────────┘ -->
 
-```javascript
-// --- Imports ---
-const { getDb } = require('../../lib/database');
-const { getCurrentWork } = require('../../lib/current-work');
-
-(async () => {
-  // --- Get current work context ---
-  const currentWork = await getCurrentWork();
-  const featureId = currentWork.parent_id;
-  const db = getDb();
-
-  // --- Query for incomplete speed chores ---
-  const result = await new Promise((resolve, reject) => {
-    db.get(`
-      SELECT COUNT(*) as incomplete_count
-      FROM work_items
-      WHERE parent_id = ?
-        AND type = 'chore'
-        AND mode = 'speed'
-        AND status != 'done'
-    `, [featureId], (err, row) => {
-      if (err) reject(err);
-      else resolve(row);
-    });
-  });
+**Check for incomplete speed chores:**
 
-  // --- Handle completion or remaining chores ---
-  if (result.incomplete_count === 0) {
-    console.log('\n✅ All speed mode chores complete!');
-    console.log('Auto-elevating feature to stable mode...\n');
-    // Use Bash tool to execute elevation
-  } else {
-    console.log(`\n📋 ${result.incomplete_count} speed mode chores remaining`);
-  }
+```bash
+# Get current work to find parent feature ID
+jettypod work current
 
-  db.close();
-})();
+# Count incomplete speed chores for the feature
+sqlite3 .jettypod/work.db "SELECT COUNT(*) FROM work_items WHERE parent_id = <feature-id> AND type = 'chore' AND mode = 'speed' AND status != 'done'"
 ```
 
-**If all speed chores are done, use Bash tool to EXECUTE elevation:**
+**If all speed chores are done (count = 0), EXECUTE elevation:**
 
-```javascript
-// Use Bash tool to execute:
-node jettypod.js work set-mode [feature-id] stable
+```bash
+jettypod work set-mode <feature-id> stable
 ```
 
 **DO NOT display this as example text. EXECUTE IT using the Bash tool.**

package/skills-templates/stable-mode/SKILL.md

@@ -176,148 +176,30 @@ Scenario: [Edge case title]
 3. Identify which scenario this chore addresses
 4. Extract requirements from the scenario's Given/When/Then steps
 
-**Code to get scenario (with error handling):**
+**To get scenario information, use these commands:**
 
-```javascript
-// --- Imports ---
-const { getCurrentWork } = require('../../lib/current-work');
-const { getDb } = require('../../lib/database');
-const fs = require('fs');
-const path = require('path');
-
-(async () => {
-  try {
-    const currentWork = await getCurrentWork();
-
-    // --- Validate current work ---
-    if (!currentWork) {
-      console.error('❌ No current work found. Run: jettypod work start <chore-id>');
-      return;
-    }
-
-    if (!currentWork.parent_id) {
-      console.error('❌ Current work has no parent feature. This chore must be part of a feature.');
-      return;
-    }
-
-    // --- Get parent feature ---
-    const db = getDb();
-    const feature = await new Promise((resolve, reject) => {
-      db.get('SELECT * FROM work_items WHERE id = ?', [currentWork.parent_id], (err, row) => {
-        if (err) reject(err);
-        else resolve(row);
-      });
-    });
-
-    // --- Validate feature ---
-    if (!feature) {
-      console.error('❌ Parent feature not found in database.');
-      db.close();
-      return;
-    }
-
-    if (!feature.scenario_file) {
-      console.error('❌ Feature has no scenario_file. Cannot determine what to implement.');
-      console.log('Suggestion: Create a scenario file and update the feature.');
-      db.close();
-      return;
-    }
-
-    // --- Validate scenario file exists ---
-    const scenarioPath = path.join(process.cwd(), feature.scenario_file);
-
-    if (!fs.existsSync(scenarioPath)) {
-      console.error(`❌ Scenario file not found: ${scenarioPath}`);
-      console.log('Suggestion: Create the scenario file or update the feature.scenario_file path.');
-      db.close();
-      return;
-    }
-
-    // --- Read scenario content ---
-    let scenarioContent;
-    try {
-      scenarioContent = fs.readFileSync(scenarioPath, 'utf8');
-    } catch (readErr) {
-      console.error(`❌ Cannot read scenario file: ${readErr.message}`);
-      db.close();
-      return;
-    }
+```bash
+# Get current work (chore) and its parent feature
+jettypod work current
 
-    // --- Validate content ---
-    if (!scenarioContent || scenarioContent.trim().length === 0) {
-      console.error('❌ Scenario file is empty.');
-      db.close();
-      return;
-    }
+# Get parent feature details including scenario_file
+jettypod work show <parent-feature-id>
 
-    // Parse all scenarios...
-    db.close();
-  } catch (err) {
-    console.error('❌ Unexpected error in Step 1:', err.message);
-    return;
-  }
-})();
+# Or query database directly for scenario file
+sqlite3 .jettypod/work.db "SELECT id, title, scenario_file, mode FROM work_items WHERE id = <parent-feature-id>"
 ```
 
-**Identify target scenario (with error handling):**
-
-```javascript
-// --- Parse scenarios from Gherkin ---
-const scenarios = [];
-const scenarioBlocks = scenarioContent.split(/\nScenario:/);
-
-if (scenarioBlocks.length < 2) {
-  console.error('❌ No scenarios found in scenario file.');
-  console.log('Suggestion: Add Gherkin scenarios to the feature file.');
-  return;
-}
-
-// --- Extract scenario titles ---
-for (let i = 1; i < scenarioBlocks.length; i++) {
-  const block = 'Scenario:' + scenarioBlocks[i];
-  const titleMatch = block.match(/Scenario:\s*(.+)/);
-  const title = titleMatch ? titleMatch[1].trim() : 'Unknown';
-  scenarios.push({ title, content: block });
-}
+**Then read the scenario file** using the Read tool on the path returned by `scenario_file`.
 
-// --- Match scenario to chore ---
-const choreDesc = currentWork.description.toLowerCase();
-let targetScenario = null;
+**Identify target scenario:**
 
-// --- Try match by scenario number ---
-const scenarioNumMatch = choreDesc.match(/scenario\s+(\d+)/);
-if (scenarioNumMatch) {
-  const num = parseInt(scenarioNumMatch[1]);
-  if (num > 0 && num <= scenarios.length) {
-    targetScenario = scenarios[num - 1];
-  }
-}
+After reading the scenario file content, parse it to find the scenario this chore addresses:
 
-// --- Try match by keywords ---
-if (!targetScenario) {
-  for (const scenario of scenarios) {
-    const scenarioLower = scenario.title.toLowerCase();
-    if (scenarios.indexOf(scenario) === 0) continue; // Skip happy path
-
-    const keywords = choreDesc.split(/\s+/).filter(w => w.length > 3);
-    const matches = keywords.filter(k => scenarioLower.includes(k));
-
-    if (matches.length > 0) {
-      targetScenario = scenario;
-      break;
-    }
-  }
-}
-
-// --- Handle no match ---
-if (!targetScenario) {
-  console.error('❌ Cannot match chore to any scenario in feature file.');
-  console.log('Available scenarios:');
-  scenarios.forEach((s, i) => console.log(`  ${i + 1}. ${s.title}`));
-  console.log('\nSuggestion: Update chore description to reference a specific scenario.');
-  return;
-}
-```
+1. Split the file by `Scenario:` to get individual scenarios
+2. Match the chore description to a scenario by:
+   - Looking for scenario numbers in the chore description (e.g., "Scenario 2")
+   - Matching keywords from the chore description to scenario titles
+3. If no match found, list available scenarios and ask which one to implement
 
 **Display to user:**
 
@@ -347,95 +229,21 @@ Now reviewing speed mode implementation...
 3. Identify what's missing for this scenario
 4. Understand current code structure
 
-**Find speed mode files (with error handling):**
+**Find speed mode files using git:**
 
-```javascript
-// --- Imports and setup ---
-const { exec } = require('child_process');
-const util = require('util');
-const execPromise = util.promisify(exec);
-
-let speedModeFiles = [];
-
-try {
-  // --- Search git history for feature commits ---
-  const featureName = feature.title.toLowerCase().replace(/\s+/g, '-');
-  const { stdout: gitLog } = await execPromise(
-    `git log --oneline --all --grep="${featureName}" -10`
-  );
-
-  // --- Handle no commits found ---
-  if (!gitLog || gitLog.trim().length === 0) {
-    console.log('⚠️  No git commits found for this feature.');
-    console.log('\n📝 Which files did speed mode create/modify for this feature?');
-    return;
-  }
-
-  // --- Extract files from commits ---
-  const commits = gitLog.trim().split('\n').map(line => line.split(' ')[0]);
-
-  for (const commit of commits) {
-    try {
-      const { stdout: files } = await execPromise(`git diff-tree --no-commit-id --name-only -r ${commit}`);
-      const fileList = files.trim().split('\n').filter(f => f.length > 0);
-      speedModeFiles.push(...fileList);
-    } catch (diffErr) {
-      continue;
-    }
-  }
-
-  // --- Remove duplicates and validate ---
-  speedModeFiles = [...new Set(speedModeFiles)];
-
-  if (speedModeFiles.length === 0) {
-    console.error('❌ No files found in git history for this feature.');
-    console.log('📝 Which files should be reviewed?');
-    return;
-  }
-
-  console.log(`✅ Found ${speedModeFiles.length} files from speed mode`);
-
-} catch (gitErr) {
-  console.error('⚠️  Git error:', gitErr.message);
-  console.log('📝 Which files did speed mode create/modify?');
-  return;
-}
-
-// --- Validate files are readable ---
-const readableFiles = [];
-const unreadableFiles = [];
-
-for (const filePath of speedModeFiles) {
-  const fullPath = path.join(process.cwd(), filePath);
-
-  if (!fs.existsSync(fullPath)) {
-    console.log(`⚠️  File no longer exists: ${filePath}`);
-    continue;
-  }
-
-  try {
-    fs.accessSync(fullPath, fs.constants.R_OK);
-    readableFiles.push(filePath);
-  } catch (accessErr) {
-    unreadableFiles.push(filePath);
-    console.error(`❌ Cannot read file: ${filePath}`);
-  }
-}
-
-// --- Final validation ---
-if (readableFiles.length === 0) {
-  console.error('❌ No readable speed mode files found.');
-  console.log('Suggestion: Verify speed mode was completed or start from scratch.');
-  return;
-}
+```bash
+# Search git history for commits related to this feature
+git log --oneline --all --grep="<feature-name>" -10
 
-if (unreadableFiles.length > 0) {
-  console.log(`⚠️  ${unreadableFiles.length} files cannot be read - skipping`);
-}
+# Get files changed in those commits
+git diff-tree --no-commit-id --name-only -r <commit-hash>
 
-speedModeFiles = readableFiles;
+# Or find files by looking at the feature's chores
+sqlite3 .jettypod/work.db "SELECT id, title FROM work_items WHERE parent_id = <feature-id> AND type = 'chore' AND mode = 'speed'"
 ```
 
+Then use the Read tool to examine the implementation files.
+
 **Identify gaps:**
 - What error handling is missing?
 - What validation is not performed?
@@ -717,55 +525,23 @@ Lines:      ✅ 84.90%
      └─────────────────────────────────────────────────────────────────────────┘ -->
 
 **Check completion status and project state:**
-```javascript
-// --- Imports ---
-const { getDb } = require('../../lib/database');
-const { getCurrentWork } = require('../../lib/current-work');
-
-(async () => {
-  // --- Get current work context ---
-  const currentWork = await getCurrentWork();
-  const featureId = currentWork.parent_id;
-  const db = getDb();
-
-  // --- Query for incomplete chores ---
-  const result = await new Promise((resolve, reject) => {
-    db.get(`
-      SELECT COUNT(*) as incomplete_count
-      FROM work_items
-      WHERE parent_id = ?
-        AND type = 'chore'
-        AND status NOT IN ('done', 'cancelled')
-    `, [featureId], (err, row) => {
-      if (err) reject(err);
-      else resolve(row);
-    });
-  });
-
-  // --- Handle all chores complete ---
-  if (result.incomplete_count === 0) {
-    const config = await new Promise((resolve, reject) => {
-      db.get('SELECT project_state FROM project_config WHERE id = 1', (err, row) => {
-        if (err) reject(err);
-        else resolve(row);
-      });
-    });
-    const projectState = config?.project_state || 'internal';
-
-    // --- Route based on project state ---
-    if (projectState === 'internal') {
-      console.log('Internal project - no production mode needed');
-    } else {
-      console.log('External project - auto-generating production chores');
-    }
-  } else {
-    console.log(`\n📋 ${result.incomplete_count} stable mode chores remaining`);
-  }
 
-  db.close();
-})();
+```bash
+# Get current work to find parent feature ID
+jettypod work current
+
+# Count incomplete chores for the feature
+sqlite3 .jettypod/work.db "SELECT COUNT(*) FROM work_items WHERE parent_id = <feature-id> AND type = 'chore' AND status NOT IN ('done', 'cancelled')"
+
+# Check project state
+sqlite3 .jettypod/work.db "SELECT project_state FROM project_config WHERE id = 1"
 ```
 
+Based on the results:
+- If incomplete_count > 0: More stable chores remain
+- If incomplete_count = 0 AND project_state = 'internal': Feature is complete
+- If incomplete_count = 0 AND project_state = 'external': Need to generate production chores
+
 **CRITICAL: Check project state to determine next step:**
 
 Check if project is internal or external: