Jon Chery
d1aa5daf2b
---ci--- project: atelier phase: 5 milestone: v0.2 status: complete requirements: covered: [ATELIER-36, ATELIER-37, ATELIER-38, ATELIER-39, ATELIER-40, ATELIER-41, ATELIER-42, ATELIER-43, ATELIER-44, ATELIER-45, ATELIER-46, ATELIER-47, ATELIER-48, ATELIER-49, ATELIER-50, ATELIER-51, ATELIER-52, ATELIER-53, ATELIER-54, ATELIER-55, ATELIER-56, ATELIER-57, ATELIER-58, ATELIER-59] partial: [] ---/ci---
56 lines
4.1 KiB
Markdown
56 lines
4.1 KiB
Markdown
# Domain Coverage
|
|
|
|
> Where each core principle applies across the domains. The complement to `principles-matrix.md`: the matrix maps domain → core; this maps core → domains.
|
|
|
|
## Core Principle Coverage
|
|
|
|
| Core Principle | Domains that derive from it | Count |
|
|
|----------------|---------------------------|-------|
|
|
| C1 Correctness | All 13 (v0.1: 11; v0.2: infrastructure-as-code, kubernetes) | Universal |
|
|
| C2 Clarity | v0.1: uiux, api, data, testing, observability, errors, documentation, devops; v0.2: infrastructure-as-code, kubernetes | 10 |
|
|
| C3 Simplicity | v0.1: security, data, testing, performance, documentation, concurrency, devops | 7 |
|
|
| C4 Locality | v0.1: testing, concurrency; v0.2: infrastructure-as-code, kubernetes | 4 |
|
|
| C5 Reversibility | v0.1: api, data, uiux, concurrency, devops; v0.2: infrastructure-as-code, kubernetes | 7 |
|
|
| C6 Composability | v0.1: api, security, observability, errors, documentation, concurrency; v0.2: infrastructure-as-code, kubernetes | 8 |
|
|
| C7 Observability | v0.1: api, data, testing, performance, observability, errors, devops; v0.2: infrastructure-as-code, kubernetes | 9 |
|
|
| C8 Economy | v0.1: security, testing, performance, observability, concurrency; v0.2: kubernetes | 6 |
|
|
|
|
## Interpretation
|
|
|
|
- **C1 Correctness** is universal — every domain derives from it. This confirms C1 as the floor.
|
|
- **C4 Locality** is the narrowest (2 domains: testing independence, concurrency boundaries). Locality is inherently domain-specific; not a gap.
|
|
- **C2 Clarity** and **C7 Observability** are the next-most-derived, confirming they are cross-cutting concerns.
|
|
- **C6 Composability** appears in 6 domains — it is most relevant where parts combine (api, errors, observability, documentation, concurrency) and least relevant where the unit is monolithic.
|
|
|
|
## Per-Domain Coverage
|
|
|
|
| Domain | C-rules derived from | Notes |
|
|
|--------|---------------------|-------|
|
|
| UI/UX | C1, C2, C3, C5, C7 | User-facing; clarity + reversibility |
|
|
| API | C1, C2, C3, C5, C6, C7 | Contracts; composability + stability |
|
|
| Security | C1, C3, C6, C7, C8 | 8/10 non-tradeable (promoted to C1) |
|
|
| Data | C1, C2, C3, C5, C7 | Truth + migration safety |
|
|
| Testing | C1, C2, C3, C4, C7, C8 | Independence (C4) is unique |
|
|
| Performance | C1, C3, C6, C7, C8 | Economy + measurement |
|
|
| Observability | C1, C2, C6, C7, C8 | Self-referential (P7 derives from C7) |
|
|
| Errors | C1, C2, C5, C6, C7 | Errors as data + reversibility |
|
|
| Documentation | C1, C2, C3, C5, C6 | Docs-as-code + living docs |
|
|
| Concurrency | C1, C3, C4, C5, C6, C7, C8 | Broadest derivation; locality (C4) unique |
|
|
| DevOps | C1, C2, C3, C5, C7 | Reproducibility + rollback |
|
|
| Infrastructure as Code | C1, C2, C3, C4, C5, C6, C7 | Declarative + state + composition; broadest derivation alongside Concurrency |
|
|
| Kubernetes | C1, C2, C4, C5, C6, C7, C8 | Declarative + reversibility + economy; broad derivation (7 C-rules) |
|
|
|
|
## v0.2 Domain Coverage (per IDEATE-03 schema)
|
|
|
|
| Domain | P-count | Derived-doc-count | Manifest-listed | Status |
|
|
|--------|---------|-------------------|-----------------|--------|
|
|
| Infrastructure as Code | 10 | 4 (terraform, opentofu, state, modules) | ✓ | complete |
|
|
| Kubernetes | 10 | 6 (workloads, networking, storage, rbac, helm, kustomize) | ✓ | complete |
|
|
|
|
## Gaps and Notes
|
|
|
|
- No domain derives from only one C-rule. The minimum is 4 (UI/UX: C1, C2, C3, C5, C7 — actually 5). Every domain is multi-rooted.
|
|
- **Concurrency**, **Infrastructure as Code**, and **Kubernetes** are tied for the broadest derivation (7 C-rules each) — these domains touch the most core concerns.
|
|
- **UI/UX** and **API** are the most user-facing; they emphasize C2 (Clarity) heavily.
|
|
- **Security** is the only domain with explicit non-tradeable declarations; this promotes 8 of its rules to C1-equivalent per `core/conflict-resolution.md` §6.
|
|
- **v0.2 expansion:** C4 (Locality) grew from 2 to 4 domains (added infrastructure-as-code state locality, kubernetes namespace blast-radius). C6 (Composability) grew from 6 to 8. The two new domains are broad-derivation domains (7 C-rules each), consistent with Concurrency's breadth. |