<!-- file: docs/validation/001-VALIDATION_MATRIX.md -->
<!-- version: 1 -->

# Matrice de validation PGR

## Rôle

Cette matrice décrit les validations canoniques du dépôt PGR. Elle évoluera avec le projet et ne doit pas inventer des scripts uniquement pour remplir une case.

`0.0.1-alpha.1` est une tranche documentaire de bootstrap sans toolchain applicative. Les premiers contrôles sont donc volontairement simples.

## Commandes initiales

| ID                      | Catégorie | Commande / contrôle                                                                      | Trigger                                    | Phase                |
|-------------------------|-----------|------------------------------------------------------------------------------------------|--------------------------------------------|----------------------|
| `PGR-GIT-001`           | CHECK     | `git diff --check`                                                                       | toute modification suivie par Git          | alpha/beta/RC/stable |
| `PGR-GIT-BOOTSTRAP-001` | CHECK     | `git add .` puis `git diff --cached --check`                                             | bootstrap ou fichiers entièrement nouveaux | alpha.1/bootstrap    |
| `PGR-VERSION-001`       | CHECK     | `test "$(cat VERSION)" = "0.0.1-alpha.1"`                                                | tranche `0.0.1-alpha.1`                    | alpha.1              |
| `PGR-LAYOUT-001`        | REVIEW    | `find . -type f -not -path './.git/*' -print` puis comparaison au scope du delta         | ajout/suppression/déplacement de fichiers  | alpha/beta/RC/stable |
| `PGR-DOC-001`           | REVIEW    | vérifier headers `file/version`, chemins, liens et responsabilités des documents touchés | modification documentaire                  | alpha/beta/RC/stable |
| `PGR-STATUS-001`        | CHECK     | `git status --short`                                                                     | avant fermeture d'une tranche              | alpha/beta/RC/stable |

## Gate `0.0.1-alpha.1`

Après application du delta :

```bash
git status --short

test "$(cat VERSION)" = "0.0.1-alpha.1"

find . -type f -not -path './.git/*' -print

git add .
git diff --cached --check

git status --short
```

L'opérateur vérifie également que :

- `.project`, `.classpath` et `.settings/` Eclipse restent locaux/ignorés ;
- aucun répertoire vide n'a été ajouté uniquement pour anticiper le futur ;
- les fichiers listés par le delta sont les seuls fichiers PGR introduits par la tranche ;
- les headers `file/version` correspondent aux chemins réels ;
- `VERSION` contient exactement une ligne `0.0.1-alpha.1` ;
- les liens Markdown de navigation principaux sont cohérents ;
- aucun secret, chemin machine absolu ou artefact local n'est introduit.

## Autorité de validation

Une validation n'est `PASS` qu'après exécution réelle du gate opérateur. La génération du delta ou une prévalidation par l'IA ne constitue pas le résultat opérateur.

Après `PASS`, la tranche suivante doit enregistrer `history/0.0.1/alpha.1.md` séparément avant le commit de l'état validé et fournir le delta suivant conformément au workflow PGR retenu.