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,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)
|