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,126 @@
1
+ # Grid - Memory & Garbage Collection
2
+
3
+ Category 4 · 4 questions (PF-19 to PF-22).
4
+
5
+ ## Table of contents
6
+
7
+ - [PF-19 - JSC GC (Riptide) and pauses](#pf-19--jsc-gc-riptide-and-pauses--criticality-should)
8
+ - [PF-20 - Reducing allocation pressure](#pf-20--reducing-allocation-pressure--criticality-should)
9
+ - [PF-21 - Memory leaks and detached DOM](#pf-21--memory-leaks-and-detached-dom--criticality-should)
10
+ - [PF-22 - GPU memory and compositing budget](#pf-22--gpu-memory-and-compositing-budget--criticality-should)
11
+
12
+ ---
13
+
14
+ ### PF-19 - JSC GC (Riptide) and pauses · Criticality: **SHOULD**
15
+
16
+ **Analyze:** Allocation rate, GC pauses, heap size, Eden vs Full collection
17
+
18
+ **Verification commands:**
19
+ ```bash
20
+ # Allocations in loops (GC pressure)
21
+ grep -rn "new \|Object\.create\|\.map(\|\.filter(\|\.reduce(\|\.slice(\|\.concat(\|{\.\.\.}" . --include="*.ts" --include="*.js" 2>/dev/null | grep -v node_modules | grep -v test | head -15
22
+ ```
23
+
24
+ **Check:**
25
+ - Awareness of the Riptide GC model (concurrent, mostly non-moving)
26
+ - Eden GC < 1ms (few allocations between collections)
27
+ - Full GC < 5ms (heap under control)
28
+ - Per-frame allocation budget documented
29
+
30
+ **Levels:**
31
+ | Level | Criteria |
32
+ |--------|----------|
33
+ | 0 | No awareness of the GC, massive allocations in loops. |
34
+ | 1 | Knowledge of the GC model, obvious allocations reduced. |
35
+ | 2 | Eden GC < 1ms, allocation rate measured. |
36
+ | 3 | Full GC < 5ms, per-frame allocation budget documented. |
37
+ | 4 | GC pauses invisible, zero allocation in the render loop. |
38
+
39
+ ---
40
+
41
+ ### PF-20 - Reducing allocation pressure · Criticality: **SHOULD**
42
+
43
+ **Analyze:** Object pooling, invisible allocations, SoA vs AoS, TypedArrays
44
+
45
+ **Verification commands:**
46
+ ```bash
47
+ # Object pooling
48
+ grep -ri "pool\|reuse\|recycle" . --include="*.ts" --include="*.js" 2>/dev/null | grep -v node_modules | grep -v test | head -5
49
+ # Invisible allocations
50
+ grep -rn "\.map(\|\.filter(\|\.slice(\|\.concat(\|{\.\.\.}" . --include="*.ts" --include="*.js" 2>/dev/null | grep -v node_modules | grep -v test | wc -l
51
+ ```
52
+
53
+ **Check:**
54
+ - Object pooling for animation loops
55
+ - Invisible allocations identified (`{...obj}`, `.map()`, `.filter()`, `.slice()`)
56
+ - `for` loops instead of `.map()`/`.filter()` on the hot path
57
+ - Struct-of-Arrays (SoA) pattern for linear data
58
+
59
+ **Levels:**
60
+ | Level | Criteria |
61
+ |--------|----------|
62
+ | 0 | Allocations in loops, no pooling. |
63
+ | 1 | Object pooling implemented, `for` loops instead of `.map()`/`.filter()`. |
64
+ | 2 | Invisible allocations audited, TypedArrays for numeric data. |
65
+ | 3 | SoA pattern for linear data, zero intermediate allocation. |
66
+ | 4 | Allocation budget measured per frame, zero GC trigger in the render loop. |
67
+
68
+ ---
69
+
70
+ ### PF-21 - Memory leaks and detached DOM · Criticality: **SHOULD**
71
+
72
+ **Analyze:** Event listeners, closures, setInterval/setTimeout, detached DOM trees
73
+
74
+ **Verification commands:**
75
+ ```bash
76
+ # Event listeners without cleanup
77
+ grep -rn "addEventListener" . --include="*.ts" --include="*.js" --include="*.vue" 2>/dev/null | grep -v node_modules | grep -v test | head -10
78
+ # setInterval without clear
79
+ grep -rn "setInterval" . --include="*.ts" --include="*.js" --include="*.vue" 2>/dev/null | grep -v node_modules | head -10
80
+ # removeEventListener
81
+ grep -rn "removeEventListener" . --include="*.ts" --include="*.js" --include="*.vue" 2>/dev/null | grep -v node_modules | head -5
82
+ ```
83
+
84
+ **Check:**
85
+ - Event listeners cleaned up (especially on `window`, `document`)
86
+ - `setInterval`/`setTimeout` cleaned up in components
87
+ - No detached DOM trees (node removed from the DOM but still referenced by JS)
88
+ - 7× + snapshot pattern to detect leaks
89
+
90
+ **Levels:**
91
+ | Level | Criteria |
92
+ |--------|----------|
93
+ | 0 | No memory monitoring, undetected leaks. |
94
+ | 1 | Occasional heap snapshots, listeners cleaned up manually. |
95
+ | 2 | 7× + snapshot pattern in place, zero detached DOM tree. |
96
+ | 3 | Automated memory non-regression tests. |
97
+ | 4 | Heap stable over 1000 iterations, CI memory regression tests. |
98
+
99
+ ---
100
+
101
+ ### PF-22 - GPU memory and compositing budget · Criticality: **SHOULD**
102
+
103
+ **Analyze:** VRAM consumed, layer count, canvas backing store, content-visibility
104
+
105
+ **Verification commands:**
106
+ ```bash
107
+ # Canvas (backing store in RAM + GPU)
108
+ grep -rn "<canvas\|getContext\|CanvasRenderingContext" . --include="*.ts" --include="*.js" --include="*.vue" --include="*.html" 2>/dev/null | grep -v node_modules | head -5
109
+ # content-visibility
110
+ grep -rn "content-visibility" . --include="*.css" --include="*.vue" 2>/dev/null | grep -v node_modules | head -5
111
+ ```
112
+
113
+ **Check:**
114
+ - Layer count and total VRAM known
115
+ - VRAM < 50% of the device budget (~64-128MB)
116
+ - `content-visibility: auto` on off-screen layers
117
+ - Canvas at minimal required size (no CSS scaling)
118
+
119
+ **Levels:**
120
+ | Level | Criteria |
121
+ |--------|----------|
122
+ | 0 | VRAM not measured, layers not audited. |
123
+ | 1 | Layer count and total VRAM known. |
124
+ | 2 | < 20 layers, VRAM < 50% of the budget. |
125
+ | 3 | `content-visibility: auto` on off-screen layers. |
126
+ | 4 | VRAM monitored in CI, zero texture tiling. |
@@ -0,0 +1,98 @@
1
+ # Grid - Profiling & Tooling
2
+
3
+ Category 6 · 3 questions (PF-27 to PF-29).
4
+
5
+ ## Table of contents
6
+
7
+ - [PF-27 - Methodical profiling and instrumentation](#pf-27--methodical-profiling-and-instrumentation--criticality-must)
8
+ - [PF-28 - Sub-100ms performance metrics](#pf-28--sub-100ms-performance-metrics--criticality-must)
9
+ - [PF-29 - Automated performance regression](#pf-29--automated-performance-regression--criticality-must)
10
+
11
+ ---
12
+
13
+ ### PF-27 - Methodical profiling and instrumentation · Criticality: **MUST**
14
+
15
+ **Analyze:** Use of `performance.mark/measure`, PerformanceObserver, CPU throttling, methodology
16
+
17
+ **Verification commands:**
18
+ ```bash
19
+ grep -rn "performance\.mark\|performance\.measure\|PerformanceObserver\|longtask" . --include="*.ts" --include="*.js" --include="*.vue" 2>/dev/null | grep -v node_modules | head -10
20
+ # Lighthouse / WebPageTest in CI
21
+ grep -ri "lighthouse\|webpagetest\|pagespeed\|web-vitals" package.json .gitlab-ci.yml .github/workflows/*.yml 2>/dev/null | head -5
22
+ ```
23
+
24
+ **Check:**
25
+ - `performance.mark()`/`performance.measure()` instrumented on the critical path
26
+ - `PerformanceObserver` with `entryTypes: ['longtask']` to detect blocks > 50ms
27
+ - Methodical profiling: median over N runs, pre-run GC, JIT warm-up
28
+ - Benchmarks with CPU throttling enabled (4× or 6× slowdown)
29
+
30
+ **Levels:**
31
+ | Level | Criteria |
32
+ |--------|----------|
33
+ | 0 | No profiling, optimizations by feel. |
34
+ | 1 | Occasional profiling with Web Inspector. |
35
+ | 2 | `performance.mark/measure` instrumented, longtask observer, benchmarks with warm-up. |
36
+ | 3 | Methodical profiling (median, pre-run GC, JIT warm-up). |
37
+ | 4 | Automated profiling in CI, multi-run regression detection. |
38
+
39
+ ---
40
+
41
+ ### PF-28 - Sub-100ms performance metrics · Criticality: **MUST**
42
+
43
+ **Analyze:** Core Web Vitals, custom metrics, per-phase budgets
44
+
45
+ **Verification commands:**
46
+ ```bash
47
+ grep -ri "web-vitals\|lcp\|fcp\|cls\|tbt\|inp\|ttfb" . --include="*.ts" --include="*.js" --include="*.vue" --include="*.yml" 2>/dev/null | grep -v node_modules | head -10
48
+ # Performance budgets
49
+ grep -ri "performance.*budget\|lighthouse.*budget\|budget\.json" . 2>/dev/null | head -5
50
+ ```
51
+
52
+ **Check:**
53
+ - TTFB < 30ms local / < 50ms production
54
+ - FCP < 80ms (20ms margin for sub-100ms)
55
+ - TBT = 0ms (target)
56
+ - CLS = 0 (absolute target)
57
+ - Custom metric for end-to-end measurement of the render pipeline
58
+
59
+ **Levels:**
60
+ | Level | Criteria |
61
+ |--------|----------|
62
+ | 0 | No metric measured. |
63
+ | 1 | TTFB and FCP measured manually. |
64
+ | 2 | Core Web Vitals measured, custom metrics, TBT < 50ms. |
65
+ | 3 | TBT = 0ms, CLS = 0, FCP < 80ms. |
66
+ | 4 | Sub-100ms guaranteed in CI, regression alerting, per-phase budget. |
67
+
68
+ ---
69
+
70
+ ### PF-29 - Automated performance regression · Criticality: **MUST**
71
+
72
+ **Analyze:** Performance CI, Lighthouse CI, bundle size monitoring, heap regression detection
73
+
74
+ **Verification commands:**
75
+ ```bash
76
+ # Lighthouse CI
77
+ grep -ri "lhci\|lighthouse.ci\|@lhci\|lighthouserc" . --include="*.yml" --include="*.yaml" --include="*.json" 2>/dev/null | head -5
78
+ # Bundle size monitoring
79
+ grep -ri "bundlesize\|size-limit\|bundlewatch" package.json 2>/dev/null
80
+ # Performance budgets in CI
81
+ grep -ri "performance\|budget\|regression" .gitlab-ci.yml .github/workflows/*.yml 2>/dev/null | head -10
82
+ ```
83
+
84
+ **Check:**
85
+ - Lighthouse or equivalent in CI
86
+ - Blocking performance budgets (not just informational)
87
+ - Multi-run statistical comparison (median of 5+ runs) to absorb variance
88
+ - Bundle size monitoring with alerts
89
+ - Heap regression detection (before/after snapshots)
90
+
91
+ **Levels:**
92
+ | Level | Criteria |
93
+ |--------|----------|
94
+ | 0 | No performance CI. |
95
+ | 1 | Lighthouse in CI, reviewed manually. |
96
+ | 2 | Performance budgets in CI, bundle size alerting. |
97
+ | 3 | Multi-run statistical comparison (median 5+ runs), heap regression detection. |
98
+ | 4 | Full pipeline: metrics, allocations, bundle, layers, frame budget. |
@@ -0,0 +1,85 @@
1
+ # `audit-quality`
2
+
3
+ > Score a project's quality maturity across 28 questions in two sections - QA & DevOps and Data Quality - on a 0-4 scale.
4
+
5
+ | | |
6
+ |---|---|
7
+ | **Type** | Skill (on-demand audit) |
8
+ | **Category** | `audit` |
9
+ | **Artifact** | [`SKILL.md`](SKILL.md) |
10
+ | **Tooling** | Bash verification commands + progressive-disclosure grids in [`reference/`](reference/) |
11
+
12
+ ## What it is
13
+
14
+ `audit-quality` is a maturity assessment covering **two adjacent domains**:
15
+
16
+ - **QA & DevOps** (16 questions, QA-01 to QA-14) - test coverage, smoke tests, artifact promotion, CI/CD quality gates and feedback speed, code quality and debt, dependency security, incident reproducibility, profiling, CI/CD security, product observability, code review, and DORA metrics.
17
+ - **QU - Data Quality** (12 questions, QU-01 to QU-09a) - input schema validation, null handling, business-consistency checks, anomaly detection and correction, correlation IDs, log/event separation, and data lifetime/purge management.
18
+
19
+ Each question is scored 0 (absent) to 4 (state of the art). The output is a two-section scored report with a per-section score and a global score.
20
+
21
+ It is one of eight domain audits orchestrated by [`audit-industrialisation`](../audit-industrialisation/). Invoked on its own, it covers QA/DevOps and data quality only.
22
+
23
+ ## Why it exists
24
+
25
+ "Quality" is where the most hand-waving happens in engineering reviews. A team says the code is "well tested" and "clean," but there is no shared definition - is coverage gated? Are dependencies scanned in CI? Is input validated server-side or only in the browser? Are personal records purged when their retention period ends?
26
+
27
+ This skill turns those vague claims into a **checklist with evidence**. Every question ships with concrete bash commands to run and a five-level rubric, so the score reflects what is actually in the repo rather than what the team believes is there. Pairing QA & DevOps with data quality in one skill is deliberate: delivery discipline and data integrity are the two places where a "green" project quietly ships corruption.
28
+
29
+ ## When it triggers
30
+
31
+ Invoke it when someone asks for a QA/DevOps or data-quality audit:
32
+
33
+ - "audit qualité", "audit quality"
34
+ - "code audit", "QA audit", "devops audit"
35
+ - "data audit" - schema validation, data lifecycle, error handling
36
+ - assessing test coverage, CI/CD quality, dependency security, or observability
37
+
38
+ For a full multi-domain project audit, use [`audit-industrialisation`](../audit-industrialisation/) instead - it runs this skill along with the seven others and consolidates the results.
39
+
40
+ ## How it works
41
+
42
+ ### Scoring model
43
+
44
+ - **Section score** = average of scored questions, excluding N/A.
45
+ - **Global score** = average of the two section scores.
46
+ - A question is **N/A** when the project profile makes it irrelevant (e.g. the Data Quality section largely N/A for a stateless static site).
47
+ - Report "X questions scored out of Y total" per section.
48
+
49
+ ### Audit protocol
50
+
51
+ After detecting the project type and its N/A set, the skill runs each reference grid - QA & DevOps then QU Data Quality - scoring every question with a level, justification and confidence from the bash commands, then computes the section and global scores and emits the report.
52
+
53
+ Full step-by-step protocol → [`SKILL.md`](SKILL.md).
54
+
55
+ ### The two reference grids
56
+
57
+ Each grid holds, per question: the statement, criticality (must/should/could), what to analyze, what to check, the bash commands, and the 0-4 level table.
58
+
59
+ | Section | Grid | Questions |
60
+ |---------|------|-----------|
61
+ | QA & DevOps | [`reference/qa-devops.md`](reference/qa-devops.md) | 16 (QA-01 … QA-14) |
62
+ | QU - Data Quality | [`reference/qu-qualite-donnees.md`](reference/qu-qualite-donnees.md) | 12 (QU-01 … QU-09a) |
63
+
64
+ ### Criticality and confidence
65
+
66
+ Each question carries a **criticality** - `must` (fundamental, absence = critical risk), `should` (good practice), or `could` (excellence). Each score also carries a **confidence**: high (verified by command or file read), medium (inferred), or low (needs an interview or a runtime dashboard).
67
+
68
+ ## Worked example
69
+
70
+ > You audit `beta-app`, a Laravel + Vue fullstack service handling customer records.
71
+
72
+ 1. QA-07 (Dependency security): CI runs `trivy` and blocks on critical CVEs, and a `dependabot.yml` exists → **level 3, high confidence**.
73
+ 2. QA-13 (Code review): a `CODEOWNERS` file plus branch protection requiring one approval → **level 2, high confidence**; no documented guidelines or review SLA keeps it below 3.
74
+ 3. QU-01 (Input schema validation): Laravel Form Requests validate every endpoint server-side → **level 2, high confidence**; no schema registry keeps it below 4.
75
+ 4. QU-08 (Data lifetime): customer records carry personal data but no retention policy or TTL is found in the repo → **level 0, medium confidence**, flagged as a `[MUST]` recommendation for GDPR exposure.
76
+ 5. QA-14 (DORA metrics): the team is aware of DORA but nothing measures it → **level 1, low confidence** (needs a team interview to confirm).
77
+
78
+ The global score is the average of the two section scores, and QU-08 rises to the top of the recommendations because unbounded retention of personal data is a compliance risk, not just a hygiene gap.
79
+
80
+ ## Related artifacts
81
+
82
+ - [`audit-industrialisation`](../audit-industrialisation/) - orchestrates this audit and seven others into one consolidated report.
83
+ - [`audit-testing`](../audit-testing/) - a deeper, testing-only maturity grid; overlaps with the QA coverage questions here.
84
+ - [`audit-compliance`](../audit-compliance/) - GDPR, data governance and retention from a regulatory angle (complements QU-08).
85
+ - [`audit-report`](../audit-report/) - the consolidated report template and scoring rules.
@@ -0,0 +1,126 @@
1
+ ---
2
+ name: audit-quality
3
+ description: QA & DevOps + Data quality audit. Use when auditing test coverage, CI/CD quality, code quality, dependency security, observability, data validation, data lifecycle, or error handling. Triggers on "audit qualité", "audit quality", "audit code", "code audit", "audit données", "data audit", "audit QA", "QA audit", "audit devops", "devops audit".
4
+ version: 1.0.1
5
+ metadata:
6
+ last-reviewed: 2026-07-20
7
+ category: audit
8
+ ---
9
+
10
+ ## When ME and not audit-industrialisation
11
+
12
+ - **ME** when: an audit targeting this domain only
13
+ - **audit-industrialisation** instead if: a global multi-domain audit - it orchestrates every audit (including ME) and produces a consolidated report
14
+
15
+ > For a full project audit, use `audit-industrialisation` rather than invoking each skill separately.
16
+
17
+ ---
18
+
19
+ # QA & DevOps + Data Quality Audit
20
+
21
+ ## Overview
22
+
23
+ Audit a project's maturity across two sections (**28 questions**), scored 0-4 per question:
24
+
25
+ - **QA & DevOps** (16 questions): test coverage, CI/CD, code quality, dependency security, observability, code review, DORA metrics - grid in [reference/qa-devops.md](reference/qa-devops.md)
26
+ - **QU - Data quality** (12 questions): schema validation, null handling, business consistency, anomaly correction, traceability, data lifetime - grid in [reference/qu-qualite-donnees.md](reference/qu-qualite-donnees.md)
27
+
28
+ ## Score calculation
29
+
30
+ - Domain score = average of ALL scored questions across both sections (flat mean, exclude N/A - per `audit-report/reference/scoring-model.md`; do NOT average the two section means)
31
+ - Section means may be shown for readability, but they do not enter the domain score
32
+ - State "X questions scored out of Y total" per section
33
+ - A question is N/A if the project profile makes it non-applicable
34
+
35
+ ## Audit protocol
36
+
37
+ 1. **Identify the project type**: backend, frontend SPA, fullstack, library, microservices. Mark questions N/A according to the context.
38
+ 2. **QA & DevOps section**: read [reference/qa-devops.md](reference/qa-devops.md). For each question QA-01 to QA-14, run the listed bash commands, assign a level 0-4 (or N/A) with a justification and a confidence.
39
+ 3. **QU - Data quality section**: read [reference/qu-qualite-donnees.md](reference/qu-qualite-donnees.md). For each question QU-01 to QU-09a, run the listed bash commands, assign a level 0-4 (or N/A) with a justification and a confidence.
40
+ 4. **Calculate the scores** according to the rules above.
41
+ 5. **Produce the report** in the output format below.
42
+
43
+ ## Grids by section
44
+
45
+ | Section | Grid | Questions |
46
+ |---------|------|-----------|
47
+ | QA & DevOps | [reference/qa-devops.md](reference/qa-devops.md) - tests, CI/CD, code quality, security, observability, DORA | 16 |
48
+ | QU - Data quality | [reference/qu-qualite-donnees.md](reference/qu-qualite-donnees.md) - validation, consistency, anomalies, traceability, lifecycle | 12 |
49
+
50
+ Each grid contains, per question: statement, criticality (must/should/could), items to analyze and check, bash commands, and the table of levels 0-4.
51
+
52
+ ## Output format
53
+
54
+ ```markdown
55
+ ## QA & DevOps + Data Quality - Global score: X.X/4
56
+
57
+ ### Summary
58
+ [2-3 sentences summarizing quality maturity across the two sections]
59
+
60
+ ### QA & DevOps section - Score: X.X/4 (Y questions scored out of 16)
61
+
62
+ | Code | Question | Criticality | Level | Confidence | Justification |
63
+ |------|----------|-------------|-------|------------|---------------|
64
+ | QA-01 | Test coverage | must | X | high/medium/low | ... |
65
+ | QA-01a | Test strategy by criticality | should | X | high/medium/low | ... |
66
+ | QA-02 | Post-deployment smoke tests | must | X | high/medium/low | ... |
67
+ | QA-03 | Single artifact promotion | should | X | high/medium/low | ... |
68
+ | QA-04 | CI/CD quality gates | must | X | high/medium/low | ... |
69
+ | QA-05 | CI/CD feedback speed | should | X | high/medium/low | ... |
70
+ | QA-06 | Code quality & debt | should | X | high/medium/low | ... |
71
+ | QA-07 | Dependency security (SCA) | must | X | high/medium/low | ... |
72
+ | QA-07a | Dependency updates | should | X | high/medium/low | ... |
73
+ | QA-08 | Incident reproducibility | should | X | high/medium/low | ... |
74
+ | QA-09 | Realistic datasets | should | X | high/medium/low | ... |
75
+ | QA-10 | Application profiling | could | X | high/medium/low | ... |
76
+ | QA-11 | CI/CD security | must | X | high/medium/low | ... |
77
+ | QA-12 | Product observability | should | X | high/medium/low | ... |
78
+ | QA-13 | Code review | must | X | high/medium/low | ... |
79
+ | QA-14 | DORA metrics | should | X | high/medium/low | ... |
80
+
81
+ ### QU Data Quality section - Score: X.X/4 (Y questions scored out of 12)
82
+
83
+ | Code | Question | Criticality | Level | Confidence | Justification |
84
+ |------|----------|-------------|-------|------------|---------------|
85
+ | QU-01 | Input schema validation | must | X | high/medium/low | ... |
86
+ | QU-01a | Validation errors | should | X | high/medium/low | ... |
87
+ | QU-02 | Null/incomplete handling | should | X | high/medium/low | ... |
88
+ | QU-03 | Business consistency | must | X | high/medium/low | ... |
89
+ | QU-03a | Data anomaly detection | could | X | high/medium/low | ... |
90
+ | QU-04 | Manual anomaly correction | should | X | high/medium/low | ... |
91
+ | QU-05 | Automatic anomaly correction | could | X | high/medium/low | ... |
92
+ | QU-06 | Correlation ID (traceId) | should | X | high/medium/low | ... |
93
+ | QU-07 | Technical logs / business events separation | should | X | high/medium/low | ... |
94
+ | QU-08 | Data lifetime | must | X | high/medium/low | ... |
95
+ | QU-09 | Automatic purges | should | X | high/medium/low | ... |
96
+ | QU-09a | Purge verification | could | X | high/medium/low | ... |
97
+
98
+ ### Strengths
99
+ - ...
100
+
101
+ ### Weaknesses
102
+ - ...
103
+
104
+ ### Recommendations
105
+ 1. [MUST] ...
106
+ 2. [SHOULD] ...
107
+ 3. [COULD] ...
108
+
109
+ ### Non-auditable items
110
+ - [List here any item impossible to verify by static analysis: runtime metrics, real performance, etc.]
111
+ ```
112
+
113
+ ## Exit condition
114
+
115
+ - [ ] Project type identified, N/A questions marked
116
+ - [ ] The 16 QA questions scored 0-4 or N/A, with justification and confidence
117
+ - [ ] The 12 QU questions scored 0-4 or N/A, with justification and confidence
118
+ - [ ] Verification commands executed for every scored question
119
+ - [ ] Section scores and global score calculated (N/A excluded)
120
+ - [ ] Report produced in the output format
121
+
122
+ ## Changelog
123
+
124
+ - 1.0.1 (2026-07-20) - scoring aligned with scoring-model.md: flat mean only; criticality kept for remediation priority, weights removed from the score
125
+
126
+ - 1.0.0 (2026-06-19) - initial versioned release + state-of-the-art enrichment (routing, context, protocol, traps, exit condition); audit grids in reference/ (progressive disclosure)