Rule Reference

July 9, 2026 · View on GitHub

RuleSummaryEnforced ByWhen to Skip
evaluate-before-implementPresent evaluation with pros/cons/alternatives before implementingenforce-evaluate.sh + session-start.shTrivial changes, user says "skip"
plan-before-codeCreate implementation plan for changes touching 3+ filesenforce-superpowers.sh + Superpowers plugin1-2 file changes, user provided plan
test-per-bugfixEvery bug fix must include a regression teststop-checklist.shN/A — always required for bug fixes
test-strategyAssess testing/security needs based on project risk profile during planningsession-start.sh (context injection)Project already has current TEST-STRATEGY.md
naming-conventionsFollow established naming patterns and language-standard conventionssession-start.sh (context injection)N/A — always applies
version-bumpBump version before committing source changespre-commit-checks.shDoc-only commits
changelog-updateUpdate changelog alongside source commitspre-commit-checks.shDoc-only commits
context-managementSave context history before compression, reload aftersession-start.sh (post-compaction recovery) + stop-checklist.shShort sessions
session-disciplineCommit before ending, imperative commit messages, verify buildsstop-checklist.shN/A
observabilityEvaluate monitoring/logging needs, never swallow errorssession-start.sh (context injection)Internal utilities
superpowers-workflowUse Superpowers brainstorm/plan/implement for non-trivial workenforce-superpowers.shTrivial changes, user says "skip"
verify-after-completeWalk user through verifying acceptance criteria after completing planned worksession-start.sh (context injection)Trivial changes, user says "skip"
plan-closureDocument outcome of Superpowers-planned work: planned vs. actual, decisions, deferred issuesstop-checklist.sh (advisory)Trivial changes, user says "skip"
future-scalabilityConsider future platform plans in architecture decisionsscalability-check.shNo future platforms configured