Skip to content

Commit a0cb154

Browse files
Caldisclaude
andcommitted
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

File tree

0 commit comments

Comments
 (0)