sdd-pipeline 1.2.8 → 1.3.1

package/README.md

@@ -276,22 +276,36 @@ Two Interfaces (same logic):
 Shell CLI:          sdd bmad "feature"      → bin/sdd.cjs
 Claude Code:        /sdd bmad "feature"     → .claude/commands/sdd.md
 
-Pipeline files:
+Project structure:
 ├── .sdd/config.json         # Phase tracking
-├── templates/               # SDD templates
-├── skills/                  # Implementation skills (Phase 4)
-├── .claude/commands/       # Claude Code slash commands
-├── commands/               # Standalone PowerShell scripts
-├── run-converge.ps1        # Validation automation
+├── templates/               # SDD templates (synced from bundle)
+├── skills/                  # Implementation skills (synced from bundle)
+├── .claude/commands/       # Claude Code slash commands (synced from bundle)
+├── commands/               # Standalone PowerShell scripts (synced from bundle)
+├── lib/
+│   ├── bmad.js            # BMAD CLI wrapper
+│   ├── bmad/              # BMAD modules
+│   └── bundle/             # SOURCE OF TRUTH for npm package
+├── scripts/
+│   └── sync-bundle.ps1    # Sync bundle to working directories
 └── extensions/             # Domain-specific (api/frontend/backend)
 
 npm package (sdd-pipeline):
 ├── bin/sdd.cjs            # CLI entry
-├── lib/init.js            # Extract pipeline
+├── lib/bmad.js           # CLI wrapper
 ├── lib/bmad/              # BMAD orchestrator
-└── lib/bundle/           # 70 pipeline files for distribution
+└── lib/bundle/           # All pipeline files for distribution
 ```
 
+### Development Workflow
+
+1. Edit files in `lib/bundle/` (source of truth)
+2. Run `npm run sync` to sync to working directories
+3. Test with `npm run pack --dry-run`
+4. Commit and publish
+
+**Important:** After modifying `lib/bundle/`, always run `npm run sync` before testing!
+
 ---
 
 ## Requirements
@@ -314,7 +328,7 @@ jobs:
     runs-on: windows-latest
     steps:
       - uses: actions/checkout@v4
-      - run: pwsh run-converge.ps1 -Url '${{ env.DEV_URL }}' -Strict
+      - run: pwsh lib/bundle/run-converge.ps1 -Url '${{ env.DEV_URL }}' -Strict
 ```
 
 ---
@@ -324,7 +338,7 @@ jobs:
 | Field | Value |
 |-------|-------|
 | Name | `sdd-pipeline` |
-| Version | `1.2.7` |
+| Version | `1.3.0` |
 | Registry | npmjs.com |
 | CLI command | `sdd` |
 | Claude Code command | `/sdd` |

package/bin/sdd.cjs

