ronce-racine 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/AGENTS.md +90 -0
  2. package/LICENSE +21 -0
  3. package/README.md +281 -0
  4. package/agents/code-reviewer.md +33 -0
  5. package/agents/qa-tester.md +28 -0
  6. package/dist/hooks/README.md +182 -0
  7. package/dist/hooks/bash-npm-silent.mjs +81 -0
  8. package/dist/hooks/session-inject.mjs +53 -0
  9. package/dist/hooks/session-precompact.mjs +36 -0
  10. package/dist/hooks/session-writer.mjs +142 -0
  11. package/dist/hooks/skill-reminder.mjs +89 -0
  12. package/dist/hooks/truncate-bash-output.mjs +46 -0
  13. package/dist/hooks/truncate-output.mjs +88 -0
  14. package/dist/hooks/worktree-env-setup.mjs +123 -0
  15. package/dist/install.js +962 -0
  16. package/docs/adopting-a-repo.md +80 -0
  17. package/docs/architecture.md +76 -0
  18. package/docs/decisions.md +72 -0
  19. package/docs/developing.md +143 -0
  20. package/docs/evaluating-skills.md +41 -0
  21. package/docs/git-worktrees.md +62 -0
  22. package/docs/rules/clean-architecture-deps.md +66 -0
  23. package/docs/rules/commits.md +59 -0
  24. package/docs/rules/detection-gap-protocol.md +55 -0
  25. package/docs/rules/error-handling-discipline.md +62 -0
  26. package/docs/rules/minimal-code.md +58 -0
  27. package/docs/rules/no-raw-sql-interpolation.md +57 -0
  28. package/docs/rules/pre-commit-secret-detection.md +54 -0
  29. package/docs/rules/secure-logging.md +53 -0
  30. package/docs/rules/sql-migrations-discipline.md +58 -0
  31. package/docs/rules/subscription-cleanup.md +63 -0
  32. package/docs/rules/test-discipline.md +66 -0
  33. package/docs/rules/ui-states-complete.md +52 -0
  34. package/docs/templates/SKILL.template.md +66 -0
  35. package/docs/templates/rule.template.md +16 -0
  36. package/docs/writing-a-rule.md +43 -0
  37. package/docs/writing-a-skill.md +118 -0
  38. package/package.json +45 -0
  39. package/rules/clean-architecture-deps.md +20 -0
  40. package/rules/commits.md +16 -0
  41. package/rules/detection-gap-protocol.md +35 -0
  42. package/rules/error-handling-discipline.md +23 -0
  43. package/rules/minimal-code.md +32 -0
  44. package/rules/no-raw-sql-interpolation.md +20 -0
  45. package/rules/pre-commit-secret-detection.md +14 -0
  46. package/rules/secure-logging.md +16 -0
  47. package/rules/sql-migrations-discipline.md +18 -0
  48. package/rules/subscription-cleanup.md +22 -0
  49. package/rules/test-discipline.md +20 -0
  50. package/rules/ui-states-complete.md +23 -0
  51. package/scripts/subscription-leak-scan.ts +53 -0
  52. package/skills/adversarial-feature-challenge/README.md +65 -0
  53. package/skills/adversarial-feature-challenge/SKILL.md +96 -0
  54. package/skills/adversarial-feature-challenge/assets/fuzz-payloads.txt +60 -0
  55. package/skills/adversarial-feature-challenge/templates/challenge-report.md +42 -0
  56. package/skills/api-contract-versioning/README.md +62 -0
  57. package/skills/api-contract-versioning/SKILL.md +76 -0
  58. package/skills/api-contract-versioning/templates/consumer-inventory.md +29 -0
  59. package/skills/audit-architecture/README.md +56 -0
  60. package/skills/audit-architecture/SKILL.md +97 -0
  61. package/skills/audit-architecture/reference/ar-architecture.md +275 -0
  62. package/skills/audit-architecture/reference/di-disponibilite.md +252 -0
  63. package/skills/audit-architecture/reference/im-incidents.md +217 -0
  64. package/skills/audit-architecture/reference/pa-pannes.md +362 -0
  65. package/skills/audit-architecture/reference/re-recuperation.md +300 -0
  66. package/skills/audit-architecture/reference/sc-scalabilite.md +173 -0
  67. package/skills/audit-architecture/reference/su-support.md +180 -0
  68. package/skills/audit-ci-cd/README.md +54 -0
  69. package/skills/audit-ci-cd/SKILL.md +124 -0
  70. package/skills/audit-ci-cd/reference/artefacts.md +39 -0
  71. package/skills/audit-ci-cd/reference/deploiement.md +100 -0
  72. package/skills/audit-ci-cd/reference/dora.md +94 -0
  73. package/skills/audit-ci-cd/reference/iac.md +40 -0
  74. package/skills/audit-ci-cd/reference/pipeline-ci.md +36 -0
  75. package/skills/audit-ci-cd/reference/supply-chain.md +44 -0
  76. package/skills/audit-compliance/README.md +69 -0
  77. package/skills/audit-compliance/SKILL.md +176 -0
  78. package/skills/audit-compliance/reference/conformite-rgpd.md +295 -0
  79. package/skills/audit-compliance/reference/finops.md +318 -0
  80. package/skills/audit-compliance/reference/gouvernance-donnees.md +238 -0
  81. package/skills/audit-industrialisation/README.md +53 -0
  82. package/skills/audit-industrialisation/SKILL.md +251 -0
  83. package/skills/audit-observability/README.md +64 -0
  84. package/skills/audit-observability/SKILL.md +134 -0
  85. package/skills/audit-observability/reference/alerting.md +214 -0
  86. package/skills/audit-observability/reference/logging.md +114 -0
  87. package/skills/audit-observability/reference/metriques.md +166 -0
  88. package/skills/audit-observability/reference/traces-dashboards.md +90 -0
  89. package/skills/audit-performance-frontend/README.md +91 -0
  90. package/skills/audit-performance-frontend/SKILL.md +194 -0
  91. package/skills/audit-performance-frontend/reference/assets-cache-network.md +129 -0
  92. package/skills/audit-performance-frontend/reference/css-rendering-pipeline.md +154 -0
  93. package/skills/audit-performance-frontend/reference/html-critical-path.md +128 -0
  94. package/skills/audit-performance-frontend/reference/js-engine-runtime.md +280 -0
  95. package/skills/audit-performance-frontend/reference/memory-gc.md +126 -0
  96. package/skills/audit-performance-frontend/reference/profiling-tooling.md +98 -0
  97. package/skills/audit-quality/README.md +85 -0
  98. package/skills/audit-quality/SKILL.md +126 -0
  99. package/skills/audit-quality/reference/qa-devops.md +539 -0
  100. package/skills/audit-quality/reference/qu-qualite-donnees.md +402 -0
  101. package/skills/audit-report/README.md +72 -0
  102. package/skills/audit-report/SKILL.md +241 -0
  103. package/skills/audit-report/reference/scoring-model.md +45 -0
  104. package/skills/audit-security/README.md +72 -0
  105. package/skills/audit-security/SKILL.md +140 -0
  106. package/skills/audit-security/reference/auth-identite.md +98 -0
  107. package/skills/audit-security/reference/autorisation.md +66 -0
  108. package/skills/audit-security/reference/chiffrement-tls.md +97 -0
  109. package/skills/audit-security/reference/detection-patching.md +67 -0
  110. package/skills/audit-security/reference/incident-response.md +98 -0
  111. package/skills/audit-security/reference/reseau-conteneurs.md +72 -0
  112. package/skills/audit-security/reference/secrets.md +36 -0
  113. package/skills/audit-testing/README.md +82 -0
  114. package/skills/audit-testing/SKILL.md +131 -0
  115. package/skills/audit-testing/reference/golden-dataset.md +65 -0
  116. package/skills/audit-testing/reference/resilience-chaos.md +93 -0
  117. package/skills/audit-testing/reference/tests-contractuels.md +65 -0
  118. package/skills/audit-testing/reference/tests-e2e-flaky.md +67 -0
  119. package/skills/audit-testing/reference/tests-unit-integ-ci.md +125 -0
  120. package/skills/bug-ticket-root-cause/README.md +67 -0
  121. package/skills/bug-ticket-root-cause/SKILL.md +86 -0
  122. package/skills/bug-ticket-root-cause/templates/bug-ticket.md +43 -0
  123. package/skills/bug-triage-structured/README.md +63 -0
  124. package/skills/bug-triage-structured/SKILL.md +104 -0
  125. package/skills/bug-triage-structured/templates/bug-triage.md +38 -0
  126. package/skills/ci-pipeline-orchestration/README.md +55 -0
  127. package/skills/ci-pipeline-orchestration/SKILL.md +110 -0
  128. package/skills/commit-readiness-review/README.md +66 -0
  129. package/skills/commit-readiness-review/SKILL.md +82 -0
  130. package/skills/commit-readiness-review/scripts/precommit-scan.ts +81 -0
  131. package/skills/comprehensive-test-strategy/README.md +64 -0
  132. package/skills/comprehensive-test-strategy/SKILL.md +108 -0
  133. package/skills/comprehensive-test-strategy/reference/testing-advanced.md +85 -0
  134. package/skills/daily-workflow-optimization/README.md +56 -0
  135. package/skills/daily-workflow-optimization/SKILL.md +80 -0
  136. package/skills/database-schema-evolution/README.md +54 -0
  137. package/skills/database-schema-evolution/SKILL.md +107 -0
  138. package/skills/ddd-backend-implementation/README.md +63 -0
  139. package/skills/ddd-backend-implementation/SKILL.md +95 -0
  140. package/skills/design-system-component-lifecycle/README.md +56 -0
  141. package/skills/design-system-component-lifecycle/SKILL.md +97 -0
  142. package/skills/design-system-component-lifecycle/templates/component-contract.md +43 -0
  143. package/skills/detection-sweep/README.md +58 -0
  144. package/skills/detection-sweep/SKILL.md +93 -0
  145. package/skills/detection-sweep/scripts/sweep.ts +80 -0
  146. package/skills/domain-modeling-design/README.md +57 -0
  147. package/skills/domain-modeling-design/SKILL.md +83 -0
  148. package/skills/frontend-fullstack-implementation/README.md +60 -0
  149. package/skills/frontend-fullstack-implementation/SKILL.md +133 -0
  150. package/skills/frontend-spec-call-site-audit/README.md +66 -0
  151. package/skills/frontend-spec-call-site-audit/SKILL.md +82 -0
  152. package/skills/frontend-spec-call-site-audit/scripts/audit-entry-points.ts +79 -0
  153. package/skills/frontend-spec-call-site-audit/templates/ticket-frontend.md +32 -0
  154. package/skills/merge-request-review/README.md +60 -0
  155. package/skills/merge-request-review/SKILL.md +77 -0
  156. package/skills/merge-request-review/templates/mr-review-report.md +29 -0
  157. package/skills/production-incident-diagnostic/README.md +63 -0
  158. package/skills/production-incident-diagnostic/SKILL.md +103 -0
  159. package/skills/production-incident-diagnostic/templates/incident-report.md +33 -0
  160. package/skills/qa-session-intake/README.md +56 -0
  161. package/skills/qa-session-intake/SKILL.md +78 -0
  162. package/skills/recording-decisions/README.md +91 -0
  163. package/skills/recording-decisions/SKILL.md +84 -0
  164. package/skills/recurring-bug-root-cause/README.md +64 -0
  165. package/skills/recurring-bug-root-cause/SKILL.md +93 -0
  166. package/skills/recurring-bug-root-cause/scripts/detect-recurring-fixes.ts +46 -0
  167. package/skills/recurring-bug-root-cause/templates/postmortem-recidive.md +37 -0
  168. package/skills/refactoring-shared-component-api/README.md +50 -0
  169. package/skills/refactoring-shared-component-api/SKILL.md +84 -0
  170. package/skills/refactoring-shared-component-api/scripts/sweep-call-sites.ts +85 -0
  171. package/skills/refactoring-shared-component-api/templates/migration-checklist.md +19 -0
  172. package/skills/validating-features-end-to-end/README.md +50 -0
  173. package/skills/validating-features-end-to-end/SKILL.md +90 -0
  174. package/skills/visual-regression-check/README.md +51 -0
  175. package/skills/visual-regression-check/SKILL.md +89 -0
  176. package/skills/writing-robust-tests/README.md +53 -0
  177. package/skills/writing-robust-tests/SKILL.md +88 -0
  178. package/templates/.adopted.example +8 -0
  179. package/templates/anti-drift.gitlab-ci.yml +23 -0
