Skip to content

Replace superpowers plugin with local discipline rules and skills#379

Merged
philoserf merged 9 commits intomainfrom
feature/local-discipline-skills
Apr 11, 2026
Merged

Replace superpowers plugin with local discipline rules and skills#379
philoserf merged 9 commits intomainfrom
feature/local-discipline-skills

Conversation

@philoserf
Copy link
Copy Markdown
Owner

Summary

  • Replaces the superpowers-dev plugin with local rules and skills tuned to established preferences
  • Adds four always-on rule files: debugging.md, testing.md, parallelism.md, code-review.md — distilled from the corresponding superpowers skills without the ceremonial framing
  • Adds four invokable skills: brainstorming, writing-plans, writing-skills, use-discipline
  • /use-discipline is the new keystone: a single opt-in primer for deep work that frames the arc (problem framing → brainstorm → plan → execute under rules → review via existing skills), replacing the always-on session-start injection
  • Removes the superpowers-dev plugin entirely — marketplace, cache, enablement, and every dangling reference
  • Drops scratch/ from git (gitignored) so in-flight specs and plans never get committed

Design notes

  • Discipline skills → rules. Systematic debugging, TDD, parallel agents, and code review are always-on concerns. Folding them into rules/*.md removes the ceremony of "invoke this skill before doing X" while keeping the substance auto-loaded into every session.
  • Workflow skills stay as skills. brainstorming and writing-plans are phase-gated and invokable. Local versions are terser than the superpowers originals: no hard gates, no ALL-CAPS directives, no TodoWrite-per-step ceremony, no auto-committed artifacts.
  • writing-skills wraps skill-creator:skill-creator. Anthropic's skill-creator handles scaffolding; the local wrapper overlays naming prefixes, voice rules, the rename protocol, and this repo's conventions.
  • Plans live in ~/.claude/scratch/plans/, not the repo. Working state, not a deliverable.

Test plan

  • New session after the changes does not load the <EXTREMELY_IMPORTANT> using-superpowers preamble
  • All four new skills (brainstorming, writing-plans, writing-skills, use-discipline) appear in the harness skill listing
  • All four new rules (debugging.md, testing.md, parallelism.md, code-review.md) auto-load into the system prompt
  • grep -r "superpowers" .claude/ returns zero hits
  • bunx biome check settings.json passes
  • bunx prettier --write on all new files leaves them unchanged
  • Pre-existing uncommitted work in the branch was preserved untouched through the scope of this change

philoserf and others added 9 commits April 11, 2026 09:12
Local working state for in-progress specs and plans that should never
be committed.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Adds four always-on rule files covering debugging, testing, parallelism,
and code review — distilled from the corresponding superpowers skills
without the ceremonial framing.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Conversational dig-and-advise brainstorming without committed design
docs or hard gates. Replaces the superpowers version with a terser
flow matched to established preferences.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Produces bite-sized implementation plans in ~/.claude/scratch/plans/
instead of committing plan docs to the repo. Terser than the
superpowers version but keeps the no-placeholders discipline.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Thin skill that overlays local conventions (naming prefixes, voice,
rename protocol) on Anthropic's skill-creator. Replaces the
superpowers writing-skills skill.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Single opt-in entry for deep work. Frames the arc (brainstorm → plan
→ execute under rules → review via existing skills) conversationally
rather than through hard gates.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Prepares vc-ship for removal of the superpowers-dev plugin.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Replaced by local discipline rules and skills. All functionality
from the plugin is either covered by rules/*.md, reproduced in
local skills, or intentionally dropped.

Note: plugins/ is gitignored so the marketplace and cache directories
were deleted from the filesystem but are not part of this commit.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Cleans up dangling references in use-trueup and model-selection.md
that pointed to dropped superpowers skills or the docs/superpowers/
spec-location convention. Completes the removal of the plugin.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@philoserf philoserf merged commit 58fff4b into main Apr 11, 2026
2 checks passed
@philoserf philoserf deleted the feature/local-discipline-skills branch April 11, 2026 13:21
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