# Knowledge base

Durable, current-state facts about this project, for anyone — human or agent —
who works on it. Read this folder before making changes.

How it differs from the other documents:

- **[DESIGN.md](../DESIGN.md)** is the *constitution*: what the game is and why.
  It is prescriptive. Code follows it, never the other way around.
- **`devlogs/` and `DEVLOG.md`** are *history*: what happened, in order. Never
  edited after the fact.
- **`knowledge/`** is *present tense*: how things actually work right now.
  When reality changes, these files are edited in place. A stale knowledge file
  is a bug — fix it in the same commit that made it stale.

## Contents

- [development-style.md](development-style.md) — the constitution rule and how
  to work here. Read this first.
- [tick.md](tick.md) — the project heartbeat: the session-opening audit every
  agent performs, and the defense rule for commits.
- [design-sessions.md](design-sessions.md) — the collaborative design
  workflow: how riffs become constitutional law, specs, and devlogs.
- [architecture.md](architecture.md) — crate layout, the sim/frontend split,
  and the invariants that protect it.
- [sim-mechanics.md](sim-mechanics.md) — the implemented game rules and tuning
  constants, with file pointers.
- [art-pipeline.md](art-pipeline.md) — Pixel Lab facts beyond what the skill
  covers, and how art flows into the Bevy frontend.
- [workflows.md](workflows.md) — build/test/run/verify commands, git
  conventions, and testing tricks that caught real bugs.