# Guidance

Read only what the current task needs. Entry: [README.md](../README.md). Bans and order: [AGENTS.md](../AGENTS.md).

| Need | Read |
| ---- | ---- |
| What ships / acceptance | [requirements.md](requirements.md) |
| Roadmap horizons | [ROADMAP.md](../ROADMAP.md) |
| External reference pointers | [references.md](references.md) |
| Install, toggles, commands, samples | [README.md](../README.md) |
| Startup, load order, config | [architecture.md](architecture.md) |
| Footer, `/mode`, TUI behavior | [DESIGN.md](../DESIGN.md) |
| Theme colors | [themes/monokai.json](../themes/monokai.json) |
| Tests and verification | [testing.md](testing.md) |
| Repository tree | [directory.md](directory.md) |
| Stack pins and CI | [tech.md](tech.md) |
| Lint/format gates | [pattern.md](pattern.md) |
| Security: trust, secrets | [security.md](security.md) |
| Release, diagnostics | [maintenance.md](maintenance.md) |
| Known pitfalls | [problems.md](problems.md) |
| Bundles: classification, recommendations, omp support | [bundles.md](bundles.md) |
| Change flow: W-model plan, test, verify, docs sync | [maintenance.md](maintenance.md#change-flow); agents run it via [skills/pioneer](../skills/pioneer/SKILL.md) |
| AI coaching, self-coaching | [skills/comfortzone/SKILL.md](../skills/comfortzone/SKILL.md) |