@kennethsolomon/shipkit 3.10.0 → 3.10.2

package/README.md

@@ -55,8 +55,8 @@ That's it. `/sk:setup-claude` creates your project scaffolding: planning files,
 | I want to... | Run this | What happens |
 |--------------|----------|-------------|
 | **Not sure — let ShipKit decide** | `/sk:start` | Classifies your task, routes to optimal flow/mode/agents |
-| **Build a new feature** | `/sk:brainstorm` | Full workflow: plan → TDD → 6 quality gates → PR |
-| **Build hands-free** | `/sk:autopilot` | All 21 steps, auto-skip, auto-advance, auto-commit |
+| **Build a new feature** | `/sk:brainstorm` | Full workflow: plan → TDD → quality gates → PR |
+| **Build hands-free** | `/sk:autopilot` | All 8 steps, auto-skip, auto-advance, auto-commit |
 | **Full-stack feature (parallel)** | `/sk:team` | Parallel domain agents (backend + frontend + QA) |
 | **Make a small change** | `/sk:fast-track` | Skip planning, keep all quality gates |
 | **Fix a bug** | `/sk:debug` | Investigate → regression test → fix → gates → PR |
@@ -74,20 +74,13 @@ That's it. `/sk:setup-claude` creates your project scaffolding: planning files,
 | Step | Command | What it does | Phase |
 |------|---------|-------------|-------|
 | 1 | `/sk:brainstorm` | Explore requirements, propose approaches | Think |
-| 2 | `/sk:frontend-design` | *Optional* — UI mockup (`--pencil` for visual) | Think |
-| 3 | `/sk:api-design` | *Optional* — API contracts | Think |
-| 4 | `/sk:accessibility` | *Optional* — WCAG 2.1 AA audit on design | Think |
-| 5 | `/sk:write-plan` | Write decision-complete plan | Think |
-| 6 | `/sk:branch` | Create feature branch | Build |
-| 7 | `/sk:schema-migrate` | *Optional* — auto-skips if no migrations | Build |
-| 8 | `/sk:write-tests` | TDD red — write failing tests | Build |
-| 9 | `/sk:execute-plan` | TDD green — make tests pass | Build |
-| 10 | `/sk:smart-commit` | Conventional commit | Build |
-| 11 | `/sk:gates` | All 6 quality gates (parallel) | Verify |
-| 12 | `/sk:update-task` | Mark done | Ship |
-| 13 | `/sk:finish-feature` | Changelog + PR | Ship |
-| 14 | `/sk:features` | Sync feature specs | Ship |
-| 15 | `/sk:release` | *Optional* — version bump + tag | Ship |
+| 2 | `/sk:frontend-design` or `/sk:api-design` | *Optional* — UI mockup or API contracts (includes accessibility) | Think |
+| 3 | `/sk:write-plan` | Write decision-complete plan | Think |
+| 4 | `/sk:branch` | Create feature branch | Build |
+| 5 | `/sk:write-tests` + `/sk:execute-plan` | TDD: write failing tests, then implement | Build |
+| 6 | `/sk:smart-commit` | Conventional commit | Build |
+| 7 | `/sk:gates` | All 6 quality gates (parallel batches) | Verify |
+| 8 | `/sk:finish-feature` | Update task, changelog, PR, feature sync, release | Ship |
 
 ---
 
@@ -97,14 +90,11 @@ That's it. `/sk:setup-claude` creates your project scaffolding: planning files,
 
 | Step | Command | What it does | Phase |
 |------|---------|-------------|-------|
-| ~~1~~ | ~~/sk:brainstorm~~ | **Skipped** | — |
-| ~~2~~ | ~~/sk:write-plan~~ | **Skipped** | — |
-| ~~3~~ | ~~/sk:write-tests~~ | **Skipped** | — |
-| 4 | `/sk:branch` | Create feature branch | Build |
-| 5 | implement directly | No TDD — write code | Build |
-| 6 | `/sk:smart-commit` | Conventional commit | Build |
-| 7 | `/sk:gates` | All 6 quality gates (parallel) | Verify |
-| 8 | `/sk:finish-feature` | Changelog + PR | Ship |
+| 1 | `/sk:branch` | Create feature branch | Build |
+| 2 | implement directly | No TDD — write code | Build |
+| 3 | `/sk:smart-commit` | Conventional commit | Build |
+| 4 | `/sk:gates` | All quality gates (parallel batches) | Verify |
+| 5 | `/sk:finish-feature` | Changelog + PR | Ship |
 
 Guard rails: warns if diff > 300 lines or > 5 new files.
 
