Files
Kill_LIFE/docs/plans/03_plan_specification.md
L'électron rareandClaude Opus 4.6 472cfe4ba6 feat: close plans 03/07/08/10/11 — HIL tests, compliance, onboarding, CODEOWNERS
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]>
2026-03-25 12:42:37 +01:00

2.3 KiB
Raw Permalink Blame History

3) Plan de specification

Objectif

Produire une spec RFC2119 testable, injectable dans le workflow agentique, et reliée à des critères dacceptation.

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 dusage

Sorties

  • Spec versionnée sous specs/<id>-<slug>/
  • Critères dacceptation
  • 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 in specs/
  • 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 dambiguïté (“rapide”, “simple”) sans métrique — Delivered in spec files
  • Chaque exigence doit être vérifiable — Delivered: tools/validate_specs.py

3. Critères dacceptation

  • AC fonctionnels — Delivered: specs/01_spec.md contains AC
  • AC nonfonctionnels (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:spec ne doit modifier que specs/ et docs/

Critère de sortie

Spec validée, sans TODOs, avec plan de vérification et critères dacceptation.

Références

  • docs/AI_WORKFLOWS.md
  • docs/templates/ValidationPlan.md