architecture-review▌
srstomp/pokayokay · updated Apr 8, 2026
Analyze, audit, and improve project structure.
Architecture Review
Analyze, audit, and improve project structure.
Key Principles
- Measure before changing — Map structure and identify concrete issues before proposing changes
- Clear boundaries — Layers (UI, logic, data) separated with consistent dependency direction
- Colocation — Related code together; easy to find, change, and delete features
- Incremental migration — Refactor in phases, validate each step with tests
Quick Assessment
- No circular dependencies
- Consistent directory naming and grouping (by feature or by type)
- Single responsibility per file/module, reasonable file sizes (<500 lines)
- External dependencies isolated, shared code properly extracted
- New developers can navigate and find code for any feature easily
Quick Start Checklist
- Map current structure: directory tree, dependency graph, module boundaries
- Identify issues: circular deps, god modules, leaky abstractions, deep nesting
- Classify severity: critical (blocks dev), high (maintenance burden), medium/low (friction)
- Propose target structure with migration plan
- Execute incrementally, validating with tests after each move
References
| Reference | Description |
|---|---|
| analysis-techniques.md | Dependency graphs, complexity metrics, code analysis |
| refactoring-patterns.md | Safe refactoring techniques, migration strategies |
| structural-patterns.md | Directory structures for different project types |
| dependency-management.md | Circular deps, coupling, module boundaries |
| cleanup-strategies.md | Dead code removal, consolidation, naming conventions |
| anti-rationalization.md | Iron Law, common rationalizations, red flag STOP list for architecture discipline |
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★35 reviews- ★★★★★Ganesh Mohane· Dec 28, 2024
Keeps context tight: architecture-review is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Michael Jain· Dec 20, 2024
I recommend architecture-review for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Amina Agarwal· Dec 16, 2024
We added architecture-review from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Chen Bansal· Dec 16, 2024
Keeps context tight: architecture-review is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Kaira Agarwal· Dec 12, 2024
architecture-review fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Sakshi Patil· Nov 19, 2024
architecture-review has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Isabella Sanchez· Nov 11, 2024
architecture-review reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Isabella Patel· Nov 7, 2024
architecture-review has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Nia Garcia· Oct 26, 2024
Solid pick for teams standardizing on skills: architecture-review is focused, and the summary matches what you get after install.
- ★★★★★Chaitanya Patil· Oct 10, 2024
Solid pick for teams standardizing on skills: architecture-review is focused, and the summary matches what you get after install.
showing 1-10 of 35