@@ -116,15 +106,13 @@ Guard rails: warns if diff > 300 lines or > 5 new files.
 
 | Step | Command | What it does | Phase |
 |------|---------|-------------|-------|
-| ~~1~~ | ~~/sk:brainstorm~~ | **Skipped** | — |
-| ~~2~~ | ~~/sk:write-plan~~ | **Skipped** | — |
-| 3 | `/sk:debug` | Reproduce, isolate, hypothesize, verify | Think |
-| 4 | `/sk:branch` | Create fix branch | Build |
-| 5 | `/sk:write-tests` | Regression test that reproduces the bug | Build |
-| 6 | implement the fix | Make regression test pass | Build |
-| 7 | `/sk:smart-commit` | Commit fix + test | Build |
-| 8 | `/sk:gates` | All 6 quality gates (parallel) | Verify |
-| 9 | `/sk:finish-feature` | Changelog + PR | Ship |
+| 1 | `/sk:debug` | Reproduce, isolate, hypothesize, verify | Think |
+| 2 | `/sk:branch` | Create fix branch | Build |
+| 3 | `/sk:write-tests` | Regression test that reproduces the bug | Build |
+| 4 | implement the fix | Make regression test pass | Build |
+| 5 | `/sk:smart-commit` | Commit fix + test | Build |
+| 6 | `/sk:gates` | All quality gates (parallel batches) | Verify |
+| 7 | `/sk:finish-feature` | Changelog + PR | Ship |
 
 ---
 
@@ -134,16 +122,12 @@ Guard rails: warns if diff > 300 lines or > 5 new files.
 
 | Step | Command | What it does | Phase |
 |------|---------|-------------|-------|
-| ~~1~~ | ~~/sk:brainstorm~~ | **Skipped** | — |
-| ~~2~~ | ~~/sk:write-plan~~ | **Skipped** | — |
-| ~~3~~ | ~~/sk:write-tests~~ | **Skipped** | — |
-| 4 | `/sk:debug` | Root-cause analysis | Think |
-| 5 | `/sk:branch` | Create hotfix branch | Build |
-| 6 | implement directly | Fix the issue | Build |
-| 7 | run existing tests | Must still pass | Build |
-| 8 | `/sk:smart-commit` | Commit the fix | Build |
-| 9 | `/sk:gates` | All 6 quality gates (parallel) | Verify |
-| 10 | `/sk:finish-feature` | Changelog + PR (marked as hotfix) | Ship |
+| 1 | `/sk:debug` | Root-cause analysis | Think |
+| 2 | `/sk:branch` | Create hotfix branch | Build |
+| 3 | implement directly | Fix the issue | Build |
+| 4 | `/sk:smart-commit` | Commit the fix | Build |
+| 5 | `/sk:gates` | All quality gates (parallel batches) | Verify |
+| 6 | `/sk:finish-feature` | Changelog + PR (marked as hotfix) | Ship |
 
 After merging: add regression test + lesson to `tasks/lessons.md`.
 
@@ -172,7 +156,7 @@ One command runs all 6 gates in parallel batches:
 | **3** | code review | Needs deep understanding |
 | **4** | E2E Tests | Needs review fixes |
 
-Each gate auto-fixes, auto-commits, and re-runs until clean. If a gate fails 3 times, it stops and asks for help.
+Each gate auto-fixes and re-runs until clean. Fixes are squashed into one commit per gate pass. If a gate fails 3 times, it stops and asks for help.
 
 Pre-existing issues are logged to `tasks/tech-debt.md` — not fixed inline.
 
@@ -265,7 +249,7 @@ Use these anytime — they're not part of any workflow.
 
 | Topic | Where |
 |-------|-------|
