<!-- file: deltas/0.0.3/alpha.5.md -->
<!-- version: 1 -->

# Delta 0.0.3-alpha.5 — audit des headers Markdown

## Baseline et version

Baseline : `0.0.3-alpha.4`, avec `history/0.0.3/alpha.4.md` appliqué et committé. Ce delta MUST NOT être appliqué avant ce commit.

Version avant application :

```text
0.0.3-alpha.4
```

Version après application :

```text
0.0.3-alpha.5
```

## Objet

Extraire le contrôle des headers Markdown répété en Python inline dans les gates précédentes. `scripts/audit_markdown_headers.py` vérifie une seule propriété documentaire : les deux premières lignes de chaque fichier choisi doivent déclarer son chemin relatif canonique et une révision interne positive. Le script accepte des chemins explicites depuis la racine du projet, lit sans modifier, produit des erreurs déterministes avec chemin et ligne et distingue violation de sélection invalide.

`docs/rules/300-DOCUMENTATION.md` possède la convention pour le corpus Markdown de PGR. La matrice inscrit l'audit mécanique séparément de la revue des rôles documentaires, de l'audit des tableaux et de celui des liens. Une révision positive ne démontre pas qu'elle a été incrémentée à bon escient : cela reste une décision de revue.

## Scope

REPLACE :

```text
VERSION
docs/rules/300-DOCUMENTATION.md
docs/validation/001-VALIDATION_MATRIX.md
```

ADD :

```text
scripts/audit_markdown_headers.py
tests/test_markdown_headers.py
deltas/0.0.3/alpha.5.md
```

DELETE : aucun.

L'archive livre uniquement ces fichiers complets. Aucun history `alpha.5`, réécriture historique, nouveau profil de langage ou autre audit Markdown n'est inclus.

## Validation opérateur

Après application sur le commit `alpha.4`, depuis la racine du dépôt :

```bash
test "$(cat VERSION)" = '0.0.3-alpha.5'
git cat-file -e HEAD:history/0.0.3/alpha.4.md
test -f history/0.0.3/alpha.4.md
test -f deltas/0.0.3/alpha.5.md
test ! -e history/0.0.3/alpha.5.md

grep -Fx '<!-- version: 2 -->' docs/rules/300-DOCUMENTATION.md
grep -Fx '<!-- version: 8 -->' docs/validation/001-VALIDATION_MATRIX.md

python3 -B -m unittest discover -s tests -p test_markdown_headers.py -v
python3 -B scripts/audit_markdown_headers.py \
    README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts
python3 -B scripts/audit_markdown_tables.py \
    README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts
python3 -B scripts/audit_markdown_links.py \
    README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts

git diff --check
git add VERSION docs/rules/300-DOCUMENTATION.md \
    docs/validation/001-VALIDATION_MATRIX.md scripts/audit_markdown_headers.py \
    tests/test_markdown_headers.py deltas/0.0.3/alpha.5.md
git diff --cached --check
git status --short
```

Scope attendu avant ajout du history : trois `REPLACE` et trois `ADD`, sans toucher à un delta ou history antérieur. Vérifier que le nouveau script reste monotâche, traite les headers faux et les chemins absents, et ne remplace ni la revue des documents ni les deux autres audits Markdown.

## Transition

### PASS

Produire séparément `history/0.0.3/alpha.5.md` avec les preuves réellement observées, l'appliquer et committer avant la tranche `alpha.6`, consacrée à la décision conditionnelle sur le template de workflow.

### FAIL

Enregistrer la défaillance et corriger ce scope dans `alpha.5.fix.1`, sauf REPLAN explicitement justifié.