Architecture Review

This is a systematic approach to fixing messy codebases without making things worse. It walks you through mapping your current structure, identifying concrete problems like circular dependencies and god modules, then refactoring incrementally with tests validating each step. The references cover dependency graphs, migration patterns, and structural templates for different project types. What I appreciate here is the anti-rationalization guide, basically a list of excuses developers make to avoid cleaning up architecture debt. It's TypeScript/JavaScript focused but the patterns translate. Use this when your codebase has grown organically and new features are getting harder to ship because nobody knows where anything goes anymore.

Install to Claude Code

npx -y skills add srstomp/pokayokay --skill architecture-review --agent claude-code