-| Detailed workflow steps (21-step table) | [DOCUMENTATION.md](.claude/docs/DOCUMENTATION.md) |
+| Detailed workflow steps (8-step flow) | [DOCUMENTATION.md](.claude/docs/DOCUMENTATION.md) |
 | Feature specifications | [docs/FEATURES.md](docs/FEATURES.md) |
 | Model routing profiles & config | [DOCUMENTATION.md — Config](.claude/docs/DOCUMENTATION.md#config-reference) |
 | Infrastructure (hooks, agents, rules) | [DOCUMENTATION.md — Setup](.claude/docs/DOCUMENTATION.md#what-gets-created) |

package/commands/sk/autopilot.md

@@ -1,5 +1,5 @@
 ---
-description: "Hands-free workflow — all 21 steps, auto-skip, auto-advance, auto-commit. Stops only for direction approval and PR push."
+description: "Hands-free workflow — all 8 steps, auto-skip, auto-advance, auto-commit. Stops only for direction approval and PR push."
 ---
 
 # /sk:autopilot
@@ -8,7 +8,7 @@ Run the full ShipIt workflow in hands-free mode.
 
 Usage: `/sk:autopilot <task description>`
 
-Executes all 21 workflow steps with:
+Executes all 8 workflow steps with:
 - **Auto-skip** — optional steps skipped when clearly not needed
 - **Auto-advance** — no manual step transitions
 - **Auto-commit** — conventional format, no approval prompt

package/commands/sk/security-check.md

@@ -12,7 +12,7 @@ By default, this checks only files changed on the current branch. Use `--all` to
 
 ## Hard Rules
 
-- **Fix all in-scope findings** (files in `git diff main..HEAD --name-only`) immediately after the audit. auto-commit with `fix(security): resolve [severity] security findings`. Re-run the audit until 0 findings remain.
+- **Fix all in-scope findings** (files in `git diff main..HEAD --name-only`) immediately after the audit. Re-run the audit until 0 findings remain. Once clean, make ONE squash commit: `fix(security): resolve security findings`.
 - **Pre-existing findings** (files outside the current branch diff): log to `tasks/tech-debt.md` using this format — do NOT fix inline:
   ```
   ### [YYYY-MM-DD] Found during: sk:security-check
@@ -20,7 +20,7 @@ By default, this checks only files changed on the current branch. Use `--all` to
   Issue: description of the vulnerability
   Severity: critical | high | medium | low
   ```
-- **Gates own their commits** — the fix-commit-rerun loop is fully internal. No manual commit step needed after this gate.
+- **Squash gate commits** — collect all fixes for the pass, then one commit. Do not commit after each individual fix.
 - **DO NOT skip checks** because the project is small or simple. Production is production.
 - **Every finding must cite a specific file and line number.**
 - **Every finding must reference the standard it violates** (OWASP, CWE, NIST, etc.).

package/commands/sk/status.md

@@ -1,25 +1,20 @@
 ---
-description: “Show planning and workflow status at a glance.”
+description: "Show planning and workflow status at a glance."
 ---
 
 <!-- Generated by /sk:setup-claude -->
 
 # /sk:status
 
-Read `tasks/todo.md` and `tasks/workflow-status.md`, then display a compact status summary.
+Read `tasks/todo.md`, then display a compact status summary.
 
 ## What to show
 
-### Workflow Status (from `tasks/workflow-status.md`)
-- Current step: show the step marked `>> next <<`
-- Completed steps: count of `done` steps vs total
-- Any steps marked `partial` or with notable Notes
-- If no workflow file exists, say “No active workflow”
-
 ### Task Status (from `tasks/todo.md`)
 - Total plan items vs completed plan items (checkbox count)
+- Current git branch
 - Errors count (if the file has an Errors section/table)
 - Whether `tasks/findings.md` and `tasks/progress.md` exist
 
-Keep it brief: answer “where am I?” and “what’s next?”.
+Keep it brief: answer "where am I?" and "what's next?".
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kennethsolomon/shipkit",
-  "version": "3.10.0",
+  "version": "3.10.2",
   "description": "A structured workflow toolkit for Claude Code.",
   "keywords": [
     "claude",

package/skills/.claude/settings.local.json

@@ -12,7 +12,26 @@
       "Bash(done)",
       "Bash(tasks/security-findings.md:*)",
       "Bash(git push:*)",
-      "Bash(git tag:*)"
+      "Bash(git tag:*)",
+      "Bash(find /Users/kennethsolomon/Herd/shipit -type f -name *.md -path */node_modules/*commands/sk/*)",
+      "Bash(grep -r \"sk:\" /Users/kennethsolomon/Herd/shipit/commands/sk/*.md)",
+      "Bash(find /Users/kennethsolomon/Herd/shipit/.claude/docs -name *.md)",
+      "Bash(grep -v \"^Command$\")",
+      "Bash(find /Users/kennethsolomon/Herd/shipit -path */test* -o -path */__tests__/* -o -path */spec/*)",
+      "Bash(find /Users/kennethsolomon/Herd/shipit/commands/sk -type f -name *.md)",
+      "Bash(find /Users/kennethsolomon/Herd/shipit/skills -maxdepth 1 -type d -name sk:*)",
+      "Bash(python3 -m py_compile skills/sk:debug/lib/step_runner.py)",
+      "Bash(python3 -m py_compile skills/sk:debug/debug_conductor.py)",
+      "Bash(python3 -m py_compile skills/sk:setup-optimizer/lib/discover.py)",
+      "Bash(python3 -m py_compile skills/sk:debug/lib/findings_writer.py)",
+      "Bash(python3 -m py_compile skills/sk:debug/lib/lessons_writer.py)",
+      "Bash(python3 -m py_compile skills/sk:skill-creator/scripts/run_eval.py)",
+      "Bash(python3 -m py_compile skills/sk:skill-creator/scripts/run_loop.py)",
+      "Bash(python3 -m py_compile skills/sk:skill-creator/scripts/improve_description.py)",
+      "Bash(python3 -m py_compile skills/sk:skill-creator/scripts/generate_report.py)",
+      "Bash(python3 -m py_compile skills/sk:skill-creator/scripts/utils.py)",
+      "Bash(git:*)",
+      "Bash(npm publish:*)"
     ]
   }
 }