@@ -143,10 +143,10 @@ switch (cmd) {
     console.log('=== SDD Converge Validation ===')
     console.log('')
     console.log('Full validation (requires dev server):')
-    console.log('  pwsh run-converge.ps1 -Url http://localhost:3000 -Strict')
+    console.log('  pwsh lib/bundle/run-converge.ps1 -Url http://localhost:3000 -Strict')
     console.log('')
     console.log('Per-task validation:')
-    console.log('  pwsh run-converge.ps1 -TaskId T-001')
+    console.log('  pwsh lib/bundle/run-converge.ps1 -TaskId T-001')
     console.log('')
     console.log('Claude Code:')
     console.log('  claude "/sdd-converge"')

package/lib/bundle/.claude/commands/sdd-bmad.md

@@ -1,18 +1,18 @@
 ---
-# SDD BMAD — Brainstorm, Multi-Agent, Define (Interactive)
+# SDD BMAD — Brainstorm, Multi-Agent, Define (Interactive + Batch)
 ---
 tool: Bash
 when: always
-description: Phase 0 — Interactive brainstorm. Asks 9 discovery questions (Problem/Architect/UX tiers), applies problem-first inversion, generates confidence-scored brief. Outputs to sdd/brief.md. Args: "<feature description>"
+description: Phase 0 — Interactive brainstorm with batch mode. Asks 9 discovery questions (Problem/Architect/UX tiers), applies problem-first inversion, generates confidence-scored brief. Outputs to sdd/brief.md. Args: "<feature>" or "--batch <file.json>" or "--answers '{...}'"
 ---
 # ============================================================
-# SDD BMAD Interactive Mode
+# SDD BMAD Interactive + Batch Mode
 # ============================================================
 # Phase 0: Brainstorm, Multi-Agent, Define
 # Asks 9 discovery questions (Tier 1 + 2 + 3)
 # Applies problem-first inversion
-# Spawns 3 parallel agents (PM / Architect / UX)
 # Produces confidence-scored brief
+# Supports batch mode: --batch file.json or --answers '{...}'
 # ============================================================
 
 $ErrorActionPreference = 'Stop'
@@ -27,16 +27,80 @@ function Sanitize-UserInput {
 
 # --- Parse arguments ---
 $rawInput = $args -join ' '
-if (-not $rawInput) {
+$batchMode = $false
+$batchFile = $null
+$batchAnswers = $null
+$answers = @{}
+
+# Check for batch mode
+if ($args -contains "--batch") {
+    $batchMode = $true
+    $batchIdx = [array]::IndexOf($args, "--batch")
+    if ($batchIdx -ge 0 -and $batchIdx + 1 -lt $args.Count) {
+        $batchFile = $args[$batchIdx + 1]
+    }
+} elseif ($args -contains "--answers") {
+    $batchMode = $true
+    $batchIdx = [array]::IndexOf($args, "--answers")
+    if ($batchIdx -ge 0 -and $batchIdx + 1 -lt $args.Count) {
+        $batchAnswers = $args[$batchIdx + 1]
+    }
+}
+
+# Extract feature description (first positional arg, or --input value)
+$featureDesc = ($args | Where-Object { $_ -notmatch '^--' } | Select-Object -First 1)
+
+if (-not $featureDesc) {
     Write-Host "Usage: /sdd-bmad <feature description>"
-    Write-Host "Example: /sdd-bmad `"landing page for my SaaS product`""
+    Write-Host "       /sdd-bmad --batch <answers.json>"
+    Write-Host "       /sdd-bmad --answers '`{`"q1`":`"answer`",...`}`'"
+    Write-Host ""
+    Write-Host "Example interactive: /sdd-bmad `"landing page for my SaaS product`""
+    Write-Host "Example batch:      /sdd-bmad --batch answers.json"
     exit 1
 }
 
-$sanitizedInput = Sanitize-UserInput -Input $rawInput
-Write-Host ""
-Write-Host "=== BMAD Interactive Session ===" -ForegroundColor Cyan
-Write-Host "Input sanitized. Prompt injection protection active." -ForegroundColor Gray
+$sanitizedInput = Sanitize-UserInput -Input $featureDesc
+
+if ($batchMode) {
+    Write-Host ""
+    Write-Host "=== BMAD Batch Mode ===" -ForegroundColor Cyan
+    
+    # Load answers from file or inline JSON
+    if ($batchFile) {
+        if (Test-Path $batchFile) {
+            try {
+                $jsonContent = Get-Content $batchFile -Raw
+                $batchData = $jsonContent | ConvertFrom-Json
+                foreach ($prop in $batchData.PSObject.Properties) {
+                    $answers[$prop.Name] = Sanitize-UserInput -Input $prop.Value
+                }
+                Write-Host "Loaded $($answers.Count) answers from: $batchFile" -ForegroundColor Green
+            } catch {
+                Write-Host "[ERROR] Failed to parse JSON file: $_" -ForegroundColor Red
+                exit 1
+            }
+        } else {
+            Write-Host "[ERROR] Batch file not found: $batchFile" -ForegroundColor Red
+            exit 1
+        }
+    } elseif ($batchAnswers) {
+        try {
+            $batchData = $batchAnswers | ConvertFrom-Json
+            foreach ($prop in $batchData.PSObject.Properties) {
+                $answers[$prop.Name] = Sanitize-UserInput -Input $prop.Value
+            }
+            Write-Host "Loaded $($answers.Count) answers from inline JSON" -ForegroundColor Green
+        } catch {
+            Write-Host "[ERROR] Failed to parse inline JSON: $_" -ForegroundColor Red
+            exit 1
+        }
+    }
+} else {
+    Write-Host ""
+    Write-Host "=== BMAD Interactive Session ===" -ForegroundColor Cyan
+    Write-Host "Input sanitized. Prompt injection protection active." -ForegroundColor Gray
+}
 
 # --- Date helpers ---
 $date = Get-Date -Format 'yyyy-MM-dd'
@@ -106,26 +170,28 @@ $questions = @(
     @{ id="q9"; tier=3; tierName="UX & Polish"; q="What could go wrong that we need to handle gracefully?"; hint="Network failure, empty data, permission denied, slow loading" }
 )
 
-# Answers hash
-$answers = @{}
-
-foreach ($q in $questions) {
-    # Show tier header on first question of each tier
-    if ($q.id -eq "q1") { Write-Host "=== Tier 1: Problem Definition ===" -ForegroundColor Cyan }
-    if ($q.id -eq "q4") { Write-Host ""; Write-Host "=== Tier 2: Technical & Feasibility ===" -ForegroundColor Cyan }
-    if ($q.id -eq "q7") { Write-Host ""; Write-Host "=== Tier 3: UX & Polish ===" -ForegroundColor Cyan }
+# Skip interactive questions in batch mode (answers already loaded)
+if (-not $batchMode) {
+    foreach ($q in $questions) {
+        # Show tier header on first question of each tier
+        if ($q.id -eq "q1") { Write-Host "=== Tier 1: Problem Definition ===" -ForegroundColor Cyan }
+        if ($q.id -eq "q4") { Write-Host ""; Write-Host "=== Tier 2: Technical & Feasibility ===" -ForegroundColor Cyan }
+        if ($q.id -eq "q7") { Write-Host ""; Write-Host "=== Tier 3: UX & Polish ===" -ForegroundColor Cyan }
 
-    Write-Host ""
-    Write-Host "[$($q.id)] $($q.q)" -ForegroundColor White
-    Write-Host "Hint: $($q.hint)" -ForegroundColor Gray
+        Write-Host ""
+        Write-Host "[$($q.id)] $($q.q)" -ForegroundColor White
+        Write-Host "Hint: $($q.hint)" -ForegroundColor Gray
 
-    $answer = Read-Host "Your answer"
-    $answer = Sanitize-UserInput -Input $answer
-    $answers[$q.id] = $answer
+        $answer = Read-Host "Your answer"
+        $answer = Sanitize-UserInput -Input $answer
+        $answers[$q.id] = $answer
 
-    if (-not $answer) {
-        Write-Host "(skipped — answer recorded as empty)" -ForegroundColor DarkGray
+        if (-not $answer) {
+            Write-Host "(skipped — answer recorded as empty)" -ForegroundColor DarkGray
+        }
     }
+} else {
+    Write-Host "Using batch mode — skipping interactive questions." -ForegroundColor Gray
 }
 
 # ============================================================

package/lib/bundle/.claude/commands/sdd-converge.md

@@ -2,39 +2,158 @@
 ---
 tool: Bash
 when: always
-description: Phase 5 — Validate implementation matches SPEC.md. Self-correcting converge loop. Args: [--task <task-id>] or full project. Checks clause IDs, exact text, hex colors, ACs, dev server health.
+args: --task <task-id>
+description: Phase 5 — Validate implementation matches SPEC.md. Self-correcting converge loop. Args: [--task <task-id>] or full project. Checks clause IDs, exact text, hex colors, ACs, dev server health. Output to sdd/converge/.
 ---
-$missing = @()
+$ErrorActionPreference = 'Continue'
 
-if (!(Test-Path "SPEC.md")) {
-    Write-Host "ERROR: SPEC.md not found" -ForegroundColor Red
-    $missing += "SPEC.md"
+# Parse task argument
+$taskId = $null
+if ($argsRaw -match '-task["\s]+([T-t]-\d+)') {
+    $taskId = $Matches[1].ToUpper()
 }
 
-# Find task directory
-$taskDirs = Get-ChildItem -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
-if ($taskDirs) {
-    $taskDir = ($taskDirs | Select-Object -First 1).Name
-    if (!(Test-Path "$taskDir/MASTER-TASKS.md")) {
-        Write-Host "ERROR: $taskDir/MASTER-TASKS.md not found" -ForegroundColor Red
-        $missing += "$taskDir/MASTER-TASKS.md"
-    }
-} else {
-    Write-Host "ERROR: No task directory found (task-*/)" -ForegroundColor Red
-    $missing += "task-*/MASTER-TASKS.md"
+# Ensure converge directory exists
+$convergeDir = "sdd/converge"
+if (-not (Test-Path $convergeDir)) {
+    New-Item -ItemType Directory -Path $convergeDir -Force | Out-Null
 }
 
-if ($missing.Count -gt 0) {
-    Write-Host "Missing artifacts: $($missing -join ', ')" -ForegroundColor Red
-    Write-Host "Run /sdd-tasks first."
-    exit 1
+# Run converge validation
+Write-Host "=== SDD Converge Validation ===" -ForegroundColor Cyan
+
+if ($taskId) {
+    Write-Host "Running per-task converge for: $taskId" -ForegroundColor Cyan
+    pwsh run-converge.ps1 -TaskId $taskId
+} else {
+    Write-Host "Running full project converge..." -ForegroundColor Cyan
+    pwsh run-converge.ps1
 }
 
-Write-Host "All required artifacts verified." -ForegroundColor Green
-Write-Host "Running converge validation..."
-Write-Host "Run: pwsh run-converge.ps1 -Url 'http://localhost:3000' -Strict"
+Write-Host ""
+Write-Host "Converge reports saved to: $convergeDir/" -ForegroundColor Green
+
+## SDD Converge — Phase 5 Validation
+
+**Purpose:** Verify implementation matches SPEC.md. Run per-task or full project.
+
+**Output Location:** `sdd/converge/` (v1.1.0+)
+
+### Usage
+
+```bash
+# Full project converge (after all tasks)
+claude "/sdd-converge"
+
+# Per-task converge (after each task)
+pwsh run-converge.ps1 -TaskId "T-001"
+
+# Per-task with strict mode
+pwsh run-converge.ps1 -TaskId "T-002" -Strict
+```
+
+---
+
+## Per-Task Converge (Recommended)
+
+Run after each task to catch issues early:
+
+```
+pwsh run-converge.ps1 -TaskId "T-001"
+pwsh run-converge.ps1 -TaskId "T-002" -Strict
+```
+
+### What it validates:
+- ✅ All spec clause IDs match implementation
+- ✅ Required text appears verbatim
+- ✅ Colors match hex values
+- ✅ Acceptance criteria met
+- ✅ Edge cases handled
+
+### Output:
+- `sdd/converge/task-T-XXX/report.md` — Per-task validation report
 
 ---
 
-# Run converge automation: pwsh run-converge.ps1
-# Validates: SPEC.md + task-*/MASTER-TASKS.md
+## Full Project Converge
+
+Run after all tasks complete:
+
+```
+pwsh run-converge.ps1 -Url 'http://localhost:3000' -Strict
+```
+
+### What it validates:
+- ✅ All artifacts exist (sdd/SPEC.md, sdd/tasks/)
+- ✅ SPEC.md structure complete
+- ✅ Dev server health check
+- ✅ All tasks implemented
+- ✅ Lighthouse/axe-core (if URL provided)
+
+### Output:
+- `sdd/converge/validation.md` — Full project validation
+
+---
+
+## Phase Status
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║  SDD Converge — Phase 5                                   ║
+╠══════════════════════════════════════════════════════════════╣
+║  Per-Task:  Run after each task     → sdd/converge/task-T-XXX║
+║  Full:      Run after all tasks     → sdd/converge/validation ║
+║                                                              ║
+║  Flow:      Task → Fix → Re-converge → Next Task           ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## Agent Instructions
+
+After implementing a task:
+
+1. **Generate converge report:**
+   ```bash
+   pwsh run-converge.ps1 -TaskId "T-XXX"
+   ```
+
+2. **Review report** for any failures
+
+3. **If PASS:** Update task status in MASTER-TASKS.md → proceed to next task
+
+4. **If FAIL:** Fix issues → re-run converge until PASS
+
+5. **If SPEC issue:** Update SPEC.md → re-generate affected tasks
+
+---
+
+## Validation Checks
+
+### Per-Task (run-converge.ps1 -TaskId)
+| Check | Description |
+|-------|-------------|
+| Clause IDs | All `[SC-xxx]` from SPEC.md found in implementation |
+| Text Match | Required text appears verbatim |
+| Color Match | Hex values match exactly |
+| AC Check | Acceptance criteria `[AC-xxx]` verified |
+
+### Full Project (run-converge.ps1)
+| Check | Description |
+|-------|-------------|
+| Artifacts | SPEC.md, TASKS.md, task files exist |
+| Structure | Required sections in SPEC.md |
+| URL Safety | No SSRF vulnerabilities |
+| Dev Health | Target server reachable |
+| Live Tests | Lighthouse, axe-core (if URL provided) |
+
+---
+
+## Loop-Back Rules
+
+| Failure Type | Re-enter Phase | Action |
+|-------------|---------------|--------|
+| Clause mismatch | Phase 4 | Fix implementation |
+| SPEC unclear | Phase 2 | Update SPEC.md |
+| Intent wrong | Phase 1 | Regenerate BMAD brief |

package/lib/bundle/.claude/commands/sdd-tasks.md

@@ -10,7 +10,7 @@ $ErrorActionPreference = "Stop"
 # Parse arguments
 $args = $argsRaw.Trim()
 
-# Output path resolution
+# SDD Path Resolution
 $SDD_OUTPUT_BASE = "sdd"
 $SDD_TASKS_DIR = "$SDD_OUTPUT_BASE/tasks"
 
@@ -18,11 +18,9 @@ $SDD_TASKS_DIR = "$SDD_OUTPUT_BASE/tasks"
 if (Test-Path ".sdd/config.json") {
     try {
         $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
-        if ($config.output -and $config.output.baseDir) {
-            $SDD_OUTPUT_BASE = $config.output.baseDir
-        }
-        if ($config.output -and $config.output.tasksDir) {
-            $SDD_TASKS_DIR = $config.output.tasksDir
+        if ($config.output) {
+            if ($config.output.baseDir) { $SDD_OUTPUT_BASE = $config.output.baseDir }
+            if ($config.output.tasksDir) { $SDD_TASKS_DIR = $config.output.tasksDir }
         }
     } catch {}
 }
@@ -53,6 +51,16 @@ if (Test-Path $specPath) {
     $activeSpec = $legacySpecPath
 }
 
+# Gate 2: Template must exist
+$templatePath = "templates/task-detail.template.md"
+if (-not (Test-Path $templatePath)) {
+    Write-Host "[ERROR] Template not found: $templatePath" -ForegroundColor Red
+    Write-Host "Run /sdd-init first" -ForegroundColor Yellow
+    exit 1
+}
+$templateContent = Get-Content $templatePath -Raw -Encoding UTF8
+Write-Host "[OK] Template: $templatePath" -ForegroundColor Green
+
 Write-Host ""
 Write-Host "=== SDD Tasks Generator - Phase 3 ===" -ForegroundColor Cyan
 
@@ -187,80 +195,42 @@ $($testCategories -join ', ')
 ## Notes
 
 Generated from: SPEC.md
-Auto-generated by SDD Pipeline v1.2.2
+Auto-generated by SDD Pipeline v1.3.0
 "@
 
 Set-Content -Path "$taskDir/MASTER-TASKS.md" -Value $masterContent -Encoding UTF8
 Write-Host "  [CREATED] MASTER-TASKS.md" -ForegroundColor Gray
 
-# Generate individual task files with SPEC details
-$taskNum = 1
+# Generate individual task files using template
 foreach ($task in $tasks) {
     $safeName = $task.Name -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
     $filename = "$($task.Id)-$safeName.md"
 
-    # Extract feature content if available
-    $featureContent = ""
+    # Determine spec sections based on task type
     $specSection = "4.1"
-    $extractedClauses = @()
-
     if ($task.Name -eq "Project Setup") {
-        # Setup task - extract colors and dimensions from SPEC
-        $colors = @()
-        if ($specContent -match '(?s)## 3\.2.*?Colors(.+?)(?=##|\Z)') {
-            $colorMatches = [regex]::Matches($Matches[1], '`([^`]+)`')
-            foreach ($m in $colorMatches) {
-                $colors += $m.Groups[1].Value
-            }
-        }
-        $featureContent = "## Files to Create`n`n"
-        $featureContent += "- `index.html` — Main calculator page`n"
-        $featureContent += "- `styles.css` — Calculator styling`n"
-        $featureContent += "- `app.js` — Calculator logic`n`n"
-        $featureContent += "## Implementation Steps`n`n"
-        $featureContent += "1. Create `index.html` with calculator structure`n"
-        $featureContent += "2. Create `styles.css` with colors from SPEC §3.2`n"
-        $featureContent += "3. Create `app.js` with calculator state`n"
         $specSection = "3.1, 3.2, 3.3, 6"
-    } else {
-        # Feature tasks - extract from feature content
-        $featureContent = "## Files to Modify/Create`n`n"
-        $featureContent += "- `app.js` — Add calculator logic`n`n"
-        $featureContent += "## Implementation Steps`n`n"
-        $featureContent += "1. Read SPEC.md §4.1 for feature details`n"
-        $featureContent += "2. Implement the feature logic`n"
-        $featureContent += "3. Test with manual verification`n"
     }
 
+    # Format depends_on
     $dependsStr = ""
     if ($task.DependsOn.Count -gt 0 -and $task.DependsOn[0]) {
-        $dependsStr = '"' + ($task.DependsOn -join '", "') + '"'
+        $dependsStr = "`"" + ($task.DependsOn -join "`", `"") + "`""
     }
 
-    $taskContent = @"
----
-name: $filename
-description: "$($task.Name)"
-phase: $($task.Phase)
-estimate: 1h
-spec_sections: ["$specSection"]
-depends_on: [$dependsStr]
----
-
-# $($task.Id): $($task.Name)
-
-$featureContent
-
-## Verification
-
-- [ ] Implementation matches SPEC requirements
-- [ ] No console errors
-- [ ] Manual test passes
-"@
+    # Apply template substitutions
+    $taskContent = $templateContent
+    $taskContent = $taskContent -replace '\{\{TASK_ID\}\}', $task.Id
+    $taskContent = $taskContent -replace '\{\{TASK_NAME\}\}', $task.Name
+    $taskContent = $taskContent -replace '\{\{FILENAME\}\}', $filename
+    $taskContent = $taskContent -replace '\{\{DESCRIPTION\}\}', $task.Name
+    $taskContent = $taskContent -replace '\{\{PHASE\}\}', $task.Phase
+    $taskContent = $taskContent -replace '\{\{ESTIMATE\}\}', "1h"
+    $taskContent = $taskContent -replace '\{\{SPEC_SECTIONS\}\}', $specSection
+    $taskContent = $taskContent -replace '\{\{DEPENDS_ON\}\}', $dependsStr
 
     Set-Content -Path "$taskDir/$filename" -Value $taskContent -Encoding UTF8
     Write-Host "  [CREATED] $filename" -ForegroundColor Gray
-    $taskNum++
 }
 
 # Update config

package/lib/bundle/.claude/commands/sdd.md

@@ -285,7 +285,7 @@ switch ($cmd) {
         Write-Host "[OK] All artifacts present." -ForegroundColor Green
         Write-Host "Running converge validation..."
         Write-Host ""
-        Write-Host "Run: pwsh run-converge.ps1 -Url 'http://localhost:3000' -Strict"
+        Write-Host "Run: pwsh lib/bundle/run-converge.ps1 -Url 'http://localhost:3000' -Strict"
     }
 
     "help" {

package/lib/bundle/.github/workflows/converge.yml

@@ -52,7 +52,7 @@ jobs:
 
       - name: Run Converge
         run: |
-          pwsh -File run-converge.ps1 -Url "http://localhost:3000" -Strict
+          pwsh -File lib/bundle/run-converge.ps1 -Url "http://localhost:3000" -Strict
 
       - name: Upload reports
         if: always()

package/lib/bundle/bin/sdd.cjs

@@ -143,10 +143,10 @@ switch (cmd) {
     console.log('=== SDD Converge Validation ===')
     console.log('')
     console.log('Full validation (requires dev server):')
-    console.log('  pwsh run-converge.ps1 -Url http://localhost:3000 -Strict')
+    console.log('  pwsh lib/bundle/run-converge.ps1 -Url http://localhost:3000 -Strict')
     console.log('')
     console.log('Per-task validation:')
-    console.log('  pwsh run-converge.ps1 -TaskId T-001')
+    console.log('  pwsh lib/bundle/run-converge.ps1 -TaskId T-001')
     console.log('')
     console.log('Claude Code:')
     console.log('  claude "/sdd-converge"')

package/lib/bundle/commands/sdd-status.ps1

@@ -8,6 +8,19 @@ if (!(Test-Path $configPath)) {
 
 $config = Get-Content $configPath | ConvertFrom-Json
 
+# SDD Path Resolution - read from config
+$SDD_OUTPUT_BASE = "sdd"
+$SDD_SPEC_FILE = "sdd/SPEC.md"
+$SDD_BRIEF_FILE = "sdd/brief.md"
+$SDD_TASKS_DIR = "sdd/tasks"
+
+if ($config.output) {
+    if ($config.output.baseDir) { $SDD_OUTPUT_BASE = $config.output.baseDir }
+    if ($config.output.spec) { $SDD_SPEC_FILE = $config.output.spec }
+    if ($config.output.brief) { $SDD_BRIEF_FILE = $config.output.brief }
+    if ($config.output.tasksDir) { $SDD_TASKS_DIR = $config.output.tasksDir }
+}
+
 Write-Host "=== SDD Pipeline Status ===" -ForegroundColor Cyan
 Write-Host "Project: $($config.project.name)"
 Write-Host "Phase: $($config.phases.current)"
@@ -34,34 +47,58 @@ foreach ($p in $phases) {
 if ($Verify) {
     Write-Host ""
     Write-Host "=== Verification ===" -ForegroundColor Cyan
-    $artifacts = @(
-        @{ File = "SPEC.md"; Phase = "phase2"; Required = $true },
-        @{ File = "BMAD-brief.md"; Phase = "phase0"; Required = $false }
-    )
 
-    foreach ($a in $artifacts) {
-        $exists = Test-Path $a.File
-        $configStatus = if ($config.phases.($a.Phase).status) { $config.phases.($a.Phase).status } else { "unknown" }
-        if ($exists -and $configStatus -eq "completed") {
-            Write-Host "[V] $a.File (in sync)" -ForegroundColor Green
-        } elseif ($exists -and $configStatus -ne "completed") {
-            Write-Host "[!] $a.File (exists but config shows $configStatus)" -ForegroundColor Yellow
-        } elseif (-not $exists -and $a.Required) {
-            Write-Host "[X] $a.File (missing, required)" -ForegroundColor Red
-        } else {
-            Write-Host "[ ] $a.File (optional, not present)" -ForegroundColor Gray
+    # Check brief (v1.1.0 location + legacy fallback)
+    $briefExists = (Test-Path $SDD_BRIEF_FILE) -or (Test-Path "BMAD-brief.md")
+    $briefStatus = $config.phases.phase0.status
+    if ($briefExists -and $briefStatus -eq "completed") {
+        Write-Host "[V] brief.md (in sync)" -ForegroundColor Green
+    } elseif ($briefExists -and $briefStatus -ne "completed") {
+        Write-Host "[!] brief.md (exists but config shows $briefStatus)" -ForegroundColor Yellow
+    } elseif (-not $briefExists) {
+        Write-Host "[ ] brief.md (not created yet)" -ForegroundColor Gray
+    }
+
+    # Check SPEC (v1.1.0 location + legacy fallback)
+    $specExists = (Test-Path $SDD_SPEC_FILE) -or (Test-Path "SPEC.md")
+    $specStatus = $config.phases.phase2.status
+    if ($specExists -and $specStatus -eq "completed") {
+        Write-Host "[V] SPEC.md (in sync)" -ForegroundColor Green
+    } elseif ($specExists -and $specStatus -ne "completed") {
+        Write-Host "[!] SPEC.md (exists but config shows $specStatus)" -ForegroundColor Yellow
+    } elseif (-not $specExists) {
+        Write-Host "[ ] SPEC.md (not created yet)" -ForegroundColor Gray
+    }
+
+    # Check task directory (v1.1.0 location + legacy fallback)
+    $taskDir = $null
+    $taskDirSource = ""
+
+    # Check new location first
+    if (Test-Path $SDD_TASKS_DIR) {
+        $taskDirs = Get-ChildItem -Path $SDD_TASKS_DIR -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
+        if ($taskDirs) {
+            $taskDir = Join-Path $SDD_TASKS_DIR ($taskDirs | Select-Object -First 1).Name
+            $taskDirSource = "v1.1.0"
+        }
+    }
+
+    # Fallback to legacy location
+    if (-not $taskDir) {
+        $legacyDirs = Get-ChildItem -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
+        if ($legacyDirs) {
+            $taskDir = ($legacyDirs | Select-Object -First 1).FullName
+            $taskDirSource = "legacy"
         }
     }
 
-    # Check task directory
-    $taskDirs = Get-ChildItem -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
-    if ($taskDirs) {
-        $taskDir = ($taskDirs | Select-Object -First 1).Name
+    if ($taskDir) {
         $masterPath = Join-Path $taskDir "MASTER-TASKS.md"
         $taskFiles = Get-ChildItem -Path $taskDir -Filter "T-*.md" -ErrorAction SilentlyContinue
         $taskFiles = $taskFiles | Where-Object { $_.Name -ne "MASTER-TASKS.md" }
         if ($masterPath) {
-            Write-Host "[V] $taskDir/ (found)" -ForegroundColor Green
+            $sourceNote = if ($taskDirSource -eq "legacy") { " (legacy)" } else { "" }
+            Write-Host "[V] $taskDir/$sourceNote (found)" -ForegroundColor Green
             Write-Host "    $($taskFiles.Count) task files" -ForegroundColor Gray
         } else {
             Write-Host "[X] $taskDir/MASTER-TASKS.md (missing)" -ForegroundColor Red
@@ -71,8 +108,7 @@ if ($Verify) {
     }
 
     # Check task progress
-    if ($taskDirs) {
-        $taskDir = ($taskDirs | Select-Object -First 1).Name
+    if ($taskDir) {
         $allTaskFiles = Get-ChildItem -Path $taskDir -Filter "T-*.md" -ErrorAction SilentlyContinue
         $allTaskFiles = $allTaskFiles | Where-Object { $_.Name -ne "MASTER-TASKS.md" }
         $total = $allTaskFiles.Count
@@ -90,4 +126,4 @@ if ($Verify) {
 
 Write-Host ""
 Write-Host "Next: Phase $($config.phases.current + 1)"
-Write-Host "Run /sdd-status --verify to check artifact sync."
+Write-Host "Run sdd status --verify to check artifact sync."

package/lib/bundle/commands/sdd-tasks.ps1

@@ -7,18 +7,53 @@ $ErrorActionPreference = 'Stop'
 Write-Host ""
 Write-Host "=== SDD Tasks Generator - Phase 3 ===" -ForegroundColor Cyan
 
+# SDD Path Resolution
+$SDD_OUTPUT_BASE = "sdd"
+$SDD_TASKS_DIR = "$SDD_OUTPUT_BASE/tasks"
+
+# Check config for custom output directory
+if (Test-Path ".sdd/config.json") {
+    try {
+        $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
+        if ($config.output) {
+            if ($config.output.baseDir) { $SDD_OUTPUT_BASE = $config.output.baseDir }
+            if ($config.output.tasksDir) { $SDD_TASKS_DIR = $config.output.tasksDir }
+        }
+    } catch {}
+}
+
 # Check SPEC
-$specPath = "sdd/SPEC.md"
-if (-not (Test-Path $specPath)) {
+$specPath = "$SDD_OUTPUT_BASE/SPEC.md"
+$legacySpecPath = "SPEC.md"
+
+if (-not (Test-Path $specPath) -and -not (Test-Path $legacySpecPath)) {
     Write-Host "[ERROR] SPEC.md not found at $specPath" -ForegroundColor Red
     Write-Host "Run: sdd bmad [feature]" -ForegroundColor Yellow
     Write-Host "Then: claude `/sdd-spec`" -ForegroundColor Yellow
     exit 1
 }
-Write-Host "[OK] Found: $specPath" -ForegroundColor Green
+
+# Use new path if exists, else use legacy
+if (Test-Path $specPath) {
+    Write-Host "[OK] Found: $specPath" -ForegroundColor Green
+    $activeSpec = $specPath
+} else {
+    Write-Host "[OK] Found: $legacySpecPath (legacy location)" -ForegroundColor Green
+    $activeSpec = $legacySpecPath
+}
+
+# Read template
+$templatePath = "templates/task-detail.template.md"
+if (-not (Test-Path $templatePath)) {
+    Write-Host "[ERROR] Template not found: $templatePath" -ForegroundColor Red
+    Write-Host "Run: /sdd-init first" -ForegroundColor Yellow
+    exit 1
+}
+$templateContent = Get-Content $templatePath -Raw -Encoding UTF8
+Write-Host "[OK] Template: $templatePath" -ForegroundColor Green
 
 # Parse SPEC
-$specContent = Get-Content $specPath -Raw -Encoding UTF8
+$specContent = Get-Content $activeSpec -Raw -Encoding UTF8
 
 # Extract project name
 $projectName = "Project"
@@ -53,9 +88,20 @@ Write-Host "[OK] Test categories: $($testCategories -join ', ')" -ForegroundColo
 # Create task directory
 $timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
 $safeName = $projectName -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
-$taskDir = "sdd/tasks/task-$timestamp-$safeName"
-New-Item -ItemType Directory -Path $taskDir -Force | Out-Null
-Write-Host "[OK] Created: $taskDir" -ForegroundColor Green
+$taskDir = "$SDD_TASKS_DIR/task-$timestamp-$safeName"
+
+# Check for existing task directories for this project
+$existingDirs = Get-ChildItem -Path $SDD_TASKS_DIR -Filter "task-*-${safeName}" -Directory -ErrorAction SilentlyContinue
+if ($existingDirs) {
+    $existingDir = $existingDirs[0].FullName
+    Write-Host ""
+    Write-Host "[WARN] Task directory already exists: $existingDir" -ForegroundColor Yellow
+    Write-Host "[INFO] Using existing directory" -ForegroundColor Cyan
+    $taskDir = $existingDir
+} else {
+    New-Item -ItemType Directory -Path $taskDir -Force | Out-Null
+    Write-Host "[OK] Created: $taskDir" -ForegroundColor Green
+}
 
 # Build task list
 $tasks = @()
@@ -89,49 +135,45 @@ $masterContent += "| ID | Name | Estimate | Status |`n|----|------|----------|--
 foreach ($t in $tasks) {
     $masterContent += "| $($t.Id) | $($t.Name) | 1h | [ ] |`n"
 }
-$masterContent += "`n## Progress`n`n- Completed: 0 / $($tasks.Count)`n- Pending: $($tasks.Count)`n`n"
+$masterContent += "`n## Progress`n`n- Completed: 0 / $($tasks.Count)`n- In Progress: 0`n- Pending: $($tasks.Count)`n`n"
 $masterContent += "## Test Categories`n`n$($testCategories -join ', ')`n`n"
 $masterContent += "## Notes`n`nGenerated from: SPEC.md`nAuto-generated by SDD Pipeline v1.2.2`n"
 
 Set-Content -Path "$taskDir/MASTER-TASKS.md" -Value $masterContent -Encoding UTF8
 Write-Host "  [CREATED] MASTER-TASKS.md" -ForegroundColor Gray
 
-# Generate task files
+# Generate task files using template
 foreach ($t in $tasks) {
     $safeName = $t.Name -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
     $filename = "$($t.Id)-$safeName.md"
-    $dependsOn = if ($t.DependsOn) { "@($($t.DependsOn))" } else { "@()" }
-
-    $taskContent = @"
----
-name: $filename
-description: "$($t.Name)"
-phase: $($t.Phase)
-estimate: 1h
-spec_sections: ["4.1"]
-depends_on: [$dependsOn]
----
-
-# $($t.Id): $($t.Name)
-
-## Files to Modify/Create
-- [List files]
-
-## Implementation Steps
-1. [Step 1]
-2. [Step 2]
-3. [Step 3]
-
-## Verification
-- [ ] Check 1
-- [ ] Check 2
-- [ ] Check 3
-"@
+    $dependsOn = if ($t.DependsOn) { "`"$($t.DependsOn)`"" } else { "" }
+
+    # Apply template substitutions
+    $taskContent = $templateContent
+    $taskContent = $taskContent -replace '\{\{TASK_ID\}\}', $t.Id
+    $taskContent = $taskContent -replace '\{\{TASK_NAME\}\}', $t.Name
+    $taskContent = $taskContent -replace '\{\{FILENAME\}\}', $filename
+    $taskContent = $taskContent -replace '\{\{DESCRIPTION\}\}', $t.Name
+    $taskContent = $taskContent -replace '\{\{PHASE\}\}', $t.Phase
+    $taskContent = $taskContent -replace '\{\{ESTIMATE\}\}', "1h"
+    $taskContent = $taskContent -replace '\{\{SPEC_SECTIONS\}\}', "4.1"
+    $taskContent = $taskContent -replace '\{\{DEPENDS_ON\}\}', $dependsOn
 
     Set-Content -Path "$taskDir/$filename" -Value $taskContent -Encoding UTF8
     Write-Host "  [CREATED] $filename" -ForegroundColor Gray
 }
 
+# Update config
+if (Test-Path ".sdd/config.json") {
+    $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
+    $config.phases.current = 3
+    $config.phases.phase2.status = "completed"
+    $config.phases.phase2.completedAt = (Get-Date -Format "yyyy-MM-dd")
+    $config.phases.phase3.status = "in-progress"
+    $config | ConvertTo-Json -Depth 10 | Set-Content ".sdd/config.json"
+    Write-Host "[OK] Config updated" -ForegroundColor Green
+}
+
 Write-Host ""
 Write-Host "[OK] Tasks generated: $($tasks.Count) tasks" -ForegroundColor Green
 Write-Host ""

package/lib/bundle/lib/init.js

@@ -30,7 +30,7 @@ const FILES = [
   'templates/README.md',
   'converge/validation.md',
   'CLAUDE.md',
-  'run-converge.ps1',
+  'lib/bundle/run-converge.ps1',
 ]
 
 const DIRS = ['.sdd', 'templates', 'converge', 'commands', 'extensions', 'sdd', 'skills']

package/lib/bundle/skills/sdd-cook/references/subagent-patterns.md

@@ -4,6 +4,23 @@ Standard patterns for spawning subagents during SDD task execution.
 
 **IMPORTANT:** All subagent names listed here are verified to exist in the Claude Code environment.
 
+## IMPORTANT: Claude Code Commands vs CLI Commands
+
+**When running SDD pipeline commands in subagents, use Claude Code commands:**
+```bash
+# CORRECT
+claude "/sdd-bmad simple calculator app..."
+claude "/sdd-spec"
+claude "/sdd-tasks"
+claude "/sdd-cook --task T-001"
+
+# WRONG
+sdd bmad "simple calculator app..."
+sdd spec
+sdd tasks
+sdd cook --task T-001
+```
+
 ## Task Tool Pattern
 
 ```

package/lib/bundle/skills/sdd-cook/references/subagent-prompts.md

@@ -2,6 +2,28 @@
 
 Standard templates for spawning subagents during SDD task execution.
 
+## IMPORTANT: Claude Code Commands vs CLI Commands
+
+**When running SDD pipeline commands in subagents, use Claude Code commands:**
+```bash
+# CORRECT - Interactive mode with higher confidence
+claude "/sdd-bmad simple calculator app..."
+claude "/sdd-spec"
+claude "/sdd-tasks"
+claude "/sdd-cook --task T-001"
+
+# WRONG - Fast CLI mode with lower confidence
+sdd bmad "simple calculator app..."
+sdd spec
+sdd tasks
+sdd cook --task T-001
+```
+
+**Why:** Claude Code commands run in interactive mode, which:
+- Generates higher confidence briefs (50-100 vs 5-30)
+- Provides better prompts for SPEC generation
+- Enables the full 9-question BMAD interview
+
 ## Task Tool Pattern
 
 ```

package/lib/bundle/templates/task-detail.template.md

@@ -1,19 +1,26 @@
 <!--
-  Template: T-XXX-task-name.md v1.1.0
+  Template: T-XXX-task-name.md v1.2.0
   Spec-Driven Development — Phase 3 Task
   Generated by: /sdd-tasks
+  Updated: 2026-08-31 (Use template for generation)
 -->
 ---
-depends_on: []
+name: {{FILENAME}}
+description: "{{DESCRIPTION}}"
+phase: {{PHASE}}
+estimate: {{ESTIMATE}}
+status: pending
+spec_sections: [{{SPEC_SECTIONS}}]
 parallel_group: ""
-spec_sections: []
+depends_on: [{{DEPENDS_ON}}]
 ---
 
-# T-XXX: [Task Name]
+# {{TASK_ID}}: {{TASK_NAME}}
 
-**Phase:** [Phase from PLAN]
-**Estimate:** [X hours]
+**Phase:** {{PHASE}}
+**Estimate:** {{ESTIMATE}}
 **Status:** Pending
+**Converge Status:** ⏳ PENDING
 
 ## Description
 
@@ -29,12 +36,61 @@ spec_sections: []
 2. [Step 2]
 3. [Step 3]
 
-## Verification
+## Acceptance Criteria
 
-- [ ] [Specific check 1]
-- [ ] [Specific check 2]
+> **Agent:** Verify each criterion against SPEC.md before marking complete.
+
+| ID | Criterion | Spec Clause | Verified By | Status |
+|----|-----------|-------------|-------------|--------|
+| AC-001 | [Specific criterion] | [SC-xxx] | [Test/Check] | ⏳ PENDING |
+| AC-002 | [Specific criterion] | [SC-xxx] | [Test/Check] | ⏳ PENDING |
+
+## Spec Clauses
+
+> **Track exact spec text for automated validation.**
+
+| Clause ID | Spec Text | Location | Verified |
+|-----------|-----------|----------|----------|
+| [SC-xxx] | "[exact text from SPEC.md]" | [SPEC.md §X.X] | ⏳ |
+
+## Converge Report
+
+> **Fill after implementation — see converge/task-{{TASK_ID}}/report.md**
+
+```markdown
+## {{TASK_ID}} Converge Report
+
+**Task:** {{TASK_NAME}}
+**Date:** [YYYY-MM-DD]
+**Agent:** [Claude/User]
+**Status:** ✅ PASS | ❌ FAIL
+
+### Spec Adherence
+
+| Clause | Spec Says | Implementation Has | Match |
+|--------|-----------|-------------------|-------|
+| [SC-xxx] | "[text]" | "[found text]" | ✅/❌ |
+
+### Acceptance Criteria
+
+| Criterion | Status |
+|-----------|--------|
+| AC-001 | ✅/❌ |
+| AC-002 | ✅/❌ |
+
+### Issues Found (if any)
+
+- [Issue 1]
+- [Issue 2]
+
+### Next Steps
+
+- [If PASS: Proceed to next task]
+- [If FAIL: Fix issues, re-run converge]
+```
 
 ## References
 
 - SPEC.md Sections: [§X.X, §Y.Y — from spec_sections above]
 - MASTER-TASKS: `../MASTER-TASKS.md`
+- Converge: `../../converge/task-{{TASK_ID}}/report.md`

package/lib/init.js

@@ -30,7 +30,7 @@ const FILES = [
   'templates/README.md',
   'converge/validation.md',
   'CLAUDE.md',
-  'run-converge.ps1',
+  'lib/bundle/run-converge.ps1',
 ]
 
 const DIRS = ['.sdd', 'templates', 'converge', 'commands', 'extensions', 'sdd', 'skills']

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-pipeline",
-  "version": "1.2.8",
+  "version": "1.3.1",
   "description": "Spec-Driven Development pipeline for Claude Code CLI — transforms raw feature requests into validated, shipped code through a self-correcting converge loop",
   "type": "commonjs",
   "bin": {
@@ -8,7 +8,11 @@
   },
   "files": [
     "bin/",
-    "lib/",
+    "lib/bmad.js",
+    "lib/bmad/",
+    "lib/config.js",
+    "lib/init.js",
+    "lib/sanitize.js",
     "lib/bundle/"
   ],
   "engines": {
@@ -25,6 +29,8 @@
   ],
   "license": "MIT",
   "scripts": {
-    "test": "node test/run.js"
+    "test": "node test/run.js",
+    "sync": "pwsh scripts/sync-bundle.ps1",
+    "pack": "npm pack --dry-run"
   }
 }