# 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 |
| GitOps + Operators | ✓           | argocd, flux, operators, progressive-delivery |
| AI / ML       | ✓                | data-versioning, model-evaluation, serving, monitoring-drift |
| i18n          | ✓                | locale-resources, formatting, rtl-bidi, testing-i18n |
| Compliance    | ✓                | audit-logs, data-retention, policy-as-code, evidence |

## Examples

> Examples are illustrative markdown with fenced code only (no standalone runtime artifacts per D-020 / D-025). The `examples/` directory listing closes the v0.2 ESC-002 drift (IDEATE-17, ATELIER-91). P5 authored the v0.3 examples and promoted all entries from `pending` to `✓` (verified — every listed file exists).

| Path | Status | Notes |
|------|--------|-------|
| `examples/good/` | ✓ | Good-example directory — 8 examples (v0.1 + v0.2 + v0.3) |
| `examples/bad/` | ✓ | Bad-example directory — 7 examples (v0.1 + v0.2 + v0.3) |
| `examples/good/api-endpoint.md` | ✓ | v0.1 example — good REST endpoint |
| `examples/good/react-component.md` | ✓ | v0.1 example — good React component |
| `examples/good/db-schema.md` | ✓ | v0.1 example — good DB schema |
| `examples/good/error-handler.md` | ✓ | v0.1 example — good error handler |
| `examples/bad/god-object.md` | ✓ | v0.1 example — bad god object |
| `examples/bad/silent-error.md` | ✓ | v0.1 example — bad silent error |
| `examples/bad/leaky-abstraction.md` | ✓ | v0.1 example — bad leaky abstraction |
| `examples/good/terraform-module.md` | ✓ | v0.2 example — good IaC module |
| `examples/good/k8s-deployment.md` | ✓ | v0.2 example — good k8s deployment |
| `examples/bad/terraform-unlocked-state.md` | ✓ | v0.2 example — bad unlocked state |
| `examples/bad/k8s-bare-pod-no-resources.md` | ✓ | v0.2 example — bad bare pod |
| `examples/good/gitops-pr.md` | ✓ | v0.3 example — good GitOps PR |
| `examples/good/ai-ml-reproducibility.md` | ✓ | v0.3 example — good reproducible training run |
| `examples/bad/i18n-string-concat.md` | ✓ | v0.3 example — bad i18n string concat |
| `examples/bad/compliance-audit-log.md` | ✓ | v0.3 example — bad audit log (P1 + P9 breaches) |

> **Note:** The `examples/` section was established in P4 with entries pre-listed as `pending P5`. P5 authored the 4 v0.3 examples and promoted all entries to `✓` after verifying every listed file exists on disk. The manifest remains authoritative — unlisted = not part of framework.

## Cross-Cutting

| Document                          | Purpose                          |
|-----------------------------------|----------------------------------|
| `matrix/principles-matrix.md`     | Maps domain → core principles (17 domains, 170 P-rules post-v0.3) |
| `matrix/domain-coverage.md`       | Maps core → domains; per-domain coverage (incl. v0.3 Core Principle Coverage) |
| `review/agent-checklist.md`       | Pre-completion agent checklist (incl. IaC + k8s + gitops + ai-ml + i18n + compliance triggers) |
| `review/peer-review-checklist.md` | Human peer-review checklist (incl. IaC + k8s + gitops + ai-ml + i18n + compliance sections) |
| `review/anti-patterns.md`         | Catalog of violations (incl. IaC + k8s + gitops + ai-ml + i18n + compliance + v0.3 chaos anti-patterns) |