package/skills/sk:accessibility/SKILL.md

@@ -43,6 +43,8 @@ Run this skill:
 - Visible focus indicator on all interactive elements (not removed with `outline: none` without replacement)
 - Modal/dialog focus management: focus moves into modal on open, returns to trigger on close
 - Skip navigation link present for pages with repeated navigation
+- Modals and multi-step flows must have a visible cancel/back affordance — no dead ends (WCAG 3.2.2)
+- Do not override or intercept system/platform keyboard shortcuts (Tab, arrow keys, Escape, VoiceOver gestures)
 
 ### 3. ARIA & Semantics (WCAG 4.1.2, 1.3.1)
 - Semantic HTML first (`<button>`, `<nav>`, `<main>`, `<header>`) — ARIA only when HTML is insufficient
@@ -70,7 +72,14 @@ Run this skill:
 - All non-essential animations respect `prefers-reduced-motion` media query
 - Auto-playing animations can be paused, stopped, or hidden
 
-### 7. Content & Structure (WCAG 1.3.1, 2.4.6, 2.4.2)
+### 7. iOS Dynamic Type (Apple HIG)
+- UI must remain fully readable and usable when system font size is at the largest accessibility setting
+- No text truncation at large sizes — prefer wrapping over ellipsis
+- All layouts must reflow correctly without overlapping or clipping at Dynamic Type XXL
+- Avoid fixed heights on elements that contain text — use dynamic sizing
+- Test at: Settings → Accessibility → Display & Text Size → Larger Text (max slider)
+
+### 8. Content & Structure (WCAG 1.3.1, 2.4.6, 2.4.2)
 - Single `<h1>` per page; heading hierarchy is logical (no skipped levels)
 - Page has a descriptive `<title>`
 - Link text is descriptive standalone ("Read the docs" not "Click here")

package/skills/sk:autopilot/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: sk:autopilot
-description: Hands-free workflow — runs all 21 steps with auto-skip, auto-advance, auto-commit. Stops only for direction approval, 3-strike failures, and PR push.
+description: Hands-free workflow — runs all 8 steps with auto-skip, auto-advance, auto-commit. Stops only for direction approval, 3-strike failures, and PR push.
 user_invocable: true
 allowed_tools: Read, Write, Bash, Glob, Grep, Agent, Skill
 ---
 
 # Autopilot Mode
 
-Hands-free workflow that executes all 21 steps of the ShipIt workflow with minimal interruptions. Same quality gates, same fix loops, same 100% coverage — just fewer stops.
+Hands-free workflow that executes all 8 steps of the ShipIt workflow with minimal interruptions. Same quality gates, same fix loops, same 100% coverage — just fewer stops.
 
 ## When to Use
 
@@ -23,30 +23,19 @@ Hands-free workflow that executes all 21 steps of the ShipIt workflow with minim
 
 ## Quality Guarantee
 
-Autopilot runs the EXACT same 21 steps as manual mode:
+Autopilot runs the EXACT same 8 steps as manual mode:
 - ALL quality gates enforced (lint, test, security, perf, review, e2e)
