diff options
| author | Jesse Vincent <jesse@fsck.com> | 2026-10-19 21:49:13 -0700 |
|---|---|---|
| committer | Jesse Vincent <jesse@fsck.com> | 2026-10-19 21:49:13 -0700 |
| commit | 2b2ef34e752af82685355dc8d319d51aed0c0af6 (patch) | |
| tree | 9aad3ef2e0c1edcdd8baa6a5b34c61832059aaa4 | |
| parent | d079e1b85c8f964cb52da5e2be678c9fdfc8759b (diff) | |
executing-plans: drop the Example Workflow so SKILL.md fits under the compaction cutfix/executing-plans-under-compaction-cut
After a compaction, Claude Code re-attaches each invoked skill truncated to
20,000 characters (#2481). executing-plans was 20,405 bytes, so its last
lines fell past the cut. The Example Workflow was the redundant part: it
replayed rules the sections above already state (task-start/task-done,
rulings in the ledger, re-grading, the single fix pass, the final message's
two lists). SKILL.md is now 18,103 bytes.
Claude-Session: https://claude.ai/code/session_01EgKgPPzKtNA2okiCmqb11F
| -rw-r--r-- | skills/executing-plans/SKILL.md | 52 |
1 files changed, 0 insertions, 52 deletions
diff --git a/skills/executing-plans/SKILL.md b/skills/executing-plans/SKILL.md index 49077ad..ac77129 100644 --- a/skills/executing-plans/SKILL.md +++ b/skills/executing-plans/SKILL.md @@ -319,55 +319,3 @@ Use superpowers:finishing-a-development-branch. | "The reviewer said Minor, so it's Minor" | The label graded the spec's silence. Grade what the person gets. Re-grade, then gate. | | "The fix is obvious, no need for a failing test first" | The failing test is the only proof the finding was real and is now gone. Without it you have a diff and a hope. | | "I'll fix the minors too while I'm in there" | Every minor you fix is a test, a fix, and a suite run your partner did not ask for. Ledger them; your partner decides. | - -## Example Workflow - -``` -You: I'm using the executing-plans skill to implement this plan inline. - -[Setup: worktree verified] -[Read plan once: docs/superpowers/plans/feature-plan.md; spec read] -[Resolve workspace: sdd-workspace docs/superpowers/plans/feature-plan.md — no ledger inside, fresh start] -[Pre-flight scan: 2 shared-interface rows, 4 self-consistency rows, clean; written to ledger] -[Create todos for all tasks] - -Task 1: Hook installation script - -[task-start plan 1 → brief read; BASE a1b2c3d] -[Step 1: write failing test — written] -[Step 2: run it — FAIL: install_hook not defined. Matches Expected.] -[Step 3: implement — written] -[Step 4: run it — PASS 1/1. Matches Expected.] -[Step 5: commit — d4e5f6a] -[Contract: tests ran, output read, no deviations] -[task-done plan 1 a1b2c3d -- npm test -- hooks → ledger: Task 1: complete (commits a1b2c3d..d4e5f6a, tests: npm test -- hooks → 1/1 pass)] - -Task 2: Recovery modes - -[task-start plan 2 → brief read; BASE d4e5f6a] -[Step 2: run failing test — FAIL, but on an import error: Task 1 exported - installHook, brief consumes install_hook] -[Ruling: brief's consumer name is a typo against Task 1's Produces block; - use installHook — Ledger: Task 2: Ruling: install_hook → installHook — matches Task 1 Produces — cost if wrong: one rename] -[Steps 2-5 as planned; commit b7c8d9e] -[task-done plan 2 d4e5f6a -- npm test -- recovery → ledger: Task 2: complete (commits d4e5f6a..b7c8d9e, tests: npm test -- recovery → 8/8 pass)] - -... - -[After all tasks: review-package plan MERGE_BASE HEAD; dispatch code-reviewer, most capable model] -Reviewer: One Important finding — progress reporting interval hardcoded. Two Minor. -[Re-grade: Important stands; minors → ledger as deferred] -[Fix pass: test_progress_interval_configurable RED → extract PROGRESS_INTERVAL → GREEN; suite 12/12; commit] -[Ledger: Final: fixed hardcoded interval — test_progress_interval_configurable RED→GREEN, suite 12/12] - -Rulings I made: -- Task 2: install_hook → installHook (brief typo; cost if wrong: one rename) - -Deferred minors: -- README lacks a usage example -- recovery.js could split verify/repair into two files - -[Delete this plan's workspace — the record now lives in git] - -Using superpowers:finishing-a-development-branch. -``` |
