gitcad
/
docs
/ adr
Architecture decision records
The durable spec: decisions are recorded before code, and superseded rather than edited (ADR-0001).
ADR-0001: Record architecture decisions
ADR-0002: Six seams, and an intent-based, MCP-first API
ADR-0003: Stable entity identity (the topological-naming fix)
ADR-0004: Text is source, geometry is a build artifact
ADR-0005: Three-tier test corpus (invariants over snapshots)
ADR-0006: Agent feedback loop — autonomy tiers and circuit breakers
ADR-0007: Privacy-preserving bug reduction
ADR-0008: The Part standard — one unit across all domains
ADR-0009: Interface-semver and the lockfile
ADR-0010: Atomic components and the parts registry
ADR-0011: Night Shift — scheduled autonomous work sessions
ADR-0012: Contribution without platform accounts — the relay
0013. Sketch constraints: solved at authoring time, never at build time
0014. Exploded views are projections; mates get semantics before a solver
0015. A type system for hardware: interfaces carry envelopes, connections type-check
0016. Branch-and-merge design exploration: semantic 3-way merge
0017. File naming: .gitcad is the product, extensions are roles
ADR-0018: gitcad-native B-rep kernel, from scratch, oracle-verified
ADR-0019 — Certified intervals: the K3 extension to the exactness charter
ADR-0020 — forge is the sole geometry kernel; OCCT is removed
ADR-0021 — one canonical B-rep; representations become constructors
ADR-0022 — A feature layer above the kernel, and `Body` as the only public return type
ADR-0023 — certified angles for trimmed quadric faces
ADR-0024 — the `sampled` provenance tier