dsh-normify

Architecture diagrams rot the moment they are drawn — too coarse to expose interface contracts, invisible to AI mid-refactor, and governed by tribal knowledge. Normify reframes the entire project as a fractal module tree that both humans and AI can read and write, turning structure data into a verifiable source of truth. Every change is detected by normify_sync and must pass a zero-error close before the tree is allowed to advance, keeping the diagram and the code permanently in sync.

On the AI side, a generation skill and 31 tools support a design-first companion workflow: plan the tree, implement module by module, then close with a strict gate. The deterministic engine enforces three layers of fail-closed validation and produces SHA-256-frozen compiled artifacts. For humans, a zero-dependency single-file interactive diagram offers drill-down, API-anchored arrows, bilingual toggle, deep links, and zoom — open by double-click, archive or share as-is. Architecture rules live in policy.yml and are hard-enforced by validation; large repositories can be regenerated incrementally, rebuilding only the affected subtrees.

Built for engineers and teams using DeepSeek Harness who work in deeply layered, multi-module projects and want architecture documentation that never drifts from the code. No manual diagram upkeep: AI draws as it codes, the engine enforces the contract, and the tree grows as fine-grained as a single functional unit.