arch-lens plugin
Explores a codebase for architectural friction through the lens of Ousterhout's deep-module principle (small interface, large implementation). Seven-step interactive workflow: an Explore sub-agent navigates the codebase organically — the friction it experiences IS the signal. Surfaces candidate clusters with coupling reasons, call patterns, shared types, dependency categories, and existing tests that a boundary test would replace. User picks what to explore, frames the problem, then 3–4 parallel sub-agents design competing deep-module interfaces. Chosen design becomes a structured RFC action file readable by GitHub MCP or ROVO (Jira) MCP. Use when the user says "arch review", "find shallow modules", "module depth", "deep module", "Ousterhout", "testability audit", "surface coupling", "design interfaces", "RFC issues", or "architectural friction".
How to install the arch-lens plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add psenger/ai-agent-skills
/plugin install arch-lens@psenger-skills-marketplaceUpdate, turn off or remove
- Update the plugin (shell)
- claude plugin update arch-lens@psenger-skills-marketplace
- Refresh the marketplace
- /plugin marketplace update psenger-skills-marketplace
- Turn it off for now
- /plugin disable arch-lens@psenger-skills-marketplace
- Remove it
- /plugin uninstall arch-lens@psenger-skills-marketplace
arch-lens plugin questions
How do I install the arch-lens plugin?
In Claude Code run /plugin marketplace add psenger/ai-agent-skills, then /plugin install arch-lens@psenger-skills-marketplace.
How do I update or remove the arch-lens plugin?
Update it with claude plugin update arch-lens@psenger-skills-marketplace in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall arch-lens@psenger-skills-marketplace.