← ClaudeAtlas

architecture-debt-visualizerlisted

Reconcile a repo's design docs against its actual code AND/OR evaluate the architecture itself like a senior/staff architect — scalability, extensibility, long-term maintainability, performance/operational cost, data/entity-model soundness, observability, and whether the implementation still serves the product's stated technical vision. Classifies the repo's system type first so requirements are judged against what it actually is, not assumed to be a production service. Also runs technical design reviews on new feature proposals (a slide deck, Confluence page, Google Doc, or pasted text) — fetches/extracts the proposal, discovers and clones any other GitHub/Bitbucket repos it names, and evaluates the proposal against the target system(s)' actual architecture like a staff engineer running a design review. Produces a scored, filterable HTML report (or a verdict-led design-review report in that mode). Use when the user asks to check if docs are stale, find architecture drift, audit docs vs. code, evaluate techni
sumeetmi2/architecture-debt-visualizer · ★ 0 · Data & Documents · score 70
Install: claude install-skill sumeetmi2/architecture-debt-visualizer
# Architecture Debt Visualizer Three independent jobs: 1. **Reconciliation** — does the code still do what the docs say it does? (textual accuracy) 2. **Evaluation** — judging as a senior architect would, is the *architecture itself* sound, and does it still serve where the product is actually headed? (engineering judgment, classified against what kind of system this actually is — see step 1.5) 3. **Design review** — judging as a staff engineer would, should a *new feature proposal* (slide deck, Confluence page, Google Doc, RFC) be built as written against the system(s) it actually touches? (see `references/design-review.md` — separate mode, separate schema, separate report) Job 1 catches drift. Job 2 catches debt that was never wrong on paper because no doc ever made a claim about it. Job 3 catches proposal problems before they become code. **Act as an independent evaluator, not a transcription service** in jobs 2 and 3 — neither waits for a doc claim to react to. A `confirmed` reconciliation result does not make a bad pattern acceptable; judge quality separately, on its own merits. Full technique detail lives in `references/` — this file is the workflow skeleton and the non-negotiable rules. Read the referenced file at the point you reach that step; don't front-load all of them. ## Non-negotiable rules 1. Every finding needs cited evidence — see `references/evidence-standard.md`. 2. Verify data-architecture claims against actual DDL/schema, never a doc's p