# {{REPO_NAME}}

> One paragraph: what this repo **is** — the product/service and who it's for. (Write fresh — D35: do
> not carry a legacy README over verbatim; write the current product map.)

## What's here

(One bullet per top-level dir/module: what it is, in one line — a map, not a tour.)

## Who runs it

(Owner/operator — who runs this day to day.) Access follows the MMI Future three-level model: read for
org members, developer as GitHub `write`, project-admin as `write` plus train-branch allowlist. Authority
detail → [Hub architecture](https://github.com/mutmutco/MMI-Hub/blob/main/architecture.md);
access runbook → [repo-access](https://github.com/mutmutco/MMI-Hub/blob/development/docs/Guides/repo-access.md).

## Agent context

Read this section at the start of agent work in this repo.

- **Structure search:** Use available code search tools. Verify results against cited source before acting.
- **Durable WHY:** `docs/decisions/` — one file per decision, prose only for what was chosen and
  rejected; never a description of current state. Do not maintain living current-state under `docs/`.
- **Current state:** code + live CLI (`mmi-cli oracle org project get`, `board`, `status`,
  `org schedules`, …) — registry facts, resolved live. Optional generated `docs/index.md` is a
  **routing** index only (`mmi-cli oracle docs index --check`), not product truth.
- **GitHub wikis are retired org-wide** — this repo does not publish to a `.wiki.git`; do not create one.
- **Stack:** (languages, frameworks, major services)
- **Run locally:** (install, dev server, `/stage` if non-obvious)
- **Verify before done:** (exact commands — test, lint, typecheck, repo gate script)
- **Architecture:** deep build/deploy shape → `architecture.md`
- **Gotchas:** (ports, env from vault not files, Windows/shell quirks specific to this repo)

## Start

(The one human-readable command/steps to get this running locally.)