Skip to content

docs(readme): motivation narrative instead of comparison tables - #18

Merged
chipfighter merged 1 commit into
mainfrom
docs/readme-motivation
Jul 17, 2026
Merged

chipfighter merged 1 commit into
mainfrom
docs/readme-motivation

Conversation

@chipfighter

Copy link
Copy Markdown
Owner

What

Both READMEs: replace the "different layers" table + measured fixed-cost
table + demo TODO block with a four-paragraph motivation narrative —
mention Superpowers' route-everything trigger mechanism once as the
origin, state the inverted default (on-demand triggers, ~1.2k-token
fixed injection frozen by a CI test, script linked), and present the
spec layer as this project's own addition. Videos are cancelled; the
full comparison table lives on in the Reddit post drafts.

Evidence

  • tests/test-plugin-metadata.py passes (English-only rule + budget)
  • section flows directly into ## Install; net -42 lines across both READMEs

🤖 Generated with Claude Code

Drop the demo placeholder and both comparison tables. "Why this exists"
now tells the origin story in prose: Superpowers routes every response
through its skill system, this project inverts the default (dormant
until a named failure mode, ~1.2k-token fixed injection frozen by CI),
and adds its own spec layer on top. The measurement stays one passing
mention with the reproduce-it-yourself script link; the full table moves
to the promo drafts where head-to-head data belongs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@chipfighter
chipfighter merged commit 7819bbc into main Jul 17, 2026
2 checks passed
@chipfighter
chipfighter deleted the docs/readme-motivation branch July 17, 2026 08:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant