91 lines
2.7 KiB
Markdown
91 lines
2.7 KiB
Markdown
<!-- file: deltas/0.0.1/alpha.3.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.0.1-alpha.3 — workflow artifacts
|
|
|
|
## Baseline
|
|
|
|
Version attendue avant application :
|
|
|
|
```text
|
|
0.0.1-alpha.2
|
|
```
|
|
|
|
Le history `history/0.0.1/alpha.2.md` MUST avoir été appliqué et committé avant ce delta.
|
|
|
|
Version après application :
|
|
|
|
```text
|
|
0.0.1-alpha.3
|
|
```
|
|
|
|
## Objet
|
|
|
|
Formaliser les contrats des artefacts workflow et surtout leur ordre d'application, afin qu'une tranche validée et son history soient committés avant l'application du delta suivant.
|
|
|
|
## Scope
|
|
|
|
REPLACE :
|
|
|
|
```text
|
|
VERSION
|
|
RULES.md
|
|
docs/rules/000-README.md
|
|
```
|
|
|
|
ADD :
|
|
|
|
```text
|
|
docs/rules/210-WORKFLOW.md
|
|
deltas/0.0.1/alpha.3.md
|
|
```
|
|
|
|
DELETE : aucun.
|
|
|
|
## Changements
|
|
|
|
- `VERSION` passe à `0.0.1-alpha.3` ;
|
|
- le workflow canonique devient `delta → validate → history → commit → next delta` ;
|
|
- un FAIL peut être committé avec son history avant le fix qui le corrige ;
|
|
- les contrats de plan, delta, history, prompt, handoff et manifest sont définis ;
|
|
- les archives delta/history restent séparées ;
|
|
- les suppressions peuvent utiliser un manifest exact lorsqu'elles existent réellement ;
|
|
- une interruption de session utilise un handoff si nécessaire et ne crée pas une nouvelle version ;
|
|
- la baseline source stable peut être l'archive issue du tag canonique, sans exiger `.git` ;
|
|
- validation pré-tag et vérification post-tag sont distinguées ;
|
|
- aucun répertoire workflow vide n'est imposé.
|
|
|
|
## Validation opérateur
|
|
|
|
```bash
|
|
test "$(cat VERSION)" = "0.0.1-alpha.3"
|
|
|
|
test -f docs/rules/210-WORKFLOW.md
|
|
|
|
grep -Fx '<!-- file: docs/rules/210-WORKFLOW.md -->' docs/rules/210-WORKFLOW.md
|
|
grep -F 'delta N+1' docs/rules/210-WORKFLOW.md
|
|
grep -F 'Le history MUST être appliqué avant le commit de la tranche qu'"'"'il constate.' docs/rules/210-WORKFLOW.md
|
|
grep -F 'Le delta suivant MUST NOT être appliqué avant le commit de la tranche courante' docs/rules/210-WORKFLOW.md
|
|
grep -F '<project>-<X.Y.Z>-<tranche>.delta.zip' docs/rules/210-WORKFLOW.md
|
|
grep -F 'manifests/X.Y.Z/<tranche>.delete.txt' docs/rules/210-WORKFLOW.md
|
|
grep -F 'prompts/NNN-VX_Y_Z_START_PROMPT.md' docs/rules/210-WORKFLOW.md
|
|
grep -F 'handoffs/X.Y.Z/NNN-TYPE-<description>.md' docs/rules/210-WORKFLOW.md
|
|
|
|
git diff --check
|
|
|
|
git add VERSION RULES.md docs/rules/000-README.md docs/rules/210-WORKFLOW.md \
|
|
deltas/0.0.1/alpha.3.md
|
|
|
|
git diff --cached --check
|
|
|
|
git status --short
|
|
```
|
|
|
|
La revue opérateur vérifie également que `alpha.3` ne crée aucun répertoire vide `handoffs/` ou `manifests/` uniquement pour satisfaire la documentation.
|
|
|
|
## Transition
|
|
|
|
PASS : enregistrer `history/0.0.1/alpha.3.md`, committer `alpha.3`, puis passer à `0.0.1-alpha.4`.
|
|
|
|
FAIL : rester dans `alpha.3` avec `alpha.3.fix.1`, sauf REPLAN si le défaut remet en cause le scope ou le plan.
|