Flat index of active project context. Durable knowledge must live in this tree, not behind archive links.
| Area | Path | Purpose |
|---|---|---|
| Workflow | workflow.md | Repo workflow, TDD protocol, and verification commands |
| Flow | flows.md | Active Flow registry |
| Patterns | patterns.md | Living architecture, code, test, and operations patterns |
| Knowledge Index | knowledge/index.md | Component guides index |
| Architecture Guide | knowledge/guides/architecture.md | App architecture, source directories, and DI boundaries |
| Database Guide | knowledge/guides/oracle-database.md | Oracle 26ai, SQLSpec queries, HNSW, vector memory, and container lifecycle |
| Agent Guide | knowledge/guides/adk-agent-patterns.md | ADK Workflow, tools, session bridge, RAG grounding, and streaming |
| Store & Maps Guide | knowledge/guides/store-inventory-maps.md | Nearest-store (Haversine), stock queries, coordinate privacy, and Google Maps |
| UI & Frontend Guide | knowledge/guides/frontend-ui.md | Jinja/HTMX templates, Vite static resources, and client JS widgets |
| Testing Guide | knowledge/guides/testing-verification.md | pytest AnyIO conftest, mock boundaries, parallel worker safety, and manual checks |
| Ops & Packaging Guide | knowledge/guides/operations-packaging.md | PyApp onefile, distroless Docker builds, Release CI, and Sphinx docs settings |
| Settings Guide | knowledge/guides/settings.md | Dataclass settings structure, environment parsing, and clean settings rule |
| Code Style | code-styleguides/general.md | General style guide |
| Code Style | code-styleguides/python.md | Python style guide |
| Code Style | code-styleguides/bash.md | Shell style guide |
| Code Style | code-styleguides/html-css.md | HTML/CSS style guide |
| Code Style | code-styleguides/typescript.md | TypeScript style guide |
| Skill | skills/flow-memory-keeper/SKILL.md | Project-local Flow memory keeper |
| Beads | beads.json | Beads task database |
| Active Spec | specs/apex-ops-console/prd.md | Active APEX operations console plan |
| Active Spec | specs/apex-ops-app/spec.md | Active APEX console app implementation plan (Active) |
| Active Spec | specs/apex-demo-verification-docs/spec.md | Active APEX verification and docs plan |
| Active Spec | specs/vhs-demo-recordings_20260429/prd.md | VHS demo recording plan |