-- ALL fix-commit-rerun loops active
+- ALL fix-rerun loops active
 - 100% test coverage required on new code
 - 0 security issues required
 - The ONLY difference: auto-advance between steps instead of stopping
 
 ## Steps
 
-### 0. Reset Tracker
+### 1. Load Context + Brainstorm + Direction Approval (STOP — requires user input)
 
-Read `tasks/workflow-status.md`. If it has done/skipped steps from a different task, auto-reset all steps to `not yet`.
-
-### 1. Load Context (auto — no prompt)
-
-- Read `tasks/todo.md`
-- Read `tasks/lessons.md` (apply all active lessons as constraints)
-- Read `tasks/findings.md` (if exists)
-- Read `tasks/tech-debt.md` (if exists)
-
-### 2. Brainstorm + Direction Approval (STOP — requires user input)
-
-Run brainstorm internally:
-- Explore the codebase (3 parallel Explore agents)
+- Read `tasks/todo.md`, `tasks/lessons.md`, `tasks/findings.md`, `tasks/tech-debt.md`
+- Run brainstorm internally (3 parallel Explore agents)
 - Propose 2-3 approaches with trade-offs
 
 **Present ONE direction summary and ask:**
@@ -57,40 +46,33 @@ Run brainstorm internally:
 
 Wait for explicit `y` before continuing. This is the ONLY planning stop.
 
+### 2. Design (auto-skip if no frontend/API keywords)
+
+Run `/sk:frontend-design` or `/sk:api-design` if applicable. Auto-skip if no frontend/API keywords detected. Log: `Auto-skipped: Design ([reason])`
+
 ### 3. Plan (auto-advance)
 
-Write the implementation plan to `tasks/todo.md`. Do NOT ask for plan approval — the direction approval in step 2 covers this.
+Write the implementation plan to `tasks/todo.md`. Do NOT ask for plan approval — the direction approval in step 1 covers this.
 
 ### 4. Branch (auto-advance)
 
 Create feature branch auto-named from the task. Do NOT ask for confirmation.
 
-### 5. Auto-Skip Detection
+### 5. Write Tests + Implement (auto-advance)
 
-Scan `tasks/todo.md` for frontend/backend/database keywords. For each optional step:
-- **Design (step 4)**: auto-skip if no frontend keywords
-- **Accessibility (step 5)**: auto-skip if no frontend keywords
-- **Migrate (step 8)**: auto-skip if no database keywords
-- **Performance (step 15)**: auto-skip if no frontend AND no database keywords
+- Run `/sk:write-tests` (TDD red phase)
+- Run `/sk:schema-migrate` if database keywords detected
+- Run `/sk:execute-plan` (TDD green phase)
+- Auto-advance when done
 
-Log each auto-skip: `Auto-skipped: [Step Name] ([reason])`
-
-### 6. Write Tests (auto-advance)
-
-Write failing tests based on the plan (TDD red phase). Auto-advance when done.
-
-### 7. Implement (auto-advance)
-
-Execute the plan — make failing tests pass. Use wave-based sub-agents for parallel work where possible.
-
-### 8. Commit (auto-commit)
+### 6. Commit (auto-commit)
 
 Auto-commit with conventional commit format. Do NOT ask for commit message approval.
 Format: `type(scope): description`
 
-### 9. Gates (auto-advance on clean pass)
+### 7. Gates (auto-advance on clean pass)
 
-Run all quality gates. Use `/sk:gates` if available, otherwise run sequentially:
+Run all quality gates via `/sk:gates`:
 1. Lint + dep audit
 2. Test (100% coverage)
 3. Security (0 issues)
@@ -98,9 +80,9 @@ Run all quality gates. Use `/sk:gates` if available, otherwise run sequentially:
 5. Review + simplify
 6. E2E
 
-Each gate auto-fixes and re-runs internally. Auto-advance to next gate on clean pass.
+Each gate auto-fixes and re-runs internally. Squash gate commits — one commit per gate pass.
 
-### 10. PR Push (STOP — requires user confirmation)
+### 8. PR Push (STOP — requires user confirmation)
 
 **This is the second mandatory stop.** Present:
 > "All gates passed. Ready to create PR.
@@ -110,11 +92,10 @@ Each gate auto-fixes and re-runs internally. Auto-advance to next gate on clean
 
 Wait for explicit confirmation — pushing is visible to others.
 
