Jon Chery
9ebc9c8868
---ci--- project: atelier phase: 6 milestone: v0.3 status: complete requirements: covered: [ATELIER-60..91] partial: [] ---/ci---
78 lines
5.0 KiB
Markdown
78 lines
5.0 KiB
Markdown
# 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) | |