# Engineering Docs

These docs are plain Markdown for all contributors.

This project supports Pi documentation tooling for initialization,
validation, and generated indexes. If you edit generated sections,
run the docs tooling to refresh them.

## Structure

- **architecture.md** — System shape, component boundaries, data flow
- **dev-workflow.md** — Setup, env, commands, build/test/deploy steps
- **conventions.md** — Naming, style, patterns, coding rules
- **invariants.md** — Must-not-break rules
- **traps.md** — Known gotchas, pitfalls, and issues
- **decisions/** — Architectural decision records (ADRs)