# docs/README.md (Documentation Root)

Truth document. Use for: the entry point for all documentation in a repo. Created during baseline audit.

**Link only what exists.** Every row below is a placeholder — drop any whose target the repo does not have. Most `history/` and `architecture/` folders are created on first use, so linking them unconditionally ships a docs index with dead links on day one. An index is a browse page: a link that resolves to nothing is worse than an absent row.

```
# {Project Name} Documentation

Technical documentation for {project description}.

> For documentation organization, authority map, and folder rules, see **[structure.md](structure.md)**.

---

## Quick Links

| Document                          | Description                          |
| --------------------------------- | ------------------------------------ |
| [Structure](structure.md)         | Documentation entry point and rules  |
| [Setup](operations/setup.md)      | Installation and configuration guide |

---

## Architecture

System design, steering docs, and standing decisions — the truth layer.

- [system-design.md](architecture/system-design.md) - System overview: subsystems and key flows
- [domain-model.md](architecture/domain-model.md) - Entities, relationships, state ownership
- [glossary.md](architecture/glossary.md) - Project vocabulary
- [non-goals.md](architecture/non-goals.md) - What this system deliberately does not do
- [decisions/](architecture/decisions/Readme.md) - Architecture Decisions (ADs)
{list other architecture docs — api.md, security.md — when present}

---

## Features

Living reference docs for implemented features (how things currently work).

- [feature-name.md](features/feature-name.md) - Feature description
{list all feature docs}

---

## Operations

How to run, develop, and deploy.

- [setup.md](operations/setup.md) - Installation and configuration guide
{list all operations docs — environment.md when present}

---

## History

The records — everything dated, frozen, or append-only.

- [CHANGELOG.md](history/CHANGELOG.md) - Master changelog index
- [changelog/](history/changelog/) - Individual changelog entries
- [plans/](history/plans/) - Implementation plans (frozen at completion)
- [migrations/](history/migrations/) - One-shot migration runbooks (frozen once executed)
- [research/](history/research/) - Deep-research artifacts (one folder per topic)
- [backlog.md](history/backlog.md) - Tracked work items and technical debt

---

## Contributing

See [CLAUDE.md](../CLAUDE.md) for documentation guidelines.
```