atelier/MANIFEST.md

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)