cluzter Topics

For Agents

Living index of themes for this project. Each H2 is a topic; bullets are wikilinks to related notes. Updated by obsidian-documenter when documenting work. Read by historian at bootstrap. Topics kept alphabetical.

Architecture

• cluzter — project entry point: what it is, the stack, the seven-phase plan at a glance
• Smaller forks worth keeping — the two-clock model (model clock vs viewport clock, bridged only by the LOD tier) and the CI-enforced engine/ import boundary

Colour Standards

• BL silently rendered black — exact-match-only lookup, unmatched code is a blocking error, B vs Bl as a standing regression test
• Mono print without inline colour codes — the same failure class — mono forces labels on regardless of LOD tier
• cluzter — JIS/Suzuki slash notation is the default standard (14 codes → 196 generated combinations)

Design Decisions

• cluzter-design-decisions — every fork, the options, the choice, the WHY; includes the two answers that reversed mid-conversation
• 2. Scale model — the reversal from “canvas units are millimetres” — ⟲ reversed by a reference image
• 3. Renderer — SVG, decided twice — ⟲ challenged by szig-felmeres, re-decided on independent grounds

Gotchas

• cluzter-wiring-gotchas — the four silent failures the data model exists to prevent, three of them already shipped by predecessor tooling

Identity & Data Model

• Connector name as identity — generated id vs display-only designator; cavityIndex vs stampedLabel
• 5. Terminations — one polymorphic union, not special-cased wire fields — cavity | splice | ground | fuse as a discriminated union

Predecessor & Cross-Project

• pipeline — the jot → WireViz pipeline cluzter succeeds; cluzter imports its 5-field grammar
• Inherited from the predecessor — the four decisions carried forward and the two gaps (gauge, splices) that became requirements
• 2026-07-29-hardcut-design — same vehicle; source of the real Bl/G / Br/W / B/Y wire data
• 2026-07-29-kb-wiring-extraction-v1-complete — retired AI netlist extraction over the same Suzuki Vitara scans; the scans themselves remain the underlay source
• szig-felmeres — react-konva CAD-lite app, explicitly not a template for cluzter

Units & Measurement

• 2. Scale model — the reversal from “canvas units are millimetres” — paper mm for layout, world mm for Wire.lengthMm only, never mixed
• Deriving wire length from a schematic path — why the model forbids deriving a length from a drawn path, and why slack is per-wire then summed