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.
- package/AGENTS.md +90 -0
- package/LICENSE +21 -0
- package/README.md +281 -0
- package/agents/code-reviewer.md +33 -0
- package/agents/qa-tester.md +28 -0
- package/dist/hooks/README.md +182 -0
- package/dist/hooks/bash-npm-silent.mjs +81 -0
- package/dist/hooks/session-inject.mjs +53 -0
- package/dist/hooks/session-precompact.mjs +36 -0
- package/dist/hooks/session-writer.mjs +142 -0
- package/dist/hooks/skill-reminder.mjs +89 -0
- package/dist/hooks/truncate-bash-output.mjs +46 -0
- package/dist/hooks/truncate-output.mjs +88 -0
- package/dist/hooks/worktree-env-setup.mjs +123 -0
- package/dist/install.js +962 -0
- package/docs/adopting-a-repo.md +80 -0
- package/docs/architecture.md +76 -0
- package/docs/decisions.md +72 -0
- package/docs/developing.md +143 -0
- package/docs/evaluating-skills.md +41 -0
- package/docs/git-worktrees.md +62 -0
- package/docs/rules/clean-architecture-deps.md +66 -0
- package/docs/rules/commits.md +59 -0
- package/docs/rules/detection-gap-protocol.md +55 -0
- package/docs/rules/error-handling-discipline.md +62 -0
- package/docs/rules/minimal-code.md +58 -0
- package/docs/rules/no-raw-sql-interpolation.md +57 -0
- package/docs/rules/pre-commit-secret-detection.md +54 -0
- package/docs/rules/secure-logging.md +53 -0
- package/docs/rules/sql-migrations-discipline.md +58 -0
- package/docs/rules/subscription-cleanup.md +63 -0
- package/docs/rules/test-discipline.md +66 -0
- package/docs/rules/ui-states-complete.md +52 -0
- package/docs/templates/SKILL.template.md +66 -0
- package/docs/templates/rule.template.md +16 -0
- package/docs/writing-a-rule.md +43 -0
- package/docs/writing-a-skill.md +118 -0
- package/package.json +45 -0
- package/rules/clean-architecture-deps.md +20 -0
- package/rules/commits.md +16 -0
- package/rules/detection-gap-protocol.md +35 -0
- package/rules/error-handling-discipline.md +23 -0
- package/rules/minimal-code.md +32 -0
- package/rules/no-raw-sql-interpolation.md +20 -0
- package/rules/pre-commit-secret-detection.md +14 -0
- package/rules/secure-logging.md +16 -0
- package/rules/sql-migrations-discipline.md +18 -0
- package/rules/subscription-cleanup.md +22 -0
- package/rules/test-discipline.md +20 -0
- package/rules/ui-states-complete.md +23 -0
- package/scripts/subscription-leak-scan.ts +53 -0
- package/skills/adversarial-feature-challenge/README.md +65 -0
- package/skills/adversarial-feature-challenge/SKILL.md +96 -0
- package/skills/adversarial-feature-challenge/assets/fuzz-payloads.txt +60 -0
- package/skills/adversarial-feature-challenge/templates/challenge-report.md +42 -0
- package/skills/api-contract-versioning/README.md +62 -0
- package/skills/api-contract-versioning/SKILL.md +76 -0
- package/skills/api-contract-versioning/templates/consumer-inventory.md +29 -0
- package/skills/audit-architecture/README.md +56 -0
- package/skills/audit-architecture/SKILL.md +97 -0
- package/skills/audit-architecture/reference/ar-architecture.md +275 -0
- package/skills/audit-architecture/reference/di-disponibilite.md +252 -0
- package/skills/audit-architecture/reference/im-incidents.md +217 -0
- package/skills/audit-architecture/reference/pa-pannes.md +362 -0
- package/skills/audit-architecture/reference/re-recuperation.md +300 -0
- package/skills/audit-architecture/reference/sc-scalabilite.md +173 -0
- package/skills/audit-architecture/reference/su-support.md +180 -0
- package/skills/audit-ci-cd/README.md +54 -0
- package/skills/audit-ci-cd/SKILL.md +124 -0
- package/skills/audit-ci-cd/reference/artefacts.md +39 -0
- package/skills/audit-ci-cd/reference/deploiement.md +100 -0
- package/skills/audit-ci-cd/reference/dora.md +94 -0
- package/skills/audit-ci-cd/reference/iac.md +40 -0
- package/skills/audit-ci-cd/reference/pipeline-ci.md +36 -0
- package/skills/audit-ci-cd/reference/supply-chain.md +44 -0
- package/skills/audit-compliance/README.md +69 -0
- package/skills/audit-compliance/SKILL.md +176 -0
- package/skills/audit-compliance/reference/conformite-rgpd.md +295 -0
- package/skills/audit-compliance/reference/finops.md +318 -0
- package/skills/audit-compliance/reference/gouvernance-donnees.md +238 -0
- package/skills/audit-industrialisation/README.md +53 -0
- package/skills/audit-industrialisation/SKILL.md +251 -0
- package/skills/audit-observability/README.md +64 -0
- package/skills/audit-observability/SKILL.md +134 -0
- package/skills/audit-observability/reference/alerting.md +214 -0
- package/skills/audit-observability/reference/logging.md +114 -0
- package/skills/audit-observability/reference/metriques.md +166 -0
- package/skills/audit-observability/reference/traces-dashboards.md +90 -0
- package/skills/audit-performance-frontend/README.md +91 -0
- package/skills/audit-performance-frontend/SKILL.md +194 -0
- package/skills/audit-performance-frontend/reference/assets-cache-network.md +129 -0
- package/skills/audit-performance-frontend/reference/css-rendering-pipeline.md +154 -0
- package/skills/audit-performance-frontend/reference/html-critical-path.md +128 -0
- package/skills/audit-performance-frontend/reference/js-engine-runtime.md +280 -0
- package/skills/audit-performance-frontend/reference/memory-gc.md +126 -0
- package/skills/audit-performance-frontend/reference/profiling-tooling.md +98 -0
- package/skills/audit-quality/README.md +85 -0
- package/skills/audit-quality/SKILL.md +126 -0
- package/skills/audit-quality/reference/qa-devops.md +539 -0
- package/skills/audit-quality/reference/qu-qualite-donnees.md +402 -0
- package/skills/audit-report/README.md +72 -0
- package/skills/audit-report/SKILL.md +241 -0
- package/skills/audit-report/reference/scoring-model.md +45 -0
- package/skills/audit-security/README.md +72 -0
- package/skills/audit-security/SKILL.md +140 -0
- package/skills/audit-security/reference/auth-identite.md +98 -0
- package/skills/audit-security/reference/autorisation.md +66 -0
- package/skills/audit-security/reference/chiffrement-tls.md +97 -0
- package/skills/audit-security/reference/detection-patching.md +67 -0
- package/skills/audit-security/reference/incident-response.md +98 -0
- package/skills/audit-security/reference/reseau-conteneurs.md +72 -0
- package/skills/audit-security/reference/secrets.md +36 -0
- package/skills/audit-testing/README.md +82 -0
- package/skills/audit-testing/SKILL.md +131 -0
- package/skills/audit-testing/reference/golden-dataset.md +65 -0
- package/skills/audit-testing/reference/resilience-chaos.md +93 -0
- package/skills/audit-testing/reference/tests-contractuels.md +65 -0
- package/skills/audit-testing/reference/tests-e2e-flaky.md +67 -0
- package/skills/audit-testing/reference/tests-unit-integ-ci.md +125 -0
- package/skills/bug-ticket-root-cause/README.md +67 -0
- package/skills/bug-ticket-root-cause/SKILL.md +86 -0
- package/skills/bug-ticket-root-cause/templates/bug-ticket.md +43 -0
- package/skills/bug-triage-structured/README.md +63 -0
- package/skills/bug-triage-structured/SKILL.md +104 -0
- package/skills/bug-triage-structured/templates/bug-triage.md +38 -0
- package/skills/ci-pipeline-orchestration/README.md +55 -0
- package/skills/ci-pipeline-orchestration/SKILL.md +110 -0
- package/skills/commit-readiness-review/README.md +66 -0
- package/skills/commit-readiness-review/SKILL.md +82 -0
- package/skills/commit-readiness-review/scripts/precommit-scan.ts +81 -0
- package/skills/comprehensive-test-strategy/README.md +64 -0
- package/skills/comprehensive-test-strategy/SKILL.md +108 -0
- package/skills/comprehensive-test-strategy/reference/testing-advanced.md +85 -0
- package/skills/daily-workflow-optimization/README.md +56 -0
- package/skills/daily-workflow-optimization/SKILL.md +80 -0
- package/skills/database-schema-evolution/README.md +54 -0
- package/skills/database-schema-evolution/SKILL.md +107 -0
- package/skills/ddd-backend-implementation/README.md +63 -0
- package/skills/ddd-backend-implementation/SKILL.md +95 -0
- package/skills/design-system-component-lifecycle/README.md +56 -0
- package/skills/design-system-component-lifecycle/SKILL.md +97 -0
- package/skills/design-system-component-lifecycle/templates/component-contract.md +43 -0
- package/skills/detection-sweep/README.md +58 -0
- package/skills/detection-sweep/SKILL.md +93 -0
- package/skills/detection-sweep/scripts/sweep.ts +80 -0
- package/skills/domain-modeling-design/README.md +57 -0
- package/skills/domain-modeling-design/SKILL.md +83 -0
- package/skills/frontend-fullstack-implementation/README.md +60 -0
- package/skills/frontend-fullstack-implementation/SKILL.md +133 -0
- package/skills/frontend-spec-call-site-audit/README.md +66 -0
- package/skills/frontend-spec-call-site-audit/SKILL.md +82 -0
- package/skills/frontend-spec-call-site-audit/scripts/audit-entry-points.ts +79 -0
- package/skills/frontend-spec-call-site-audit/templates/ticket-frontend.md +32 -0
- package/skills/merge-request-review/README.md +60 -0
- package/skills/merge-request-review/SKILL.md +77 -0
- package/skills/merge-request-review/templates/mr-review-report.md +29 -0
- package/skills/production-incident-diagnostic/README.md +63 -0
- package/skills/production-incident-diagnostic/SKILL.md +103 -0
- package/skills/production-incident-diagnostic/templates/incident-report.md +33 -0
- package/skills/qa-session-intake/README.md +56 -0
- package/skills/qa-session-intake/SKILL.md +78 -0
- package/skills/recording-decisions/README.md +91 -0
- package/skills/recording-decisions/SKILL.md +84 -0
- package/skills/recurring-bug-root-cause/README.md +64 -0
- package/skills/recurring-bug-root-cause/SKILL.md +93 -0
- package/skills/recurring-bug-root-cause/scripts/detect-recurring-fixes.ts +46 -0
- package/skills/recurring-bug-root-cause/templates/postmortem-recidive.md +37 -0
- package/skills/refactoring-shared-component-api/README.md +50 -0
- package/skills/refactoring-shared-component-api/SKILL.md +84 -0
- package/skills/refactoring-shared-component-api/scripts/sweep-call-sites.ts +85 -0
- package/skills/refactoring-shared-component-api/templates/migration-checklist.md +19 -0
- package/skills/validating-features-end-to-end/README.md +50 -0
- package/skills/validating-features-end-to-end/SKILL.md +90 -0
- package/skills/visual-regression-check/README.md +51 -0
- package/skills/visual-regression-check/SKILL.md +89 -0
- package/skills/writing-robust-tests/README.md +53 -0
- package/skills/writing-robust-tests/SKILL.md +88 -0
- package/templates/.adopted.example +8 -0
- 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
|
+
---
|