← ClaudeAtlas

architecture-health-checklisted

Read-only architecture health check for orchd — find where many individually reasonable changes have gradually degraded the architecture (responsibility accumulation, workflow fragmentation, conditional sprawl, boundary violations, unclear state ownership, incremental duplication, over-stretched abstractions). Produces a prioritized, evidence-backed report and modifies no code. Use for a periodic review, or after a subsystem has grown a lot. Optionally pass a path, subsystem, or git range to scope it.
kbarendrecht/orchestrator · ★ 1 · Code & Development · score 64
Install: claude install-skill kbarendrecht/orchestrator
# Periodic Architecture Health Check Perform a **read-only** architecture health check of the codebase. Do **not** modify any code. The deliverable is a report, nothing else. This is a long-lived, AI-maintained application. The goal is to find the places where many individually reasonable changes have gradually made the architecture worse — not to grade it against a textbook. ## Scope - If the invocation passed a path, subsystem name, or git range as an argument, focus there. - Otherwise focus on the parts that have **changed or grown significantly** since the last review. There is no stored review marker, so establish "recent" from history — e.g. `git log --since=... --stat`, `git log --stat -- <path>`, or the last few dozen commits — and weight the churny, growing files. Say in the report what window you used. ## Start from what the repo already documents Before inspecting code, read the two hand-maintained sources of intent: - **README.md** — the architecture and the module map. - **TODO.md** — open decisions, "Decisions worth revisiting", and "Won't do without a reason". Several apparent problems are deliberate and explained there; do not re-flag a documented, intentional trade-off as drift. If a finding contradicts a TODO decision, say so and treat the decision as the baseline unless you have concrete evidence it has since broken. ## Understand the architecture first Before evaluating anything, inspect the relevant code and establish: - The ma