feat(skills): add spec generator + linear task runner with agent prompt consolidation

- Add SpecGeneratorSkill: 4-doc system (ONE_PAGER → DEV_SPEC → PROMPT_PLAN → AGENTS.md) with progressive context
- Add LinearTaskRunner: bridges Linear tasks → RLM orchestrator → status updates
- Add /spec and /linear-run Claude Code skills (.claude/skills/)
- Wire skills into CLI (stackmemory skills spec/linear-run), hooks (on-task-complete auto-updates PROMPT_PLAN), and skill-rules.json
- Rewrite all 8 RLM subagent system prompts with structured JSON output specs and project constraints
- Update model IDs to latest family (sonnet-4-5, haiku-4-5, opus-4-6) and pricing table
- Rewrite buildAgentPrompt() with structured template + spec context injection
- Fix async command registration race condition (await lazy imports before program.parse)
- Fix skills.ts version.js import (lazy resolution from package.json)
- Consolidate tests from 518 → 498 without losing coverage

Author: StackMemory Bot (CLI)

.claude/hooks/on-task-complete.js

@@ -7,14 +7,15 @@
 
 import { ChromaDBContextSaver, TRIGGER_EVENTS } from './chromadb-save-hook.js';
 import fs from 'fs';
+import path from 'path';
 
 async function onTaskComplete() {
   try {
     // Read Claude's input about the completed task
     const input = JSON.parse(fs.readFileSync(0, 'utf-8'));
-    
+
     const saver = new ChromaDBContextSaver();
-    
+
     // Save context about task completion
     await saver.saveContext(TRIGGER_EVENTS.TASK_COMPLETE, {
       task: input.task || input.description || 'Unknown task',
@@ -24,19 +25,53 @@ async function onTaskComplete() {
       summary: input.summary || '',
       nextSteps: input.nextSteps || [],
     });
-    
+
     // Also update Linear if it's a STA task
     if (input.task && input.task.includes('STA-')) {
-      const { LinearUpdateSkill } = await import('../../../scripts/claude-linear-skill.js');
+      const { LinearUpdateSkill } =
+        await import('../../../scripts/claude-linear-skill.js');
       const skill = new LinearUpdateSkill();
-      
+
       if (skill.apiKey) {
         await skill.processUpdate(`${input.task} is completed`, {
           comment: input.summary,
         });
       }
     }
-    
+
+    // Auto-update PROMPT_PLAN checkboxes if spec exists
+    const promptPlanPath = path.join(
+      process.cwd(),
+      'docs',
+      'specs',
+      'PROMPT_PLAN.md'
+    );
+    if (fs.existsSync(promptPlanPath) && input.task) {
+      try {
+        let content = fs.readFileSync(promptPlanPath, 'utf-8');
+        // Find unchecked items matching the task title (fuzzy match on keywords)
+        const taskWords = input.task.split(/\s+/).filter((w) => w.length > 3);
+        const lines = content.split('\n');
+        let updated = false;
+        for (let i = 0; i < lines.length; i++) {
+          if (
+            lines[i].includes('- [ ]') &&
+            taskWords.some((w) =>
+              lines[i].toLowerCase().includes(w.toLowerCase())
+            )
+          ) {
+            lines[i] = lines[i].replace('- [ ]', '- [x]');
+            updated = true;
+            break; // Only check off one item per task completion
+          }
+        }
+        if (updated) {
+          fs.writeFileSync(promptPlanPath, lines.join('\n'));
+        }
+      } catch (_e) {
+        // Silently fail - PROMPT_PLAN update is best-effort
+      }
+    }
   } catch (error) {
     // Silently fail to not block Claude
     fs.appendFileSync(
@@ -46,4 +81,4 @@ async function onTaskComplete() {
   }
 }
 
-onTaskComplete();
+onTaskComplete();

.claude/hooks/skill-rules.json

@@ -239,6 +239,36 @@
         ],
         "contentPatterns": ["performance\\.now", "console\\.time", "profiler"]
       }
+    },
+    "spec-generator": {
+      "description": "Iterative spec document generation (one-pager, dev-spec, prompt-plan, agents)",
+      "priority": 8,
+      "triggers": {
+        "keywords": ["spec", "one-pager", "dev-spec", "prompt-plan", "agents.md", "scaffold"],
+        "keywordPatterns": ["\\bspec\\b", "one.pager", "dev.spec", "prompt.plan"],
+        "pathPatterns": ["docs/specs/**", "**/AGENTS.md", "**/ONE_PAGER.md", "**/PROMPT_PLAN.md"],
+        "intentPatterns": [
+          "(?:generate|create).*(?:spec|one-pager|dev-spec)",
+          "(?:spec).*(?:generate|validate|update|list)"
+        ],
+        "contentPatterns": ["SpecGeneratorSkill", "ONE_PAGER", "DEV_SPEC", "PROMPT_PLAN"]
+      },
+      "relatedSkills": ["linear-task-runner"]
+    },
+    "linear-task-runner": {
+      "description": "Execute Linear tasks via RLM orchestrator",
+      "priority": 8,
+      "triggers": {
+        "keywords": ["linear-run", "run task", "execute task", "task runner", "ralph linear"],
+        "keywordPatterns": ["linear.run", "run.*task", "task.*runner"],
+        "pathPatterns": ["**/linear-task-runner.ts"],
+        "intentPatterns": [
+          "(?:run|execute).*(?:linear|task)",
+          "(?:linear).*(?:run|execute|next|all)"
+        ],
+        "contentPatterns": ["LinearTaskRunner", "runNext", "runAll", "runTask"]
+      },
+      "relatedSkills": ["spec-generator", "linear-integration"]
     }
   }
 }

