Files
Kill_LIFE/docs/plans/03_plan_specification.md
T
Clément SAILLANT d7ffbf14cf feat: Add workflows and templates for design reviews, release processes, and compliance checks
- Introduced new documentation for design reviews (DR0/DR1) and release rituals.
- Created templates for Architecture Decision Records (ADR), Design Reviews, Playtest Reports, and Validation Plans.
- Established workflows for consulting, creative processes, systems engineering, R&D spikes, and compliance/QA.
- Implemented GitHub Actions workflows for firmware and hardware CI with required checks strategy.
- Added setup script for repository configuration, including label creation and branch protection.
- Developed installation script for Kill_LIFE with system updates and environment setup.
2026-02-19 01:35:10 +01:00

1.6 KiB
Raw 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
  • Ajouter requirements.md (RFC2119)
  • Ajouter verification.md (tests/mesures)

2. Écrire les exigences RFC2119

Checklist :

  • MUST/SHOULD/MAY, phrases courtes
  • Pas dambiguïté (“rapide”, “simple”) sans métrique
  • Chaque exigence doit être vérifiable

3. Critères dacceptation

  • AC fonctionnels
  • AC nonfonctionnels (latence, conso, stabilité)

4. Plan de vérification

  • Unit tests (native)
  • Tests intégration (HIL si hardware)
  • Mesures (power profiling, timing)

5. Validation

  • Lancer la validation specs (si script dispo)

Exemple :

python 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