-### 11. Finalize (auto-advance)
-
+After confirmation:
 - Create PR
 - Sync features (`/sk:features`)
-- Ask about release (step 21 is never auto-skipped)
+- Ask about release (never auto-skipped)
 
 ## 3-Strike Protocol
 
@@ -128,9 +109,9 @@ If any step fails 3 times:
 
 | Stop | When | Why |
 |------|------|-----|
-| Direction approval | After brainstorm (step 2) | User must approve the approach |
+| Direction approval | After brainstorm (step 1) | User must approve the approach |
 | 3-strike failure | Any step fails 3x | Needs human judgment |
-| PR push | Before creating PR (step 10) | Visible to others — always confirm |
+| PR push | Before creating PR (step 8) | Visible to others — always confirm |
 
 Everything else auto-advances.
 

package/skills/sk:brainstorming/SKILL.md

@@ -34,7 +34,7 @@ You MUST create a task for each of these items and complete them in order:
    - Open questions (if any remain)
    Additionally, **append** an ADR entry to `docs/decisions.md` (see "Decisions Log" section below).
    (Optionally also write a full design doc to docs/plans/YYYY-MM-DD-<topic>-design.md)
-6. **Transition to implementation** — invoke writing-plans skill to create implementation plan
+6. **Transition to implementation** — invoke `/sk:write-plan` skill to create implementation plan
 
 ## Process Flow
 
