architecture-viz-scaffoldlisted
Install: claude install-skill bakw00ds/yakos
# Architecture viz scaffold
## Purpose
Drop in a static architecture page that renders the project's
existing architecture artifacts (ADRs, Mermaid diagrams,
CHANGELOG milestones, SBOM, tech-debt log, novel-capabilities
log) into one navigable UI surface. Operator runs once per
project; re-runs with `--regenerate` after material
architecture changes.
This is the largest cross-project-standards scaffold by scope.
The skill writes a renderer that READS existing artifacts; it
does NOT generate the source content (that's the architect
agent + `skill:adr-write`).
## Scope
Operates on the operator's project repo. Adds:
- Renderer script / component that reads architecture artifacts
and emits the page
- Mermaid → SVG rendering pipeline (build-time)
- `docs/tech-debt.md` and `docs/novel-capabilities.md` skeleton
files if absent
- Per-framework page route or static HTML output
Does NOT:
- Generate ADRs (use `skill:adr-write`)
- Generate diagrams (architect agent + operator)
- Run security audits or generate SBOMs (use `skill:sbom-generate`)
- Auto-detect technical debt (operator-maintained log)
## Automated pass
1. Detect frontend framework (same heuristics as other
scaffolds): Next.js / React-Vite / Vue / Svelte / static
HTML.
2. Ensure source-of-truth directories exist; create skeletons
if absent:
- `docs/architecture/` (Mermaid diagrams)
- Seed `system.mmd`, `container.mmd`, `component.mmd` with
minimal placeholders + comments pointing at the C