architecture-review
Installation
SKILL.md
Architecture Review with polyscan
Run the polyscan CLI to understand module structure and coupling. Dependency analysis exists for Go (package graph) and JavaScript/TypeScript (module graph); coupling (CBO) for Go, Rust and JavaScript/TypeScript; class cohesion (LCOM4) for Go and Rust; C++ gets complexity and clone detection only. No install needed: npx polyscan@latest analyze <path>.
Commands
| User Request | Command |
|---|---|
| "Check class coupling" | npx polyscan@latest analyze --format text --select cbo <path> |
| "Which Go or Rust types do too many things?" | npx polyscan@latest analyze --format text --select lcom <path> |
| "Find circular dependencies" | npx polyscan@latest analyze --format text --select deps <path> |
| "Which modules are risky to change?" | npx polyscan@latest analyze --format json --select deps,cbo <path> |
Text output shows per-class CBO and cycle membership, but only aggregate coupling stats for modules. Per-module Martin metrics (Ca/Ce, instability, abstractness, distance, risk level) and the explicit Zone of Pain / main-sequence module lists live in the deps section of the --format json output, which goes to stdout with the health-score summary on stderr.