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,300 @@
1
+ # Section RE - Recovery after a problem (13 questions)
2
+
3
+ ## Questions
4
+
5
+ - RE-01 - Qualifying idempotent / non-idempotent endpoints (MUST)
6
+ - RE-01a - Idempotency key mechanism (MUST)
7
+ - RE-01b - Replay tests and validation (SHOULD)
8
+ - RE-02 - Data rollback / recovery strategy (MUST)
9
+ - RE-02a - Rollback granularity (SHOULD)
10
+ - RE-03 - Recovery plan documentation (SHOULD)
11
+ - RE-05 - Define RTO (Recovery Time Objective) (MUST)
12
+ - RE-05a - Measured RTO vs target RTO (SHOULD)
13
+ - RE-05b - RPO (Recovery Point Objective) (MUST)
14
+ - RE-06 - Regular controlled restart tests (SHOULD)
15
+ - RE-06a - Scope of recovery tests (SHOULD)
16
+ - RE-08 - Full recovery validation (MUST)
17
+ - RE-08a - Data reconciliation tools (SHOULD)
18
+
19
+ ---
20
+
21
+ ### RE-01 - Qualifying idempotent / non-idempotent endpoints · Criticality: **MUST**
22
+
23
+ **Analyze:** Idempotency keys, conditional requests (ETags), exactly-once semantics, outbox pattern
24
+
25
+ **Verification commands:**
26
+ ```bash
27
+ grep -ri "idempoten\|idempotency.key\|if.match\|etag\|exactly.once" . --include="*.ts" --include="*.js" --include="*.php" 2>/dev/null | head -10
28
+ grep -ri "outbox\|transactional.outbox" . --include="*.ts" --include="*.php" --include="*.yml" 2>/dev/null | head -5
29
+ ```
30
+
31
+ **Check:** List of endpoints with their nature (idempotent/non-idempotent), idempotency key for sensitive operations
32
+
33
+ **Levels:**
34
+ | Level | Criteria |
35
+ |-------|----------|
36
+ | 0 | No notion of idempotency. Risk of double-processing not identified. |
37
+ | 1 | Aware of the problem but no list. A few endpoints marked "safe to retry". |
38
+ | 2 | List of critical endpoints with their nature. Not systematic. |
39
+ | 3 | All endpoints documented. Idempotency key pattern implemented for non-idempotent ones. |
40
+ | 4 | Idempotency by design. Automated replay tests. Metrics of duplicates detected. |
41
+
42
+ ---
43
+
44
+ ### RE-01a - Idempotency key mechanism · Criticality: **MUST**
45
+
46
+ **Condition:** Evaluate if RE-01 >= 2
47
+
48
+ **Analyze:** Key storage (Redis/DB), TTL, handling of in-flight requests
49
+
50
+ **Verification commands:**
51
+ ```bash
52
+ grep -ri "idempotency.key\|idempotent.*header\|replay.*detect" . --include="*.ts" --include="*.js" --include="*.php" 2>/dev/null | head -5
53
+ ```
54
+
55
+ **Check:** Persistent storage, configurable TTL, handling of concurrent requests
56
+
57
+ **Levels:**
58
+ | Level | Criteria |
59
+ |-------|----------|
60
+ | 0 | No mechanism. Retry = duplicate risk. |
61
+ | 1 | Duplicate detection based on timestamp/hash. Not 100% reliable. |
62
+ | 2 | Idempotency key in the header. Configurable TTL. In-memory storage. |
63
+ | 3 | Idempotency key with persistent storage (Redis/DB). Cached response returned on replay. |
64
+ | 4 | Distributed idempotency with consensus. Exactly-once semantics proven. Chaos tests. |
65
+
66
+ ---
67
+
68
+ ### RE-01b - Replay tests and validation · Criticality: **SHOULD**
69
+
70
+ **Condition:** Evaluate if RE-01 >= 3
71
+
72
+ **Analyze:** Automated replay tests, assertions on state, CI/CD integration
73
+
74
+ **Verification commands:**
75
+ ```bash
76
+ grep -ri "replay.*test\|idempoten.*test\|duplicate.*test" . --include="*.test.*" --include="*.spec.*" 2>/dev/null | head -5
77
+ ```
78
+
79
+ **Check:** Automated replay tests, assertions on post-replay state, chaos testing
80
+
81
+ **Levels:**
82
+ | Level | Criteria |
83
+ |-------|----------|
84
+ | 0 | No replay tests. |
85
+ | 1 | Occasional manual tests. |
86
+ | 2 | Automated tests for critical endpoints. |
87
+ | 3 | Complete test suite with state assertions. CI/CD integrated. |
88
+ | 4 | Chaos testing in production with validation. Reliability metrics. |
89
+
90
+ ---
91
+
92
+ ### RE-02 - Data rollback / recovery strategy · Criticality: **MUST**
93
+
94
+ **Analyze:** Checkpoints, automatable rollback, transactional outbox, saga pattern
95
+
96
+ **Verification commands:**
97
+ ```bash
98
+ grep -ri "rollback\|checkpoint\|saga\|compensat\|outbox" . --include="*.ts" --include="*.js" --include="*.php" 2>/dev/null | head -10
99
+ ```
100
+
101
+ **Check:** Formalized strategy with checkpoints, automatable rollback, quarterly tests
102
+
103
+ **Levels:**
104
+ | Level | Criteria |
105
+ |-------|----------|
106
+ | 0 | No strategy. Data loss accepted or ignored. |
107
+ | 1 | Ad-hoc manual rollback. Depends on the experts available. |
108
+ | 2 | Documented procedure for common cases. Not tested regularly. |
109
+ | 3 | Formalized strategy with checkpoints. Automatable rollback. Quarterly tests. |
110
+ | 4 | Transactional outbox pattern. Saga pattern for distributed operations. Automatic recovery. |
111
+
112
+ ---
113
+
114
+ ### RE-02a - Rollback granularity · Criticality: **SHOULD**
115
+
116
+ **Condition:** Evaluate if RE-02 >= 2
117
+
118
+ **Analyze:** Granularity (global, batch, transaction, record), point-in-time recovery
119
+
120
+ **Verification commands:**
121
+ ```bash
122
+ grep -ri "point.in.time\|granular.*rollback\|partial.*rollback" . --include="*.md" --include="*.ts" --include="*.php" 2>/dev/null | head -5
123
+ ```
124
+
125
+ **Check:** Rollback per business transaction, per-record compensation, point-in-time recovery
126
+
127
+ **Levels:**
128
+ | Level | Criteria |
129
+ |-------|----------|
130
+ | 0 | Global rollback only (all or nothing). |
131
+ | 1 | Rollback per batch/job. |
132
+ | 2 | Rollback per business transaction. |
133
+ | 3 | Rollback per record with compensation. |
134
+ | 4 | Partial rollback with guaranteed consistent state. Point-in-time recovery. |
135
+
136
+ ---
137
+
138
+ ### RE-03 - Recovery plan documentation · Criticality: **SHOULD**
139
+
140
+ **Analyze:** Runbooks, support escalation, versioned documentation, training
141
+
142
+ **Verification commands:**
143
+ ```bash
144
+ find docs/ -name "*recovery*" -o -name "*reprise*" -o -name "*disaster*" -o -name "*dr-*" 2>/dev/null
145
+ grep -ri "disaster.recovery\|plan.de.reprise\|DRP\|BCP" . --include="*.md" 2>/dev/null | head -5
146
+ ```
147
+
148
+ **Check:** Detailed runbooks, documented escalation, versioned documentation, regular training
149
+
150
+ **Levels:**
151
+ | Level | Criteria |
152
+ |-------|----------|
153
+ | 0 | No documentation. Tribal knowledge. |
154
+ | 1 | Informal notes. Known to a few experts. |
155
+ | 2 | Basic documentation in a wiki. Not always up to date. |
156
+ | 3 | Detailed runbooks with escalation. Reviewed twice a year. Accessible 24/7. |
157
+ | 4 | Documentation as code. Versioned. Tested automatically. Regular training. |
158
+
159
+ ---
160
+
161
+ ### RE-05 - Define RTO (Recovery Time Objective) · Criticality: **MUST**
162
+
163
+ **Analyze:** RTO by service criticality, contractual SLA, regular measurement
164
+
165
+ **Verification commands:**
166
+ ```bash
167
+ grep -ri "rto\|recovery.time\|time.to.recover" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
168
+ ```
169
+
170
+ **Check:** RTO defined by criticality, contractual SLA, measured and reported
171
+
172
+ **Levels:**
173
+ | Level | Criteria |
174
+ |-------|----------|
175
+ | 0 | No RTO defined. "We come back up when it's ready." |
176
+ | 1 | Implicit RTO based on experience. Not contracted. |
177
+ | 2 | RTO defined globally (e.g. 4h). Not by service criticality. |
178
+ | 3 | RTO per criticality level. Contractual SLA. Measured and reported. |
179
+ | 4 | Aggressive RTO (<15min) with auto-recovery. Objective tested monthly. |
180
+
181
+ ---
182
+
183
+ ### RE-05a - Measured RTO vs target RTO · Criticality: **SHOULD**
184
+
185
+ **Condition:** Evaluate if RE-05 >= 2
186
+
187
+ **Analyze:** Measurement during drills, documented gap, corrective actions
188
+
189
+ **Levels:**
190
+ | Level | Criteria |
191
+ |-------|----------|
192
+ | 0 | RTO never measured. |
193
+ | 1 | Measured during real incidents. Often exceeded. |
194
+ | 2 | Measured in an annual drill. Gap documented. |
195
+ | 3 | Measured quarterly. Actions if the gap is >20%. |
196
+ | 4 | Measured continuously. Auto-recovery validated. 99%+ compliance. |
197
+
198
+ ---
199
+
200
+ ### RE-05b - RPO (Recovery Point Objective) · Criticality: **MUST**
201
+
202
+ **Condition:** Evaluate if RE-05 >= 3
203
+
204
+ **Analyze:** RPO by data criticality, synchronous replication, tailored backup
205
+
206
+ **Verification commands:**
207
+ ```bash
208
+ grep -ri "rpo\|recovery.point\|data.loss\|replication.*synchron" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
209
+ ```
210
+
211
+ **Check:** RPO defined by criticality, tailored replication, aligned backup
212
+
213
+ **Levels:**
214
+ | Level | Criteria |
215
+ |-------|----------|
216
+ | 0 | RPO not defined. |
217
+ | 1 | RPO = last backup (potentially 24h of loss). |
218
+ | 2 | RPO defined by criticality. Tailored backup. |
219
+ | 3 | RPO <1h for critical data. Synchronous replication. |
220
+ | 4 | RPO = 0 for critical data. Multi-site active-active. |
221
+
222
+ ---
223
+
224
+ ### RE-06 - Regular controlled restart tests · Criticality: **SHOULD**
225
+
226
+ **Analyze:** DR drills, game days, chaos engineering, measured RTO
227
+
228
+ **Verification commands:**
229
+ ```bash
230
+ grep -ri "dr.drill\|game.day\|restart.test\|recovery.test" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
231
+ ```
232
+
233
+ **Check:** Regular drills, prod-like environment, metrics collected
234
+
235
+ **Levels:**
236
+ | Level | Criteria |
237
+ |-------|----------|
238
+ | 0 | Never tested. First test = a real incident. |
239
+ | 1 | Tested at initial go-live. Not since. |
240
+ | 2 | Annual drill. Non-prod environment. |
241
+ | 3 | Quarterly drill on a prod-like environment. Metrics collected. |
242
+ | 4 | Continuous chaos engineering. Regular game days. Continuous improvement. |
243
+
244
+ ---
245
+
246
+ ### RE-06a - Scope of recovery tests · Criticality: **SHOULD**
247
+
248
+ **Condition:** Evaluate if RE-06 >= 2
249
+
250
+ **Analyze:** Scenarios tested (DB crash, network), business validation, multi-region DR
251
+
252
+ **Levels:**
253
+ | Level | Criteria |
254
+ |-------|----------|
255
+ | 0 | Simple restart test. |
256
+ | 1 | Test with baseline data. No business validation. |
257
+ | 2 | Test with incident scenarios (DB crash, network). Partial validation. |
258
+ | 3 | Full tests including failover, rollback, data integrity. Validation checklist. |
259
+ | 4 | End-to-end tests with clients. Multi-region DR. Automatic validation. |
260
+
261
+ ---
262
+
263
+ ### RE-08 - Full recovery validation · Criticality: **MUST**
264
+
265
+ **Analyze:** Validation scripts, before/after comparison, audit trail, reconciliation
266
+
267
+ **Verification commands:**
268
+ ```bash
269
+ grep -ri "reconcili\|validation.*recovery\|data.integrity\|checksum" . --include="*.ts" --include="*.php" --include="*.sh" 2>/dev/null | head -5
270
+ ```
271
+
272
+ **Check:** Post-recovery validation scripts, before/after comparison, alerts on discrepancy
273
+
274
+ **Levels:**
275
+ | Level | Criteria |
276
+ |-------|----------|
277
+ | 0 | No validation. Hoping everything is OK. |
278
+ | 1 | Manual spot-check validation. Not systematic. |
279
+ | 2 | Post-recovery validation checklist. Manual controls. |
280
+ | 3 | Automatic validation scripts. Before/after comparison. Alerts on discrepancy. |
281
+ | 4 | Continuous validation with reconciliation. Full audit trail. Recovery certification. |
282
+
283
+ ---
284
+
285
+ ### RE-08a - Data reconciliation tools · Criticality: **SHOULD**
286
+
287
+ **Condition:** Evaluate if RE-08 >= 2
288
+
289
+ **Analyze:** Comparison scripts, checksums, data quality tools
290
+
291
+ **Levels:**
292
+ | Level | Criteria |
293
+ |-------|----------|
294
+ | 0 | No tool. Visual check. |
295
+ | 1 | Manual SQL queries. Count comparison. |
296
+ | 2 | Comparison scripts. Checksums on critical tables. |
297
+ | 3 | Reconciliation tool with a detailed report. Automatic diff. |
298
+ | 4 | Data quality platform. Continuous validation. Automatic correction where possible. |
299
+
300
+ ---
@@ -0,0 +1,173 @@
1
+ # Section SC - Technical scalability (7 questions)
2
+
3
+ ## Questions
4
+
5
+ - SC-01 - Capacity Planning (SHOULD)
6
+ - SC-02 - Regular load testing (SHOULD)
7
+ - SC-03 - Auto-scaling (horizontal/vertical) (SHOULD)
8
+ - SC-04 - Queues/brokers to smooth peaks (SHOULD)
9
+ - SC-05 - QoS and processing prioritization (SHOULD)
10
+ - SC-06 - Partitioning by client or task (COULD)
11
+ - SC-07 - Specialized workers (Split API / ETL) (SHOULD)
12
+
13
+ ---
14
+
15
+ ### SC-01 - Capacity Planning · Criticality: **SHOULD**
16
+
17
+ **Analyze:** Load models, bottleneck analysis, growth forecasts, cost models
18
+
19
+ **Verification commands:**
20
+ ```bash
21
+ grep -ri "capacity\|bottleneck\|load.model\|throughput" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
22
+ grep -ri "k6\|gatling\|jmeter\|locust" . 2>/dev/null | head -5
23
+ ```
24
+
25
+ **Check:** Known system limits, load tests, growth projections, cost per transaction
26
+
27
+ **Levels:**
28
+ | Level | Criteria |
29
+ |-------|----------|
30
+ | 0 | No idea of the system's limits. Bottlenecks discovered in production. |
31
+ | 1 | Rough estimates based on intuition. No measured data. |
32
+ | 2 | Capacity metrics for critical components. Occasional load tests. No forecast. |
33
+ | 3 | Documented capacity model. Quarterly load tests. Alerts when nearing limits. |
34
+ | 4 | Automated capacity planning with prediction. Growth modeling. Cost optimization built in. |
35
+
36
+ ---
37
+
38
+ ### SC-02 - Regular load testing · Criticality: **SHOULD**
39
+
40
+ **Analyze:** k6/Gatling/JMeter scripts, CI load testing, soak tests, spike tests
41
+
42
+ **Verification commands:**
43
+ ```bash
44
+ find . -name "*.k6.*" -o -name "*gatling*" -o -name "*jmeter*" -o -name "*locust*" 2>/dev/null
45
+ grep -ri "load.test\|stress.test\|spike.test\|soak.test" . --include="*.yml" --include="*.yaml" --include="*.ts" --include="*.js" 2>/dev/null | head -5
46
+ ```
47
+
48
+ **Check:** Test suite (load, stress, spike, soak), prod-like environment, baseline, CI integration
49
+
50
+ **Levels:**
51
+ | Level | Criteria |
52
+ |-------|----------|
53
+ | 0 | No load testing. Production = test environment. |
54
+ | 1 | Manual tests before a major release. No baseline. Non-representative environment. |
55
+ | 2 | Automated tests (k6, Gatling) in CI. Basic scenarios. Comparison against baseline. |
56
+ | 3 | Full suite (load, stress, spike, soak). Prod-like environment. Detailed analysis of the results. |
57
+ | 4 | Integrated chaos engineering. Testing in production (canary load). Performance budgets enforced. |
58
+
59
+ ---
60
+
61
+ ### SC-03 - Auto-scaling (horizontal/vertical) · Criticality: **SHOULD**
62
+
63
+ **Analyze:** HPA, KEDA, auto-scaling groups, metrics-based scaling, scale-to-zero
64
+
65
+ **Verification commands:**
66
+ ```bash
67
+ grep -ri "hpa\|autoscal\|replicas\|keda\|scale.to.zero" . --include="*.yml" --include="*.yaml" --include="*.tf" 2>/dev/null | head -5
68
+ ls kubernetes/ helm/ k8s/ 2>/dev/null
69
+ ```
70
+
71
+ **Check:** Auto-scaling configured, custom metrics, predictive scaling, scale-to-zero
72
+
73
+ **Levels:**
74
+ | Level | Criteria |
75
+ |-------|----------|
76
+ | 0 | Manual scaling only. Reaction after saturation. |
77
+ | 1 | Manual scaling with a documented procedure. Long reaction time. |
78
+ | 2 | Auto-scaling configured on basic metrics (CPU). No scale-to-zero. Costs not optimized. |
79
+ | 3 | Auto-scaling on custom metrics (queue depth, latency). Documented policies. Cost alerts. |
80
+ | 4 | Predictive scaling based on patterns. Spot instances. FinOps built in. Scale-to-zero where relevant. |
81
+
82
+ ---
83
+
84
+ ### SC-04 - Queues/brokers to smooth peaks · Criticality: **SHOULD**
85
+
86
+ **Analyze:** RabbitMQ, Kafka, SQS, NATS, DLQ, back-pressure
87
+
88
+ **Verification commands:**
89
+ ```bash
90
+ grep -ri "rabbitmq\|kafka\|sqs\|nats\|amqp\|redis.*queue\|bullmq\|bull" . --include="*.yml" --include="*.yaml" --include="*.ts" --include="*.js" --include="*.php" --include="*.env*" 2>/dev/null | head -10
91
+ grep -ri "dead.letter\|dlq\|back.pressure" . 2>/dev/null | head -5
92
+ ```
93
+
94
+ **Check:** Message broker configured, DLQ, back-pressure handling, exactly-once processing
95
+
96
+ **Levels:**
97
+ | Level | Criteria |
98
+ |-------|----------|
99
+ | 0 | Everything synchronous. Load peaks = immediate saturation. |
100
+ | 1 | Ad-hoc queue for a few jobs. No monitoring. Risk of message loss. |
101
+ | 2 | Message broker (RabbitMQ, Kafka) for async workflows. DLQ configured. Basic monitoring. |
102
+ | 3 | Event-driven architecture for non-critical operations. Back-pressure handling. Retry policies. |
103
+ | 4 | CQRS/Event Sourcing where relevant. Exactly-once processing. Lag metrics with alerts. |
104
+
105
+ ---
106
+
107
+ ### SC-05 - QoS and processing prioritization · Criticality: **SHOULD**
108
+
109
+ **Analyze:** Priority queues, rate limiting, fair scheduling, preemption
110
+
111
+ **Verification commands:**
112
+ ```bash
113
+ grep -ri "rate.limit\|throttl\|priority\|qos\|quota" . --include="*.ts" --include="*.js" --include="*.php" --include="*.yml" 2>/dev/null | head -10
114
+ grep -ri "PriorityClass\|ResourceQuota" . --include="*.yml" --include="*.yaml" 2>/dev/null | head -5
115
+ ```
116
+
117
+ **Check:** Priority queues, rate limiting per tenant/API, fair scheduling, preemption for critical work
118
+
119
+ **Levels:**
120
+ | Level | Criteria |
121
+ |-------|----------|
122
+ | 0 | Everything processed the same. One big batch blocks the small requests. |
123
+ | 1 | Manually created separate queues. No dynamic priority. |
124
+ | 2 | Priority queues configured. Differentiated timeouts. No per-client throttling. |
125
+ | 3 | Rate limiting per tenant/API. Fair scheduling. Wait-time metrics per priority. |
126
+ | 4 | Adaptive QoS based on SLOs. Intelligent traffic shaping. Preemption for critical work. |
127
+
128
+ ---
129
+
130
+ ### SC-06 - Partitioning by client or task · Criticality: **COULD**
131
+
132
+ **Analyze:** Sharding, tenant isolation, cell-based architecture, geographic sharding
133
+
134
+ **Verification commands:**
135
+ ```bash
136
+ grep -ri "shard\|tenant.id\|multi.tenant\|partition\|cell.based" . --include="*.ts" --include="*.js" --include="*.php" --include="*.yml" 2>/dev/null | head -10
137
+ ```
138
+
139
+ **Check:** Tenant isolation, resource quotas, sharding strategy, limited blast radius
140
+
141
+ **Levels:**
142
+ | Level | Criteria |
143
+ |-------|----------|
144
+ | 0 | No partitioning. Frequent noisy neighbor problem. |
145
+ | 1 | Logical isolation (namespace) with no resource guarantee. |
146
+ | 2 | Resource quotas per tenant. No physical sharding. |
147
+ | 3 | Sharding per tenant for large clients. Dedicated resources for VIPs. Monitoring per shard. |
148
+ | 4 | Complete multi-tenant isolation. Cell-based architecture. Limited blast radius. Multi-region compliance. |
149
+
150
+ ---
151
+
152
+ ### SC-07 - Specialized workers (Split API / ETL) · Criticality: **SHOULD**
153
+
154
+ **Analyze:** API/workers/batch separation, read replicas, CQRS, async processing
155
+
156
+ **Verification commands:**
157
+ ```bash
158
+ grep -ri "worker\|sidekiq\|celery\|bull\|queue.*process\|cron\|schedule" . --include="*.yml" --include="*.yaml" --include="*.ts" --include="*.php" 2>/dev/null | head -10
159
+ grep -ri "read.replica\|cqrs\|async.*process" . 2>/dev/null | head -5
160
+ ```
161
+
162
+ **Check:** Dedicated workers per task type, resource isolation, read replicas for ETL, independent scaling
163
+
164
+ **Levels:**
165
+ | Level | Criteria |
166
+ |-------|----------|
167
+ | 0 | Single monolith. ETL and API share the same resources. |
168
+ | 1 | Logical separation (dedicated threads). No real isolation. |
169
+ | 2 | Separate services but same infra. Possible contention on DB/network. |
170
+ | 3 | Dedicated workers with independent scaling. Separate queues. Distinct metrics. |
171
+ | 4 | Fully decoupled architecture. Read replicas for ETL. Zero API impact during batch. |
172
+
173
+ ---
@@ -0,0 +1,180 @@
1
+ # Section SU - Support & Operability (8 questions)
2
+
3
+ ## Questions
4
+
5
+ - SU-01 - Runbooks available (SHOULD)
6
+ - SU-01a - Runbook maintenance (SHOULD)
7
+ - SU-02 - Clear escalation (level 1, 2, 3) (SHOULD)
8
+ - SU-03 - RACI defined (SHOULD)
9
+ - SU-04 - Install & startup scripts (SHOULD)
10
+ - SU-04a - Dev environment setup time (SHOULD)
11
+ - SU-05 - Automated onboarding (sandbox) (COULD)
12
+ - SU-05a - Measuring onboarding effectiveness (COULD)
13
+
14
+ ---
15
+
16
+ ### SU-01 - Runbooks available · Criticality: **SHOULD**
17
+
18
+ **Analyze:** `docs/runbooks/`, `docs/ops/` folders, operational wiki, runbook automation
19
+
20
+ **Verification commands:**
21
+ ```bash
22
+ find docs/ -name "*runbook*" -o -name "*ops*" -o -name "*deploy*" -o -name "*playbook*" 2>/dev/null
23
+ grep -ri "runbook\|playbook\|operational.procedure" . --include="*.md" 2>/dev/null | head -5
24
+ ```
25
+
26
+ **Check:** Structured runbooks, decision trees, auto-remediation, runbooks as code
27
+
28
+ **Levels:**
29
+ | Level | Criteria |
30
+ |-------|----------|
31
+ | 0 | No runbooks. Resolution depends on individual expertise. |
32
+ | 1 | Informal notes in a wiki. Not structured. |
33
+ | 2 | Runbooks for frequent incidents. Standardized format. Partially up to date. |
34
+ | 3 | Complete runbooks with decision trees. Tested. Versioned. Quarterly review. |
35
+ | 4 | Runbooks as code. Auto-remediation integrated. Resolution-time metrics. Continuous improvement. |
36
+
37
+ ---
38
+
39
+ ### SU-01a - Runbook maintenance · Criticality: **SHOULD**
40
+
41
+ **Condition:** Evaluate if SU-01 >= 2
42
+
43
+ **Analyze:** Post-mortem feedback, runbook testing, drift detection, ownership
44
+
45
+ **Levels:**
46
+ | Level | Criteria |
47
+ |-------|----------|
48
+ | 0 | No maintenance. Stale runbooks. |
49
+ | 1 | Updated when someone spots an error. |
50
+ | 2 | Scheduled annual review. Owner identified. |
51
+ | 3 | Mandatory update after each incident. Post-mortem feedback loop. |
52
+ | 4 | Runbooks tested automatically. Drift detection. Gamification for contributions. |
53
+
54
+ ---
55
+
56
+ ### SU-02 - Clear escalation (level 1, 2, 3) · Criticality: **SHOULD**
57
+
58
+ **Analyze:** L1/L2/L3 tiering, SLA per level, smart routing, on-call rotation
59
+
60
+ **Verification commands:**
61
+ ```bash
62
+ find docs/ -name "*incident*" -o -name "*escalad*" -o -name "*on-call*" -o -name "*astreinte*" 2>/dev/null
63
+ grep -ri "escalat\|on.call\|pagerduty\|opsgenie\|L1\|L2\|L3" . --include="*.md" --include="*.yml" 2>/dev/null | head -5
64
+ ```
65
+
66
+ **Check:** Documented escalation process, SLA per level, automatic alerts, on-call rotation
67
+
68
+ **Levels:**
69
+ | Level | Criteria |
70
+ |-------|----------|
71
+ | 0 | No escalation process. Everyone contacts everyone. |
72
+ | 1 | Informal escalation. Contacts known to the old-timers. |
73
+ | 2 | Documented escalation matrix. Not always followed. |
74
+ | 3 | Escalation process with SLA per level. Automatic alerts. Escalation-time metrics. |
75
+ | 4 | Intelligent routing. Auto-escalation based on symptoms. 24/7 coverage. PagerDuty/OpsGenie integrated. |
76
+
77
+ ---
78
+
79
+ ### SU-03 - RACI defined · Criticality: **SHOULD**
80
+
81
+ **Analyze:** RACI matrix, single point of contact, cross-training, succession planning
82
+
83
+ **Verification commands:**
84
+ ```bash
85
+ grep -ri "raci\|responsible\|accountable\|consulted\|informed\|bus.factor\|point.of.contact" . --include="*.md" 2>/dev/null | head -5
86
+ ```
87
+
88
+ **Check:** Documented RACI, single point of contact per domain, cross-training, succession planning
89
+
90
+ **Levels:**
91
+ | Level | Criteria |
92
+ |-------|----------|
93
+ | 0 | No RACI. Fuzzy responsibilities. |
94
+ | 1 | Responsibilities known informally. Not documented. |
95
+ | 2 | RACI documented for the main processes. Not always up to date. |
96
+ | 3 | Complete RACI. Reviewed on team changes. Single point of contact for each domain. |
97
+ | 4 | Dynamic RACI. Integrated into tools (Jira, PagerDuty). Succession planning. Cross-training. |
98
+
99
+ ---
100
+
101
+ ### SU-04 - Install & startup scripts · Criticality: **SHOULD**
102
+
103
+ **Analyze:** IaC (Terraform, Ansible), dev containers, GitOps, one-click setup
104
+
105
+ **Verification commands:**
106
+ ```bash
107
+ ls Makefile docker-compose*.yml Dockerfile devcontainer.json .devcontainer/ 2>/dev/null
108
+ find . -name "*.tf" -o -name "*.ansible.*" -o -name "devcontainer.json" 2>/dev/null | head -5
109
+ grep -ri "make setup\|npm run dev\|bootstrap" Makefile README.md 2>/dev/null | head -5
110
+ ```
111
+
112
+ **Check:** Automated install scripts, IaC, dev containers, GitOps
113
+
114
+ **Levels:**
115
+ | Level | Criteria |
116
+ |-------|----------|
117
+ | 0 | Manual install. Procedures in the experts' heads. |
118
+ | 1 | Basic README. Manual steps. Often incomplete. |
119
+ | 2 | Working install scripts. Docker compose. Occasionally tested. |
120
+ | 3 | Infrastructure as Code (Terraform, Ansible). Reproducible environment. CI/CD for infra. |
121
+ | 4 | GitOps. Self-service provisioning. Dev containers. One-click deployment. Chaos testing of infra. |
122
+
123
+ ---
124
+
125
+ ### SU-04a - Dev environment setup time · Criticality: **SHOULD**
126
+
127
+ **Condition:** Evaluate if SU-04 >= 2
128
+
129
+ **Analyze:** One-click setup, pre-built containers, cloud dev environments, daily validation
130
+
131
+ **Levels:**
132
+ | Level | Criteria |
133
+ |-------|----------|
134
+ | 0 | Several days. Depends on help from colleagues. |
135
+ | 1 | One day with documentation. Frequent problems. |
136
+ | 2 | A few hours. Partial automation. |
137
+ | 3 | <1 hour. Reliable scripts. Troubleshooting guide. |
138
+ | 4 | <15 minutes. Pre-configured dev containers. Self-service. Validated daily. |
139
+
140
+ ---
141
+
142
+ ### SU-05 - Automated onboarding (sandbox) · Criticality: **COULD**
143
+
144
+ **Analyze:** Structured journey, dedicated sandbox, mentoring program, time-to-productivity
145
+
146
+ **Verification commands:**
147
+ ```bash
148
+ find docs/ -name "*onboard*" -o -name "*getting-started*" -o -name "*new-dev*" 2>/dev/null
149
+ grep -ri "onboarding\|getting.started\|sandbox\|new.developer" . --include="*.md" 2>/dev/null | head -5
150
+ ```
151
+
152
+ **Check:** Structured journey, dedicated sandbox, mentoring, time-to-first-commit measured
153
+
154
+ **Levels:**
155
+ | Level | Criteria |
156
+ |-------|----------|
157
+ | 0 | No structured onboarding. Shadow learning. |
158
+ | 1 | Onboarding checklist. No dedicated environment. |
159
+ | 2 | Sandbox with test data. Onboarding documentation. |
160
+ | 3 | Interactive onboarding journey. Structured mentoring. Feedback loop. |
161
+ | 4 | Self-paced learning platform. Internal certification. Productivity metrics. Time-to-productivity tracked. |
162
+
163
+ ---
164
+
165
+ ### SU-05a - Measuring onboarding effectiveness · Criticality: **COULD**
166
+
167
+ **Condition:** Evaluate if SU-05 >= 2
168
+
169
+ **Analyze:** Time-to-first-commit, ramp-up velocity, onboarding NPS, A/B testing
170
+
171
+ **Levels:**
172
+ | Level | Criteria |
173
+ |-------|----------|
174
+ | 0 | No measurement. Subjective impression. |
175
+ | 1 | Informal feedback from newcomers. |
176
+ | 2 | Post-onboarding survey. Identification of friction points. |
177
+ | 3 | Time-to-first-commit measured. Continuous improvement based on feedback. |
178
+ | 4 | Productivity metrics over 90 days. A/B testing of the journeys. Onboarding NPS. |
179
+
180
+ ---