arch-viz

Supporting utility skill (Layer 11 Meta · "Code Reading Tools", alongside codegraph-cli and gitnexus-repo-map). Wraps the arch-viz CLI — a local tool that scans any repo (via CodeGraph) and emits a committable, client-presentable architecture bundle with a 100% permissive license chain. Upstream: https://github.com/kplliaoshen666-droid/arch-viz-studio · License: MIT.

1. Purpose

arch-viz scan runs CodeGraph (tree-sitter parse → local SQLite) as a subprocess, normalizes the result into a deterministic graph.json, and writes a four-file bundle into the target repo's docs/architecture/:

File	For	What it is
`graph.json`	AI agents + tooling	the stable, versioned, deterministic graph contract (nodes · edges · clusters · metrics)
`viz/index.html`	humans, zero-install	a self-contained offline viewer — double-click to open, no server, no install
`architecture.svg`	docs / slides	rendered diagram
`ARCHITECTURE.md`	humans	narrative overview

The point that makes arch-viz distinct from the other two code-reading tools: it produces a deliverable you can commit and hand to a client or teammate (and that an agent can read + safely annotate), with zero non-permissive licenses in the chain — so it is the right choice when the output needs to travel, be shown, or be committed.