.claude/skills/linear-run.md

@@ -0,0 +1,63 @@
+# Linear Task Runner Skill
+
+## Description
+Execute Linear tasks using the RLM (Recursive Language Model) orchestrator.
+Pulls tasks from Linear, decomposes via subagents, executes, and updates status.
+
+## Usage
+
+### Run next task
+```
+/linear-run next
+/linear-run next --priority high
+/linear-run next --tag backend
+```
+
+### Run all tasks
+```
+/linear-run all
+/linear-run all --dry-run
+/linear-run all --maxConcurrent 3
+```
+
+### Run specific task
+```
+/linear-run task STA-123
+/linear-run task <task-id>
+```
+
+### Preview execution plan
+```
+/linear-run preview
+/linear-run preview STA-123
+```
+
+## Execution Flow
+
+1. Fetch todo tasks from Linear (sorted by priority)
+2. Mark task as `in_progress`
+3. RLM Orchestrator decomposes task into subagent tree
+   - Planning agent breaks down the work
+   - Code/Test/Review subagents execute in parallel
+   - Multi-stage quality review
+4. On success: mark task `done`, sync to Linear
+5. On failure: leave as `in_progress`, log error
+6. If PROMPT_PLAN exists, auto-check completed items
+
+## Options
+- `--priority <level>` — Filter tasks: urgent, high, medium, low
+- `--tag <tag>` — Filter tasks by tag
+- `--dry-run` — Show plan without executing
+- `--maxConcurrent <n>` — Parallel task limit (default: 1, sequential)
+
+## Integration
+- **Linear**: Reads tasks, updates status, syncs changes
+- **RLM Orchestrator**: Decomposes and executes via Claude Code subagents
+- **Spec Generator**: Auto-updates PROMPT_PLAN checkboxes on completion
+
+## CLI Equivalent
+```bash
+stackmemory ralph linear next
+stackmemory ralph linear all
+stackmemory ralph linear preview STA-123
+```

.claude/skills/spec.md

@@ -0,0 +1,75 @@
+# Spec Generator Skill
+
+## Description
+Generate iterative spec documents following the 4-doc VibeScaffold pattern:
+ONE_PAGER → DEV_SPEC → PROMPT_PLAN → AGENTS.md
+
+Later documents automatically read earlier ones from disk (progressive context).
+All specs are written to `docs/specs/` and tracked in git.
+
+## Usage
+
+### Generate a spec
+```
+/spec one-pager "Photo Captioner App"
+/spec dev-spec
+/spec prompt-plan
+/spec agents
+```
+
+### Interactive mode (no arguments)
+```
+/spec
+```
+Prompts for spec type and title interactively.
+
+### List existing specs
+```
+/spec list
+```
+
+### Update (check off items)
+```
+/spec update prompt-plan "Initialize repository and tooling"
+/spec update prompt-plan "Stage A:1"
+```
+
+### Validate completeness
+```
+/spec validate prompt-plan
+/spec validate dev-spec
+```
+
+## Spec Types
+
+| Type | Output | Reads From |
+|------|--------|------------|
+| `one-pager` | `docs/specs/ONE_PAGER.md` | — |
+| `dev-spec` | `docs/specs/DEV_SPEC.md` | ONE_PAGER |
+| `prompt-plan` | `docs/specs/PROMPT_PLAN.md` | ONE_PAGER, DEV_SPEC |
+| `agents` | `AGENTS.md` | ONE_PAGER, DEV_SPEC, PROMPT_PLAN |
+
+## Sections
+
+### ONE_PAGER
+Problem, Audience, Platform, Core Flow, MVP Features, Non-Goals, Metrics
+
+### DEV_SPEC
+Architecture, Tech Stack, API Contracts, Data Models, Auth, Error Handling, Deployment
+
+### PROMPT_PLAN
+Stages A-G with `- [ ]` TDD checkboxes per prompt. Check off as tasks complete.
+
+### AGENTS.md
+Repo Files, Responsibilities, Guardrails, Testing, When to Ask
+
+## Options
+- `--force` — Overwrite existing spec file
+
+## Workflow
+1. Start with `/spec one-pager "My App"` to capture the idea
+2. Generate `/spec dev-spec` — reads ONE_PAGER for context
+3. Generate `/spec prompt-plan` — creates implementation checklist
+4. Generate `/spec agents` — creates agent configuration
+5. As tasks complete, `/spec update prompt-plan "task name"` checks items off
+6. `/spec validate prompt-plan` verifies all items done