@@ -0,0 +1,275 @@
1
+ # Section AR - Architecture, Specification & Deployment (11 questions)
2
+
3
+ ## Questions
4
+
5
+ - AR-01 - Architecture decision documentation (SHOULD)
6
+ - AR-01a - Architecture decision process (SHOULD)
7
+ - AR-02 - Technical debt traceability (SHOULD)
8
+ - AR-03 - Multi-level architecture documentation (SHOULD)
9
+ - AR-04 - Blue/Green or Canary (SHOULD)
10
+ - AR-04a - Canary promotion criteria (COULD)
11
+ - AR-05 - Feature toggles / Feature flags (SHOULD)
12
+ - AR-06 - Automated rollback on failure (MUST)
13
+ - AR-07 - Backward compatibility (SHOULD)
14
+ - AR-08 - Documented progressive deprecation (SHOULD)
15
+ - AR-09 - Semantic versioning (SHOULD)
16
+
17
+ ---
18
+
19
+ ### AR-01 - Architecture decision documentation · Criticality: **SHOULD**
20
+
21
+ **Analyze:** `docs/adr/`, `doc/architecture/` folders, `*.adr.md` files, architecture README
22
+
23
+ **Verification commands:**
24
+ ```bash
25
+ find . -path "*/adr/*" -o -name "*.adr.md" 2>/dev/null
26
+ find docs/ -name "*.md" 2>/dev/null | head -10
27
+ grep -ri "architecture decision\|ADR" . --include="*.md" 2>/dev/null | head -5
28
+ ```
29
+
30
+ **Check:** ADRs present and up to date, structured format (context, decision, consequences), traceable history, link to the code
31
+
32
+ **Levels:**
33
+ | Level | Criteria |
34
+ |-------|----------|
35
+ | 0 | No documentation. Decisions in the architects' heads. |
36
+ | 1 | A few archived emails/Slack messages. Hard to find. |
37
+ | 2 | Wiki with the main decisions. No standard format. |
38
+ | 3 | Systematic ADRs. Context, options, decision, consequences. |
39
+ | 4 | ADRs versioned with the code. Linked to PRs. Searchable. Architecture fitness functions. |
40
+
41
+ ---
42
+
43
+ ### AR-01a - Architecture decision process · Criticality: **SHOULD**
44
+
45
+ **Condition:** Evaluate if AR-01 >= 2
46
+
47
+ **Analyze:** RFC process, architecture review board, trade-off analysis documentation
48
+
49
+ **Verification commands:**
50
+ ```bash
51
+ grep -ri "RFC\|request for comments\|architecture review" . --include="*.md" 2>/dev/null | head -5
52
+ find . -name "*.rfc.*" -o -name "*proposal*" 2>/dev/null | head -5
53
+ ```
54
+
55
+ **Check:** Formalized decision process (RFC), type 1/type 2 decision distinction, documented trade-off analysis
56
+
57
+ **Levels:**
58
+ | Level | Criteria |
59
+ |-------|----------|
60
+ | 0 | Ad-hoc decisions by whoever. |
61
+ | 1 | Decisions made by seniors. No formal process. |
62
+ | 2 | RFC for major decisions. |
63
+ | 3 | Architecture review board. Documented decision criteria. Trade-off analysis. |
64
+ | 4 | Lightweight architecture governance. Automated compliance checks. Evolutionary architecture. |
65
+
66
+ ---
67
+
68
+ ### AR-02 - Technical debt traceability · Criticality: **SHOULD**
69
+
70
+ **Analyze:** TODO/FIXME in the code, debt backlog, SonarQube, debt metrics
71
+
72
+ **Verification commands:**
73
+ ```bash
74
+ grep -rn "TODO\|FIXME\|HACK\|TECH.DEBT" . --include="*.ts" --include="*.js" --include="*.php" --include="*.py" 2>/dev/null | wc -l
75
+ grep -ri "sonarqube\|codeclimate\|technical.debt" . --include="*.yml" --include="*.yaml" --include="*.json" 2>/dev/null | head -5
76
+ ```
77
+
78
+ **Check:** Technical debt backlog, prioritization, dedicated budget (20% of the sprint), automated detection
79
+
80
+ **Levels:**
81
+ | Level | Criteria |
82
+ |-------|----------|
83
+ | 0 | No tracking. Debt invisible until the incident. |
84
+ | 1 | TODO/FIXME in the code. No consolidated view. |
85
+ | 2 | Technical debt backlog. Occasional prioritization. |
86
+ | 3 | Debt categorized and scored. Dedicated budget (20% of the sprint). Reduction metrics. |
87
+ | 4 | Automated debt detection (SonarQube). Technical debt ratio tracked. Data-driven investment decisions. |
88
+
89
+ ---
90
+
91
+ ### AR-03 - Multi-level architecture documentation · Criticality: **SHOULD**
92
+
93
+ **Analyze:** C4 diagrams, Structurizr, Mermaid, architecture documentation
94
+
95
+ **Verification commands:**
96
+ ```bash
97
+ find . -name "*.puml" -o -name "*.mmd" -o -name "*.structurizr" -o -name "*c4*" 2>/dev/null
98
+ grep -ri "c4 model\|context diagram\|container diagram" . --include="*.md" 2>/dev/null | head -5
99
+ ```
100
+
101
+ **Check:** C1 (Context) and C2 (Container) levels documented, diagrams up to date, living documentation
102
+
103
+ **Levels:**
104
+ | Level | Criteria |
105
+ |-------|----------|
106
+ | 0 | No architecture documentation. |
107
+ | 1 | A global diagram. Often stale. |
108
+ | 2 | C4 model or equivalent. Context and Container levels documented. |
109
+ | 3 | Complete documentation (Context, Container, Component). Generated from the code where possible. |
110
+ | 4 | Living documentation. Auto-updated from code. Interactive diagrams. Architecture as code. |
111
+
112
+ ---
113
+
114
+ ### AR-04 - Blue/Green or Canary · Criticality: **SHOULD**
115
+
116
+ **Analyze:** Deployment strategy, Kubernetes configs, Argo Rollouts, feature flags
117
+
118
+ **Verification commands:**
119
+ ```bash
120
+ grep -ri "blue.green\|canary\|rolling.update\|progressive.delivery" . --include="*.yml" --include="*.yaml" --include="*.tf" 2>/dev/null | head -5
121
+ grep -ri "argo.rollout\|flagger\|feature.flag" . 2>/dev/null | head -5
122
+ ```
123
+
124
+ **Check:** Progressive deployment strategy, fast rollback, feature flags
125
+
126
+ **Levels:**
127
+ | Level | Criteria |
128
+ |-------|----------|
129
+ | 0 | Direct deploy to prod. Big bang. Downtime accepted. |
130
+ | 1 | Basic rolling update. No fast rollback. |
131
+ | 2 | Blue/Green with manual switch. Post-deploy smoke tests. |
132
+ | 3 | Progressive canary deployment (1%, 10%, 50%, 100%). Health metrics. Auto-rollback. |
133
+ | 4 | Progressive delivery. Feature flags + canary. Traffic mirroring. Integrated A/B testing. |
134
+
135
+ ---
136
+
137
+ ### AR-04a - Canary promotion criteria · Criticality: **COULD**
138
+
139
+ **Condition:** Evaluate if AR-04 >= 2
140
+
141
+ **Analyze:** Promotion metrics, analysis templates, SLO-based promotion
142
+
143
+ **Verification commands:**
144
+ ```bash
145
+ grep -ri "analysis.template\|promotion\|canary.metric" . --include="*.yml" --include="*.yaml" 2>/dev/null | head -5
146
+ ```
147
+
148
+ **Check:** Objective promotion criteria, statistical significance, multi-metric analysis
149
+
150
+ **Levels:**
151
+ | Level | Criteria |
152
+ |-------|----------|
153
+ | 0 | Manual decision based on gut feeling. |
154
+ | 1 | Waiting a fixed delay with no visible error. |
155
+ | 2 | Basic metrics (error rate, latency) compared to the baseline. |
156
+ | 3 | SLO compliance automatically checked. Statistical significance. |
157
+ | 4 | ML-based promotion. Multi-metric analysis. Automated experimentation platform. |
158
+
159
+ ---
160
+
161
+ ### AR-05 - Feature toggles / Feature flags · Criticality: **SHOULD**
162
+
163
+ **Analyze:** LaunchDarkly, Unleash, config flags, kill switches
164
+
165
+ **Verification commands:**
166
+ ```bash
167
+ grep -ri "feature.flag\|feature.toggle\|launchdarkly\|unleash\|flipt" . --include="*.ts" --include="*.js" --include="*.php" --include="*.py" --include="*.yml" 2>/dev/null | head -10
168
+ grep -ri "isEnabled\|isFeatureOn\|flag_enabled" . --include="*.ts" --include="*.js" --include="*.php" 2>/dev/null | head -5
169
+ ```
170
+
171
+ **Check:** Feature flag system, kill switches, targeting by segment, flag hygiene
172
+
173
+ **Levels:**
174
+ | Level | Criteria |
175
+ |-------|----------|
176
+ | 0 | No feature flags. Code deployed = feature active. |
177
+ | 1 | Flags via config files. Restart required to change. |
178
+ | 2 | Feature flag system (LaunchDarkly, Unleash). Toggle without redeployment. |
179
+ | 3 | Flags per user/segment. A/B testing possible. Audit of active flags. |
180
+ | 4 | Feature management platform. Kill switches. Stale flag detection. Flag-as-code. |
181
+
182
+ ---
183
+
184
+ ### AR-06 - Automated rollback on failure · Criticality: **MUST**
185
+
186
+ **Analyze:** Rollback mechanisms, health-based rollback, blue/green, database rollback
187
+
188
+ **Verification commands:**
189
+ ```bash
190
+ grep -ri "rollback\|auto.rollback\|health.check.*rollback" . --include="*.yml" --include="*.yaml" --include="*.tf" 2>/dev/null | head -5
191
+ grep -ri "expand.contract\|migration.*rollback" . --include="*.md" 2>/dev/null | head -5
192
+ ```
193
+
194
+ **Check:** Metric-driven automated rollback, instant rollback via blue/green, database rollback strategy
195
+
196
+ **Levels:**
197
+ | Level | Criteria |
198
+ |-------|----------|
199
+ | 0 | No rollback. Fix forward only. |
200
+ | 1 | Manual rollback possible but untested. Stressful. |
201
+ | 2 | Scripted rollback. Tested in staging. < 15 min in prod. |
202
+ | 3 | Auto-rollback on health metrics. Tested monthly. < 5 min. |
203
+ | 4 | Instant rollback via blue/green. Zero-downtime. Automated testing of rollback. Database migration rollback. |
204
+
205
+ ---
206
+
207
+ ### AR-07 - Backward compatibility · Criticality: **SHOULD**
208
+
209
+ **Analyze:** Contract testing, schema evolution, API versioning, expand-contract
210
+
211
+ **Verification commands:**
212
+ ```bash
213
+ grep -ri "pact\|contract.test\|backward.compat\|breaking.change" . --include="*.ts" --include="*.js" --include="*.php" --include="*.yml" 2>/dev/null | head -5
214
+ ls **/openapi* **/swagger* 2>/dev/null
215
+ grep -ri "v1\|v2\|api.version\|deprecat" . --include="*.ts" --include="*.php" --include="*.yml" 2>/dev/null | head -5
216
+ ```
217
+
218
+ **Check:** Backward compatibility policy, contract tests, API versioning strategy, deprecation warnings
219
+
220
+ **Levels:**
221
+ | Level | Criteria |
222
+ |-------|----------|
223
+ | 0 | Frequent breaking changes. No compatibility guarantee. |
224
+ | 1 | "Best effort" compatibility. Breaking changes documented after the fact. |
225
+ | 2 | Defined compatibility policy. Breaking changes announced in advance. |
226
+ | 3 | Backward compatibility by design. Contract tests. Deprecation warnings. |
227
+ | 4 | API versioning strategy. Compatibility matrix. Automated breaking change detection. |
228
+
229
+ ---
230
+
231
+ ### AR-08 - Documented progressive deprecation · Criticality: **SHOULD**
232
+
233
+ **Analyze:** Sunset headers, deprecation policy, usage analytics, migration guides
234
+
235
+ **Verification commands:**
236
+ ```bash
237
+ grep -ri "deprecated\|sunset\|end.of.life\|migration.guide" . --include="*.ts" --include="*.php" --include="*.md" 2>/dev/null | head -5
238
+ ```
239
+
240
+ **Check:** Formal deprecation policy, sunset headers (RFC 8594), usage analytics, migration guides
241
+
242
+ **Levels:**
243
+ | Level | Criteria |
244
+ |-------|----------|
245
+ | 0 | Features removed without notice. |
246
+ | 1 | Ad-hoc communication to impacted customers. |
247
+ | 2 | Deprecation policy (e.g. 6-month warning). Documented. |
248
+ | 3 | Deprecation warnings in API responses. Migration guides. Transition support. |
249
+ | 4 | Automated deprecation tracking. Usage analytics for timing. Customer communication automation. |
250
+
251
+ ---
252
+
253
+ ### AR-09 - Semantic versioning · Criticality: **SHOULD**
254
+
255
+ **Analyze:** SemVer, conventional commits, changelog, release automation
256
+
257
+ **Verification commands:**
258
+ ```bash
259
+ grep -ri "semantic.release\|conventional.commit\|semver\|changelog" . --include="*.json" --include="*.yml" --include="*.yaml" 2>/dev/null | head -5
260
+ cat package.json 2>/dev/null | grep version
261
+ cat CHANGELOG.md 2>/dev/null | head -20
262
+ ```
263
+
264
+ **Check:** SemVer applied, conventional commits, automated changelog, breaking change detection
265
+
266
+ **Levels:**
267
+ | Level | Criteria |
268
+ |-------|----------|
269
+ | 0 | No versioning or arbitrary versions. |
270
+ | 1 | Numeric versions but no clear semantics. |
271
+ | 2 | SemVer applied. MAJOR.MINOR.PATCH. Changelog. |
272
+ | 3 | Strict SemVer. Automated version bump. Breaking change detection. |
273
+ | 4 | CalVer or SemVer depending on context. Release train. Automated release notes. Automated dependency updates. |
274
+
275
+ ---
@@ -0,0 +1,252 @@
1
+ # Section DI - Availability & SLA (9 questions)
2
+
3
+ ## Questions
4
+
5
+ - DI-01 - RPO definition (Recovery Point Objective) (MUST)
6
+ - DI-02 - RTO definition (Recovery Time Objective) (MUST)
7
+ - DI-03 - Target availability (99.5%, 99.9%) (MUST)
8
+ - DI-03a - Cost of the availability level (COULD)
9
+ - DI-04 - Qualifying critical SLOs + error budget (MUST)
10
+ - DI-04a - Error budget usage (SHOULD)
11
+ - DI-05 - SLI dashboard (SHOULD)
12
+ - DI-06 - Alerts on breaches / SLO overruns (MUST)
13
+ - DI-07 - Automated export of actual SLAs (SHOULD)
14
+ - DI-08 - Shared dashboard (status page) (SHOULD)
15
+ - DI-09 - External verification (synthetic monitoring) (SHOULD)
16
+
17
+ ---
18
+
19
+ ### DI-01 - RPO definition (Recovery Point Objective) · Criticality: **MUST**
20
+
21
+ **Analyze:** RPO per data class, continuous backup, synchronous replication, tiered RPO
22
+
23
+ **Verification commands:**
24
+ ```bash
25
+ grep -ri "rpo\|recovery.point\|data.loss.*accept" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
26
+ grep -ri "continuous.backup\|wal.*shipping\|binlog.*replication\|synchronous.*replication" . --include="*.yml" --include="*.tf" 2>/dev/null | head -5
27
+ ```
28
+
29
+ **Check:** RPO defined per data class, backup/replication aligned, tested
30
+
31
+ **Levels:**
32
+ | Level | Criteria |
33
+ |-------|----------|
34
+ | 0 | RPO not defined. Unknown acceptable data loss. |
35
+ | 1 | Implicit RPO = last backup (often 24h). |
36
+ | 2 | RPO defined but not by data criticality. |
37
+ | 3 | RPO per data class. Backup/replication aligned. Tested. |
38
+ | 4 | RPO = 0 for critical data. Synchronous replication. Validated continuously. |
39
+
40
+ ---
41
+
42
+ ### DI-02 - RTO definition (Recovery Time Objective) · Criticality: **MUST**
43
+
44
+ **Analyze:** Auto-failover, multi-region deployment, runbooks, DR drills
45
+
46
+ **Verification commands:**
47
+ ```bash
48
+ grep -ri "rto\|recovery.time\|failover\|multi.az\|multi.region" . --include="*.md" --include="*.yml" --include="*.tf" 2>/dev/null | head -5
49
+ ```
50
+
51
+ **Check:** RTO per criticality, auto-failover, DR drills validating the RTO
52
+
53
+ **Levels:**
54
+ | Level | Criteria |
55
+ |-------|----------|
56
+ | 0 | RTO not defined. Recovery "when it's ready". |
57
+ | 1 | Implicit RTO based on past experience. |
58
+ | 2 | RTO defined globally. Not tested regularly. |
59
+ | 3 | RTO per service criticality. Tested quarterly. SLA aligned. |
60
+ | 4 | Aggressive RTO (<15min) with auto-failover. Tested monthly. Compliance tracked. |
61
+
62
+ ---
63
+
64
+ ### DI-03 - Target availability (99.5%, 99.9%) · Criticality: **MUST**
65
+
66
+ **Analyze:** Contractual SLA, error budgets, multi-9s architecture, availability zones
67
+
68
+ **Verification commands:**
69
+ ```bash
70
+ grep -ri "sla\|99\.\|availability\|uptime\|error.budget" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
71
+ grep -ri "multi.az\|availability.zone\|active.active\|active.passive" . --include="*.yml" --include="*.tf" 2>/dev/null | head -5
72
+ ```
73
+
74
+ **Check:** Target defined (99.x%), automatic measurement, contractual SLA, error budgets
75
+
76
+ **Levels:**
77
+ | Level | Criteria |
78
+ |-------|----------|
79
+ | 0 | No availability objective defined. |
80
+ | 1 | Informal objective ("we aim for the max"). |
81
+ | 2 | Target defined (e.g. 99.5%). No systematic measurement. |
82
+ | 3 | Contractual SLA with penalties. Automatic measurement. Monthly review. |
83
+ | 4 | Multi-9s with a suitable architecture. Error budgets. Continuous SLA compliance. |
84
+
85
+ ---
86
+
87
+ ### DI-03a - Cost of the availability level · Criticality: **COULD**
88
+
89
+ **Condition:** Evaluate if DI-03 >= 2
90
+
91
+ **Analyze:** TCO analysis, risk quantification, cost-benefit, right-sizing
92
+
93
+ **Levels:**
94
+ | Level | Criteria |
95
+ |-------|----------|
96
+ | 0 | Not evaluated. |
97
+ | 1 | Rough estimate. |
98
+ | 2 | TCO per availability level. Trade-offs documented. |
99
+ | 3 | ROI analysis. Cost-benefit per additional 9. |
100
+ | 4 | Dynamic cost optimization. Right-sizing availability per service. |
101
+
102
+ ---
103
+
104
+ ### DI-04 - Qualifying critical SLOs + error budget · Criticality: **MUST**
105
+
106
+ **Analyze:** SLIs, SLOs, error budget policies, burn rate alerting
107
+
108
+ **Verification commands:**
109
+ ```bash
110
+ grep -ri "slo\|sli\|error.budget\|burn.rate\|service.level" . --include="*.yml" --include="*.yaml" --include="*.md" --include="*.ts" 2>/dev/null | head -10
111
+ ```
112
+
113
+ **Check:** SLOs defined with measurable SLIs, error budgets, impact on releases
114
+
115
+ **Levels:**
116
+ | Level | Criteria |
117
+ |-------|----------|
118
+ | 0 | No SLO defined. No notion of error budget. |
119
+ | 1 | Informal SLO ("we want it to work"). |
120
+ | 2 | SLOs defined for critical services. No formalized error budget. |
121
+ | 3 | SLOs with error budgets. Alerts when the budget is consumed. Impact on releases. |
122
+ | 4 | SLO-driven development. Error budget policies. Automated release gates. |
123
+
124
+ ---
125
+
126
+ ### DI-04a - Error budget usage · Criticality: **SHOULD**
127
+
128
+ **Condition:** Evaluate if DI-04 >= 3
129
+
130
+ **Analyze:** Release freeze, velocity adjustment, error budget alerts, blameless post-mortems
131
+
132
+ **Levels:**
133
+ | Level | Criteria |
134
+ |-------|----------|
135
+ | 0 | Error budget ignored. |
136
+ | 1 | Tracked but no automatic action. |
137
+ | 2 | Release freeze if the budget is exhausted. |
138
+ | 3 | Reliability vs features focus based on the budget. Weekly review. |
139
+ | 4 | Automated velocity adjustment. Risk-based deployment decisions. |
140
+
141
+ ---
142
+
143
+ ### DI-05 - SLI dashboard · Criticality: **SHOULD**
144
+
145
+ **Analyze:** Grafana, Datadog, real-time dashboards, drill-down, executive summaries
146
+
147
+ **Verification commands:**
148
+ ```bash
149
+ grep -ri "grafana\|datadog\|dashboard\|prometheus" . --include="*.yml" --include="*.yaml" --include="*.tf" 2>/dev/null | head -10
150
+ find . -name "*dashboard*" -o -name "*grafana*" 2>/dev/null | head -5
151
+ ```
152
+
153
+ **Check:** Centralized dashboard, real-time, drill-down per service, executive views
154
+
155
+ **Levels:**
156
+ | Level | Criteria |
157
+ |-------|----------|
158
+ | 0 | No SLI dashboard. |
159
+ | 1 | Metrics scattered across different tools. |
160
+ | 2 | Centralized dashboard with the main SLIs. Manual refresh. |
161
+ | 3 | Real-time dashboard with history. Drill-down per service. Accessible to all. |
162
+ | 4 | Executive + detailed views. Predictive SLI. Correlation with incidents. |
163
+
164
+ ---
165
+
166
+ ### DI-06 - Alerts on breaches / SLO overruns · Criticality: **MUST**
167
+
168
+ **Analyze:** Multi-window alerting, burn rate alerts, alert correlation, escalation policies
169
+
170
+ **Verification commands:**
171
+ ```bash
172
+ grep -ri "alert\|burn.rate\|escalat\|pagerduty\|opsgenie" . --include="*.yml" --include="*.yaml" --include="*.tf" 2>/dev/null | head -10
173
+ ```
174
+
175
+ **Check:** SLO-based alerts (not just infra), burn rate alerts, escalation policies
176
+
177
+ **Levels:**
178
+ | Level | Criteria |
179
+ |-------|----------|
180
+ | 0 | No SLO alerts. Discovered through customer complaints. |
181
+ | 1 | Basic alerts on infra metrics (CPU, memory). |
182
+ | 2 | Alerts on the main SLIs. Fixed thresholds. |
183
+ | 3 | Multi-window alerting. Burn rate alerts. Actionable notifications. |
184
+ | 4 | Predictive alerting. Alert correlation. Automated initial response. |
185
+
186
+ ---
187
+
188
+ ### DI-07 - Automated export of actual SLAs · Criticality: **SHOULD**
189
+
190
+ **Analyze:** Automated SLA reporting, audit trail, customer-facing reports, compliance dashboards
191
+
192
+ **Verification commands:**
193
+ ```bash
194
+ grep -ri "sla.*report\|uptime.*report\|availability.*report" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
195
+ ```
196
+
197
+ **Check:** Automated SLA reporting pipeline, auditability, customer reports
198
+
199
+ **Levels:**
200
+ | Level | Criteria |
201
+ |-------|----------|
202
+ | 0 | No automated SLA measurement. |
203
+ | 1 | Manual calculation from logs/incidents. |
204
+ | 2 | SLA calculation script. Manual monthly run. |
205
+ | 3 | Automated SLA reporting pipeline. History retained. Auditable. |
206
+ | 4 | Real-time SLA calculation. Customer-facing reports. Contractual compliance proof. |
207
+
208
+ ---
209
+
210
+ ### DI-08 - Shared dashboard (status page) · Criticality: **SHOULD**
211
+
212
+ **Analyze:** Statuspage.io, Cachet, Instatus, incident communication, maintenance windows
213
+
214
+ **Verification commands:**
215
+ ```bash
216
+ grep -ri "statuspage\|cachet\|instatus\|status.page" . --include="*.yml" --include="*.yaml" --include="*.md" --include="*.tf" 2>/dev/null | head -5
217
+ ```
218
+
219
+ **Check:** Public status page, incident communication, planned maintenance, uptime history
220
+
221
+ **Levels:**
222
+ | Level | Criteria |
223
+ |-------|----------|
224
+ | 0 | No sharing with customers. |
225
+ | 1 | Reports sent on request. |
226
+ | 2 | Basic status page (up/down). |
227
+ | 3 | Detailed status page with history. Documented incidents. Planned maintenance. |
228
+ | 4 | Customer portal with a personalized SLA dashboard. Metrics access API. |
229
+
230
+ ---
231
+
232
+ ### DI-09 - External verification (synthetic monitoring) · Criticality: **SHOULD**
233
+
234
+ **Analyze:** Pingdom, Datadog Synthetics, Checkly, RUM, third-party validation
235
+
236
+ **Verification commands:**
237
+ ```bash
238
+ grep -ri "synthetic\|pingdom\|uptime.robot\|checkly\|datadog.*synthetic\|rum\|real.user.monitor" . --include="*.yml" --include="*.yaml" --include="*.ts" --include="*.tf" 2>/dev/null | head -5
239
+ ```
240
+
241
+ **Check:** Multi-region synthetic checks, user journey simulation, RUM + synthetic, third-party validation
242
+
243
+ **Levels:**
244
+ | Level | Criteria |
245
+ |-------|----------|
246
+ | 0 | No external monitoring. |
247
+ | 1 | Basic ping from an external point. |
248
+ | 2 | Multi-region synthetic checks. Latency metrics. Alerts. |
249
+ | 3 | Simulated user journeys. RUM + synthetic combined. SLA evidence. |
250
+ | 4 | Global synthetic monitoring. Third-party SLA verification. Competitive benchmarking. |
251
+
252
+ ---