# docs/

## If you're Mischa

**Doing something operational?** → [`guides/`](guides/)
- [Posting a journal entry](guides/posting.md)
- [Managing GPX files](guides/gpx-manager.md)
- [Switching to a new trip](guides/trip-switching.md)
- [Rebuilding local dev from scratch](guides/local-setup.md)

**Checking project status?** → [`working/`](working/) — [what's in there + the plan status convention](working/README.md)
- [Backlog](working/backlog.md)
- [Bugs and fixes](working/bugs-and-fixes.md)
- [QA results](working/qa/results.md)

**Design or architecture decisions?** → [`reference/`](reference/)
- [Design system](reference/design-system.md)
- [Architecture overview](reference/architecture.md) — the site as it actually is
- [Superseded decisions](reference/superseded-decisions.md) — what was planned, then reversed, and why
- [Testing](reference/testing.md)

> Documents under [`working/`](working/) are historical records. If one describes something that no
> longer exists, [`reference/superseded-decisions.md`](reference/superseded-decisions.md) says what
> replaced it.

---

## If you're Claude

**Always-loaded project rules** → [`CLAUDE.md`](../CLAUDE.md) (repo root)

**Active specs and plans** → [`working/specs/`](working/specs/) and [`working/plans/`](working/plans/)

**Stable facts** → [`reference/`](reference/)

**Raw research input** → [`research/`](research/)