Skip to content

Commit 65b1e34

Browse files
ajcarberryclaude
andcommitted
Remove design doc and pressure tests; plugins are the source of truth
Ran all 9 pressure scenarios as validators first (headless sessions, skill installed, judged against pass criteria): 9/9 behavioral passes, 8/9 skill auto-invocations. The one miss (verification-before-completion not triggering on a "just fix it and confirm" prompt) is fixed by sharpening the skill's trigger description. With the Iron-Law skills validated, the scenarios have done their job — real usage is the validation from here. SUPERPOWERS-DESIGN.md goes for the same reason: a second source of truth that must be manually synced with the plugins will drift; git history and the PR record keep the design rationale. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent bb0525f commit 65b1e34

9 files changed

Lines changed: 11 additions & 553 deletions

File tree

CLAUDE.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,9 @@ Reusable Claude Code plugins that raise the quality and consistency of AI-assist
88
work. The thesis: **context quality determines agent quality** — these plugins ship
99
the efficiency machinery agentic workflows need (work packets, model tiering,
1010
verification asymmetry, deterministic hook enforcement) as portable, shareable
11-
context. `SUPERPOWERS-DESIGN.md` is the authoritative design doc (v4).
11+
context. The plugins themselves are the source of truth — there is no separate
12+
design doc to keep in sync (the v4 design rationale lives in git history and the
13+
PR record).
1214

1315
Four plugins, each useful alone; launchpad is the only one that calls the others,
1416
always optionally with a stated fallback:
@@ -26,8 +28,7 @@ always optionally with a stated fallback:
2628
- **commit** (`plugins/commit/`) — `/commit` plus `commit-conventions` (atomicity,
2729
message-style override order).
2830

29-
`global/` holds the ~40-line global CLAUDE.md baseline and its installer;
30-
`pressure-tests/` holds scenarios for the Iron-Law skills.
31+
`global/` holds the ~40-line global CLAUDE.md baseline and its installer.
3132

3233
## Architecture
3334

@@ -68,9 +69,10 @@ Top-level `.claude-plugin/marketplace.json` registers all four.
6869
verification, ≤15-line subagent reports.
6970
- Iron-Law skills (`verification-before-completion`, `test-driven-development`,
7071
`systematic-debugging`) use the full house style (Iron Law, Go/No-Go gate,
71-
failure modes, red flags) and are validated against `pressure-tests/`. All other
72-
skills use a lean format. The Iron Laws double as routers: evidence must match
73-
the surface touched, which pulls specialist skills in when installed.
72+
failure modes, red flags); they were validated against pressure scenarios at
73+
v4 (9/9 behavioral passes) and now iterate from real usage. All other skills
74+
use a lean format. The Iron Laws double as routers: evidence must match the
75+
surface touched, which pulls specialist skills in when installed.
7476

7577
## Developing plugins
7678

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Claude Plugins
22

33
Development and product workflow plugins for
4-
[Claude Code](https://code.claude.com/docs). Design doc: `SUPERPOWERS-DESIGN.md`.
4+
[Claude Code](https://code.claude.com/docs).
55

66
Four plugins, each useful alone. Launchpad is the only one that calls the others —
77
always optionally, with a stated fallback.

SUPERPOWERS-DESIGN.md

Lines changed: 0 additions & 408 deletions
This file was deleted.

plugins/launchpad/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ IDEA → /stage → /mission-plan* → /launch → /orbit → /land
3838
scaled by stakes; independent-reviewer filter; blocking vs. nit.
3939
- **Flight rules** (auto-invoke during implementation):
4040
`verification-before-completion`, `test-driven-development`,
41-
`systematic-debugging` — Iron-Law format, pressure-tested in `pressure-tests/`.
41+
`systematic-debugging` — Iron-Law format (law, Go/No-Go gate, failure modes).
4242

4343
## Hooks — skills teach, hooks enforce
4444

plugins/launchpad/skills/verification-before-completion/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: verification-before-completion
3-
description: Use when about to claim work is done, complete, fixed, passing, working, or deployed — before saying "done", "fixed", "should work now", marking a todo completed, reporting success to the user, or committing. Also use when relying on a subagent's report of success or on test results from earlier in the session.
3+
description: Use when about to claim work is done, complete, fixed, passing, working, or deployed — before saying "done", "fixed", "should work now", marking a todo completed, reporting success to the user, or committing. Also when the user asks to "just fix it and confirm", frames a change as quick/trivial/urgent, relies on a subagent's report of success, or cites test results from earlier in the session.
44
---
55

66
# Flight Rule: Verification Before Completion

pressure-tests/README.md

Lines changed: 0 additions & 24 deletions
This file was deleted.

pressure-tests/systematic-debugging/scenarios.md

Lines changed: 0 additions & 40 deletions
This file was deleted.

pressure-tests/test-driven-development/scenarios.md

Lines changed: 0 additions & 36 deletions
This file was deleted.

pressure-tests/verification-before-completion/scenarios.md

Lines changed: 0 additions & 36 deletions
This file was deleted.

0 commit comments

Comments
 (0)