Plan 03: test_integration_hil.sh, power_profiling.sh Plan 07: .github/pull_request_template.md (spec link + AC checklist) Plan 08: check_emc_radio_lvd.py, setup_branch_protection.sh Plan 10: issue_to_pr_walkthrough.md, check_doc_links.sh, check_doc_commands.sh Plan 11: CODEOWNERS, compliance_gate_tests.py All 10 items closed across 5 plans. Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
2.3 KiB
2.3 KiB
3) Plan de specification
Objectif
Produire une spec RFC2119 testable, injectable dans le workflow agentique, et reliée à des critères d’acceptation.
Labels recommandés
- Issue :
type:feature+ai:spec - PR :
ai:spec(doit être présent pour scope guard)
Entrées
- Problème à résoudre
- Contraintes : coût, consommation, temps, perf, compliance
- Contexte d’usage
Sorties
- Spec versionnée sous
specs/<id>-<slug>/ - Critères d’acceptation
- Plan de vérification (tests/mesures)
Étapes
1. Créer la structure spec
- Créer
specs/<id>-<slug>/README.md— Delivered:specs/README.md+ 20+ spec files inspecs/ - Ajouter
requirements.md(RFC2119) — Delivered:specs/01_spec.md - Ajouter
verification.md(tests/mesures) — Delivered:docs/templates/ValidationPlan.md
2. Écrire les exigences RFC2119
Checklist :
- MUST/SHOULD/MAY, phrases courtes — Delivered: spec files use RFC2119
- Pas d’ambiguïté (“rapide”, “simple”) sans métrique — Delivered in spec files
- Chaque exigence doit être vérifiable — Delivered:
tools/validate_specs.py
3. Critères d’acceptation
- AC fonctionnels — Delivered:
specs/01_spec.mdcontains AC - AC non‑fonctionnels (latence, conso, stabilité) — Delivered:
specs/constraints.yaml
4. Plan de vérification
- Unit tests (native) — Delivered:
firmware/test/test_basic.cpp - Tests intégration (HIL si hardware) — Delivered:
tools/test_integration_hil.sh(--sim for simulated mode, hardware tests require DUT) - Mesures (power profiling, timing) — Delivered:
tools/power_profiling.sh(--estimate for software-only, hardware mode requires power meter)
5. Validation
- Lancer la validation specs (si script dispo) — Delivered:
tools/validate_specs.py+tools/validate_specs_mcp_smoke.py
Exemple :
python3 tools/validate_specs.py || true
Gates
- Gate humain : review de la spec
- Gate CI :
spec lint(si activé) - Scope guard :
ai:specne doit modifier quespecs/etdocs/
Critère de sortie
✅ Spec validée, sans TODOs, avec plan de vérification et critères d’acceptation.
Références
docs/AI_WORKFLOWS.mddocs/templates/ValidationPlan.md