Summary
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-codeInstalls into .claude/skills of the current project.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Files
SKILL.md
Select a file.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
