# Atelier — Document Manifest

> Authoritative index. If a document is not listed here, it is not
> part of the framework.

## Reading Order

1. `core/first-principles.md`              — Required first
2. `core/conflict-resolution.md`           — Required
3. `domains/<relevant>/first-principles.md`— Per task
4. `domains/<relevant>/<topic>.md`         — As needed
5. `matrix/principles-matrix.md`           — Reference

## Core

| Document                                | Status   | Audience |
|-----------------------------------------|----------|----------|
| `core/first-principles.md`              | Stable   | All      |
| `core/conflict-resolution.md`           | Stable   | All      |
| `core/reading-order.md`                 | Stable   | All      |

## Domains

| Domain        | First Principles | Derived Documents                |
|---------------|------------------|----------------------------------|
| UI / UX       | ✓                | components, accessibility, tokens, copywriting |
| API Design    | ✓                | rest, graphql, versioning, error-responses, pagination |
| Security      | ✓                | authentication, authorization, input-validation, secrets, supply-chain |
| Data          | ✓                | schema-design, migrations, indexing |
| Testing       | ✓                | pyramid, fixtures |
| Performance   | ✓                | frontend, backend |
| Observability | ✓                | logging, metrics, tracing |
| Errors        | ✓                | patterns |
| Documentation | ✓                | doc-templates |
| Concurrency   | ✓                | patterns |
| DevOps        | ✓                | ci-cd, environments |
| Infrastructure as Code | ✓      | terraform, opentofu, state, modules |
| Kubernetes    | ✓                | workloads, networking, storage, rbac, helm, kustomize |

## Cross-Cutting

| Document                          | Purpose                          |
|-----------------------------------|----------------------------------|
| `matrix/principles-matrix.md`     | Maps domain → core principles (13 domains, 130 P-rules post-v0.2) |
| `matrix/domain-coverage.md`       | Maps core → domains; per-domain coverage |
| `review/agent-checklist.md`       | Pre-completion agent checklist (incl. IaC + k8s triggers) |
| `review/peer-review-checklist.md` | Human peer-review checklist (incl. IaC + k8s sections) |
| `review/anti-patterns.md`         | Catalog of violations (incl. IaC + k8s + chaos anti-patterns) |