Commit a0cb154
docs(methodology): complex animation/interaction debugging framework
Distills the methodology used across two waves of flip-module bug fixes
(commits 0664d82, 2fda167) into a reusable debugging framework specifically
tuned for complex animation and interaction bugs in React/CSS systems.
Framework covers:
- 4 core principles (visual is truth; data race over visual hack;
multi-role independent review with confidence calibration; reuse
existing patterns over inventing new mechanisms)
- 5-phase process (symptom capture → mechanism localization → solution
enumeration → red-team validation → ship + visual verification)
- Multi-agent collaboration template (Investigator / Solution Architect
/ Red Team / Implementer roles with prompt skeletons)
- Animation-specific knowledge base (render pipeline timing, CSS
transition vs animation subsystem independence, jsdom test boundaries,
React key reuse mechanism)
- Confidence calibration template (4-dimension scoring before commit)
- Anti-patterns catalog (9 specific traps from this project)
- 17-item launch checklist
Case studies reference the actual fix commits in this project. Doc is
project-archived at docs/superpowers/methodology/ so it remains discoverable
for future contributors.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent 2fda167 commit a0cb154
1 file changed
Lines changed: 481 additions & 0 deletions
0 commit comments