Files
siege_deck/Docs/SiegeDeck/Engine/Build Order.md
T
darmanandClaude Opus 5.5 384f1ed1f2 feat: engine skeleton (Build Order step 1) and siege_tests
Engine:
- SdlContext and Window: RAII, throwing constructors, non-movable
- FrameClock (real time, clamped dt) and SimClock (fixed 1/60 s steps,
  speed 0 = planning phase, backlog capped per frame)
- Application owns them in lifetime order, exposes EngineContext, and
  runs the fixed-timestep loop; AppConfig::FromArgs parses --frames,
  --seed and --fullscreen
- Temporary window-surface fill so Wayland maps the window until
  RenderDevice lands in step 2

Build:
- Split into the siege_engine static lib and the siege_deck exe
- check_engine_deps fails the build if Engine/ includes Game/
- ctest smoke test: siege_deck --frames 30 on the offscreen driver
- siege_tests on Catch2 v3.15.3 (nixpkgs + CPM pin), with SimClock,
  FrameClock and AppConfig tests

Docs:
- Decision Log: error handling split, Catch2 for unit tests
- Build Order step 1 done; Engine Overview, Main Loop and Time and
  README updated to match
- AGENTS.md with build, conventions and gotchas for coding agents
- .gitignore: .mcp.json (local CLion MCP port) and Obsidian's
  workspace.json (tab/pane state), now untracked

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 00:27:36 +02:00

1.2 KiB

tags
tags
engine
roadmap

Build Order

  • 1. Skeleton: split CMake into siege_engine and siege_deck; write Application, FrameClock, SimClock and the main loop. --frames N keeps working. See Main Loop and Time.
  • 2. RenderDevice: SDL_GPU device and swapchain, the GLSL → SPIR-V build step, clear the screen, ImGui on imgui_impl_sdlgpu3. See Rendering.
  • 3. Renderer2D: sprite batch, text, debug overlay.
  • 4. SceneRenderer3D: glTF loading, instanced static meshes, camera, a ground-plane picking ray to a tile.
  • 5. Scenes and ECS: SceneStack, World, interpolated entities walking a hardcoded lane. See Scenes and ECS.
  • 6. Scripting spike: the same three test items in Lua/Luau and AngelScript, then pick one. See Scripting#Decision spike.
  • 7. Content loading: DefinitionDB, one tower and one enemy defined in script. This completes the vertical slice.
  • 8. Card-hand UI: input actions, tweens, drag and drop.
  • 9. Rigid animation: glTF node clips plus procedural aim and recoil. See Rigid-Part Animation.
  • 10. Polish: audio, hot reload, debug panels.