@@ -46,7 +46,7 @@ digraph brainstorming {
     "Present design sections" [shape=box];
     "User approves design?" [shape=diamond];
     "Write design doc" [shape=box];
-    "Invoke writing-plans skill" [shape=doublecircle];
+    "Invoke `/sk:write-plan` skill" [shape=doublecircle];
 
     "Explore project context" -> "Ask clarifying questions";
     "Ask clarifying questions" -> "Propose 2-3 approaches";
@@ -54,11 +54,11 @@ digraph brainstorming {
     "Present design sections" -> "User approves design?";
     "User approves design?" -> "Present design sections" [label="no, revise"];
     "User approves design?" -> "Write design doc" [label="yes"];
-    "Write design doc" -> "Invoke writing-plans skill";
+    "Write design doc" -> "Invoke `/sk:write-plan` skill";
 }
 ```
 
-**The terminal state is invoking writing-plans.** Do NOT invoke frontend-design, mcp-builder, or any other implementation skill. The ONLY skill you invoke after brainstorming is writing-plans.
+**The terminal state is invoking `/sk:write-plan`.** Do NOT invoke frontend-design, mcp-builder, or any other implementation skill. The ONLY skill you invoke after brainstorming is `/sk:write-plan`.
 
 ## The Process
 
@@ -95,8 +95,8 @@ digraph brainstorming {
 - Commit the findings, decisions log entry, and any design document to git
 
 **Implementation:**
-- Invoke the writing-plans skill to create a detailed implementation plan
-- Do NOT invoke any other skill. writing-plans is the next step.
+- Invoke the `/sk:write-plan` skill to create a detailed implementation plan
+- Do NOT invoke any other skill. `/sk:write-plan` is the next step.
 
 ## Decisions Log
 

package/skills/sk:context/SKILL.md

@@ -26,21 +26,19 @@ Load all project context files into the conversation and output a formatted sess
 | # | File | What to Extract |
 |---|------|-----------------|
 | 1 | `tasks/todo.md` | Task name (from `# TODO —` heading), milestone progress, count of `- [x]` (done) vs `- [ ]` (pending) checkboxes |
-| 2 | `tasks/workflow-status.md` | Current step (row with `>> next <<`), step name, command to run |
-| 3 | `tasks/progress.md` | Last 5 entries only (most recent work). If file is large, read only the last 50 lines. |
-| 4 | `tasks/findings.md` | Current decisions, chosen approach, open questions |
-| 5 | `tasks/lessons.md` | All active lessons — read in full, apply as constraints for this session |
-| 6 | `docs/decisions.md` | If exists: last 3 ADR entries. If missing: note "no decisions log yet" |
-| 7 | `docs/vision.md` | If exists: product name + value proposition. If missing: note "no vision.md found" |
-| 8 | `tasks/tech-debt.md` | If exists: count entries with no `Resolved:` line (unresolved), highest severity among unresolved |
+| 2 | `tasks/progress.md` | Last 5 entries only (most recent work). If file is large, read only the last 50 lines. |
+| 3 | `tasks/findings.md` | Current decisions, chosen approach, open questions |
+| 4 | `tasks/lessons.md` | All active lessons — read in full, apply as constraints for this session |
+| 5 | `docs/decisions.md` | If exists: last 3 ADR entries. If missing: note "no decisions log yet" |
+| 6 | `docs/vision.md` | If exists: product name + value proposition. If missing: note "no vision.md found" |
+| 7 | `tasks/tech-debt.md` | If exists: count entries with no `Resolved:` line (unresolved), highest severity among unresolved |
 
 ### Reading Strategy
 
-- Read files 1-5 first (these are the core context).
-- Files 6-7 are optional — check if they exist before reading.
+- Read files 1-4 first (these are the core context).
+- Files 5-6 are optional — check if they exist before reading.
 - For `tasks/progress.md`: only read the last 50 lines to avoid loading a huge file.
 - If `tasks/todo.md` is missing: the project has no active task.
-- If `tasks/workflow-status.md` is missing: the workflow hasn't started.
 
 ---
 
@@ -54,9 +52,8 @@ After reading all files, output this session brief:
 ╚══════════════════════════════════════════╝
 Branch:     [current git branch]
 Task:       [task name from todo.md, or "No active task"]
-Step:       [step #] [step name] → run `/sk:[command]`
+Progress:   [N done] / [M total] checkboxes in todo.md
 Last done:  [last progress.md entry summary, 1 line]
-Pending:    [N] checkboxes remaining in todo.md
 Lessons:    [count] active — [most critical 1-liner from lessons.md]
 Open Qs:    [open questions from findings.md, or "none"]
 Tech Debt:  [N] unresolved — highest: [severity] ([file:line])
@@ -68,9 +65,8 @@ Product:    [value prop from vision.md, or "no vision.md found"]
 
 - **Branch:** Run `git branch --show-current` to get the current branch name.
 - **Task:** Extract from the first `# TODO —` line in `tasks/todo.md`. If the file doesn't exist or all checkboxes are done, show "No active task — ready to start fresh".
-- **Step:** Find the row containing `>> next <<` in `tasks/workflow-status.md`. Extract step number, name, and command. If no `>> next <<` found, show "Workflow complete" or "Not started".
+- **Progress:** Count `- [x]` (done) and `- [ ]` (pending) lines in `tasks/todo.md`. Stop counting at the first `## Verification`, `## Acceptance Criteria`, or `## Risks` heading (these are meta-sections, not tasks). Show `N done / M total`.
 - **Last done:** The most recent entry from `tasks/progress.md`. Summarize in one line.
-- **Pending:** Count `- [ ]` lines in `tasks/todo.md`. Stop counting at the first `## Verification`, `## Acceptance Criteria`, or `## Risks` heading (these are meta-sections, not tasks).
 - **Lessons:** Count `### [` headings in `tasks/lessons.md` (each lesson starts with `### [YYYY-MM-DD]`). Show the count + the **Prevention:** line from the most recent lesson.
 - **Open Qs:** Check for an "## Open Questions" section in `tasks/findings.md`. List them or say "none".
 - **Tech Debt:** Read `tasks/tech-debt.md` if it exists. Count entries that have no `Resolved:` line — each entry starts with `### [`. For unresolved entries, find the highest severity. Show `N unresolved — highest: [severity] ([file])`. If file missing or 0 unresolved, show `none`.
@@ -93,7 +89,7 @@ After outputting the session brief:
 | Scenario | Behavior |
 |----------|----------|
 | No `tasks/todo.md` | Show "No active task — ready to start fresh" |
-| No `tasks/workflow-status.md` | Show "Workflow not started" for Step field |
+| All checkboxes done in todo.md | Show "Task complete — 0 pending" for Progress field |
 | No `tasks/progress.md` | Show "No progress logged yet" for Last done |
 | No `tasks/findings.md` | Show "none" for Open Qs |
 | No `tasks/lessons.md` | Show "0 active" for Lessons |

package/skills/sk:dashboard/SKILL.md

@@ -29,9 +29,8 @@ PORT=4000 node skills/sk:dashboard/server.js
 ## What It Shows
 
 - **Swimlanes per worktree** — one row per worktree discovered via `git worktree list`
-- **Phase timeline** — workflow steps laid out as columns (Read, Explore, Plan, Branch, Tests, Implement, Lint, Verify, Security, Review, E2E, Finalize)
-- **Status indicators** — done, skipped, partial, in-progress, not yet
-- **Progress bars** — percentage of steps completed per worktree
+- **Phase timeline** — workflow steps laid out as columns (Explore, Design, Plan, Branch, Tests+Implement, Commit, Gates, Finalize)
+- **Progress bars** — percentage of todo.md checkboxes completed per worktree
 - **Current task** — the active task name from `tasks/todo.md`
 
 ## Architecture
@@ -39,7 +38,7 @@ PORT=4000 node skills/sk:dashboard/server.js
 Zero-dependency Node.js server. Uses only built-in modules (`http`, `fs`, `path`, `child_process`).
 
 - `server.js` serves the dashboard HTML and exposes `/api/status`
-- `/api/status` reads `tasks/workflow-status.md` and `tasks/todo.md` from each worktree, parses step statuses, and returns JSON
+- `/api/status` reads `tasks/todo.md` from each worktree, parses checkbox progress, and returns JSON
 - `dashboard.html` is a single-file UI (HTML + embedded CSS + JS) that polls `/api/status` every 3 seconds
 - Worktree discovery via `git worktree list`
 

package/skills/sk:dashboard/server.js

@@ -7,9 +7,6 @@ const { execSync } = require("child_process");
 const PORT =
   parseInt(process.argv.find((_, i, a) => a[i - 1] === "--port") || process.env.PORT, 10) || 3333;
 
-const HARD_GATES = new Set([12, 14, 16, 20, 22]);
-const OPTIONALS = new Set([4, 5, 8, 18, 27]);
-
 function stripMd(s) {
   return (s || "").replace(/\*\*/g, "").replace(/`/g, "").trim();
 }
@@ -34,53 +31,6 @@ function discoverWorktrees() {
   }
 }
 
-function parseWorkflowStatus(worktreePath) {
-  const filePath = path.join(worktreePath, "tasks", "workflow-status.md");
-  try {
-    const lines = fs.readFileSync(filePath, "utf8").split("\n");
-
-    let headerFound = false;
-    let separatorSkipped = false;
-    const steps = [];
-
-    for (const line of lines) {
-      if (!headerFound) {
-        if (line.includes("| # |")) headerFound = true;
-        continue;
-      }
-      if (!separatorSkipped) {
-        separatorSkipped = true;
-        continue;
-      }
-      const cells = line.split("|").slice(1, -1).map((c) => c.trim());
-      if (cells.length < 3) continue;
-
-      const number = parseInt(cells[0], 10);
-      if (isNaN(number)) continue;
-
-      const rawStep = stripMd(cells[1]);
-      const cmdMatch = rawStep.match(/\((.+?)\)/);
-      const command = cmdMatch ? cmdMatch[1].trim() : "";
-      const name = rawStep.replace(/\s*\(.+?\)\s*/, "").trim();
-
-      steps.push({
-        number,
-        name,
-        command,
-        status: stripMd(cells[2]),
-        notes: stripMd(cells[3]),
-        isHardGate: HARD_GATES.has(number),
-        isOptional: OPTIONALS.has(number),
-      });
-    }
-    return steps;
-  } catch (err) {
-    if (err.code === "ENOENT") return [];
-    process.stderr.write(`Error parsing workflow-status.md: ${err.message}\n`);
-    return [];
-  }
-}
-
 const STOP_HEADERS = new Set(["Verification", "Acceptance Criteria", "Risks", "Change Log", "Summary"]);
 
 function parseTodo(worktreePath) {
@@ -137,18 +87,8 @@ function parseTodo(worktreePath) {
 function buildStatus() {
   const worktrees = discoverWorktrees();
   return worktrees.map((wt) => {
-    const steps = parseWorkflowStatus(wt.path);
     const todo = parseTodo(wt.path);
 
-    let currentStep = 0;
-    let totalDone = 0;
-    let totalSkipped = 0;
-    for (const s of steps) {
-      if (s.status === ">> next <<") currentStep = s.number;
-      if (s.status === "done") totalDone++;
-      if (s.status === "skipped") totalSkipped++;
-    }
-
     return {
       path: wt.path,
       branch: wt.branch,
@@ -156,11 +96,6 @@ function buildStatus() {
       todosDone: todo.todosDone,
       todosTotal: todo.todosTotal,
       todoItems: todo.todoItems,
-      currentStep,
-      totalDone,
-      totalSkipped,
-      totalSteps: steps.length,
-      steps,
     };
   });
 }