juanibiapina/review-architecture
agents/skills/review-architecture/SKILL.md
Find deep-module opportunities in a codebase. Use when the user wants to improve architecture, refactor, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
$ install --global
skillsauthnpx skillsauth add juanibiapina/dotfiles review-architectureInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 11, 2026, 8:28 AM132.0s1 file scanned
SKILL.md
- name:
- review-architecture
- description:
- Find deep-module opportunities in a codebase. Use when the user wants to improve architecture, refactor, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
Review Architecture
Surface architectural friction and propose deep-module opportunities — refactors that turn shallow modules into deep ones.
Load skill: vocabulary. Load skill: deep-modules.
Process
1. Explore Codebase
- Read existing documentation.
- Explore the codebase using deep-module principles.
2. Present candidates
Present a numbered list of deep-module opportunities. For each candidate:
- Files — which files/modules are involved
- Problem — why the current architecture is causing friction
- Solution — plain English description of what would change
- Benefits — explained in terms of locality and leverage, and also in how tests would improve
Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
3. Explore a candidate
Once the user picks a candidate, load and follow explore-design-space. Explore the selected deep-module opportunity as the plan or design under review.
Related Skills
juanibiapina/coding
development
VerifiedTrustedCommunity
Use before starting work on any coding task: implementing a feature, fixing a bug, refactoring, or changing code. Drives the complete implementation.
28SKILL.mdUpdated Jun 13, 2026
juanibiapina/vocabulary
development
VerifiedTrustedCommunity
Use when writing code plans, architecture, or generally discussing code
28SKILL.mdUpdated Jun 11, 2026
juanibiapina/testing
testing
VerifiedTrustedCommunity
Use when writing, reviewing, or improving tests, deciding what to mock, or designing interfaces for testability.
28SKILL.mdUpdated Jun 10, 2026
juanibiapina/tdd
development
VerifiedTrustedCommunity
Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
28SKILL.mdUpdated Jun 10, 2026