> Cinder 0.1.0 documentation: Architecture decision records
> Canonical page: https://cinder.ash10.dev/docs/adr/ · Source: generated by this site (engine commit 47c9352, imported 2026-11-09)
> Index of every page for agents: https://cinder.ash10.dev/llms.txt

# Architecture decision records

Every significant build-versus-reuse, layering and deviation decision, with context and consequences. Deviations from the original brief each point to one of these.

- [ADR-0001: Build-versus-reuse decisions for the dependency stack](https://cinder.ash10.dev/docs/adr/0001-dependency-stack.md): Status: Accepted, 2026-11-08
- [ADR-0002: No MAX / max.gpu for rendering; GPU compute is WGSL](https://cinder.ash10.dev/docs/adr/0002-no-max-gpu.md): Status: Accepted, 2026-11-08
- [ADR-0003: One C11 shim owning every callback; Mojo pulls events](https://cinder.ash10.dev/docs/adr/0003-native-shim-pull-model.md): Status: Accepted, 2026-11-08 (callback-in-Mojo question deferred to spike 4)
- [ADR-0004: Building wgpu-native from source through CMake](https://cinder.ash10.dev/docs/adr/0004-wgpu-native-build.md): Status: Accepted, 2026-11-08
- [ADR-0005: Generating the Mojo bindings](https://cinder.ash10.dev/docs/adr/0005-bindings-generation.md): Status: Accepted, 2026-11-08 (decided by spike 9; supersedes the "Proposed" version of the same day)
- [ADR-0006: Start from scratch rather than fork stargine](https://cinder.ash10.dev/docs/adr/0006-no-fork-of-stargine.md): Status: Accepted, 2026-11-08
- [ADR-0007: Development host is a Linux container; Windows host is a file server](https://cinder.ash10.dev/docs/adr/0007-dev-environment-container.md): Status: Accepted, 2026-11-08
- [ADR-0008: Job system scheduling in Mojo, threads and parking from the shim](https://cinder.ash10.dev/docs/adr/0008-job-system-threads.md): Status: Accepted, 2026-11-08
- [ADR-0009: Graphics layer shape (typed handles, error scopes for shader diagnostics)](https://cinder.ash10.dev/docs/adr/0009-gfx-layer.md): Status: accepted, 2026-11-08.
- [ADR-0010: Renderer architecture (forward+, frame graph, shader assembly)](https://cinder.ash10.dev/docs/adr/0010-renderer.md): Status: accepted, 2026-11-08.
- [ADR-0011: Keep the Mojo archetype ECS (benchmarked against flecs)](https://cinder.ash10.dev/docs/adr/0011-ecs-mojo-vs-flecs.md): Status: accepted, 2026-11-08.
- [ADR-0012: Phase 6 subsystems: physics, animation, audio and input](https://cinder.ash10.dev/docs/adr/0012-physics-animation-audio-input.md): Status: accepted, 2026-11-09.
- [ADR-0013: Tools and the application runtime (Phase 7)](https://cinder.ash10.dev/docs/adr/0013-tools-and-app-runtime.md): Status: accepted, 2026-11-09.
- [ADR-0014: Sample game, benchmarks and the zero-allocation frame (Phase 8)](https://cinder.ash10.dev/docs/adr/0014-sample-game-and-performance.md): Status: accepted, 2026-11-09.
