0.0.1-beta.1

This commit is contained in:
2026-09-23 09:00:34 +02:00
parent 1aa4c0e0b7
commit f3e3253c71
9 changed files with 216 additions and 12 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: README.md --> <!-- file: README.md -->
<!-- version: 1 --> <!-- version: 2 -->
# Project Governance Rules # Project Governance Rules
@@ -25,7 +25,7 @@ La version courante est définie par [`VERSION`](VERSION). La première release
- [`docs/architecture/001-PROJECT_PROFILE.md`](docs/architecture/001-PROJECT_PROFILE.md) — profil applicable au dépôt PGR ; - [`docs/architecture/001-PROJECT_PROFILE.md`](docs/architecture/001-PROJECT_PROFILE.md) — profil applicable au dépôt PGR ;
- [`docs/architecture/002-GOVERNANCE_ARCHITECTURE.md`](docs/architecture/002-GOVERNANCE_ARCHITECTURE.md) — architecture du référentiel ; - [`docs/architecture/002-GOVERNANCE_ARCHITECTURE.md`](docs/architecture/002-GOVERNANCE_ARCHITECTURE.md) — architecture du référentiel ;
- [`docs/plans/001-V0_0_1_FOUNDATION_PLAN.md`](docs/plans/001-V0_0_1_FOUNDATION_PLAN.md) — plan actif de `0.0.1` ; - [`docs/plans/001-V0_0_1_FOUNDATION_PLAN.md`](docs/plans/001-V0_0_1_FOUNDATION_PLAN.md) — plan actif de `0.0.1` ;
- [`docs/validation/001-VALIDATION_MATRIX.md`](docs/validation/001-VALIDATION_MATRIX.md) — matrice de validation initiale. - [`docs/validation/001-VALIDATION_MATRIX.md`](docs/validation/001-VALIDATION_MATRIX.md) — matrice de validation.
## Langue et nomenclature ## Langue et nomenclature

View File

@@ -1 +1 @@
0.0.1-alpha.5 0.0.1-beta.1

132
deltas/0.0.1/beta.1.md Normal file
View File

@@ -0,0 +1,132 @@
<!-- file: deltas/0.0.1/beta.1.md -->
<!-- version: 1 -->
# Delta 0.0.1-beta.1 — foundation reconciliation
## Baseline
Version attendue avant application :
```text
0.0.1-alpha.5
```
Le history `history/0.0.1/alpha.5.md` MUST avoir été appliqué et committé avant ce delta.
Version après application :
```text
0.0.1-beta.1
```
## Objet
Réconcilier les documents vivants de la fondation après fermeture des tranches alpha, supprimer les formulations de cadrage devenues obsolètes et renforcer les contrôles de navigation/scope avant la release candidate.
## Scope
REPLACE :
```text
VERSION
README.md
docs/architecture/002-GOVERNANCE_ARCHITECTURE.md
docs/rules/000-README.md
docs/rules/200-GOVERNANCE.md
docs/rules/210-WORKFLOW.md
docs/validation/001-VALIDATION_MATRIX.md
```
ADD :
```text
deltas/0.0.1/beta.1.md
```
DELETE : aucun.
## Changements
- `VERSION` passe à `0.0.1-beta.1` ;
- les scopes de `200-GOVERNANCE` et `210-WORKFLOW` pointent maintenant vers les propriétaires normatifs effectivement créés pendant les alpha au lieu d'annoncer un travail futur ;
- la structure de croissance précise que les principes généraux restent dans `RULES.md` tant qu'une famille `100 — general` distincte n'apporte pas de valeur ;
- l'index des règles rend ce choix explicite sans créer de placeholder ;
- le README ne qualifie plus la matrice de validation d'« initiale » maintenant qu'elle est un document vivant établi ;
- la matrice ajoute des contrôles de navigation (`PGR-NAV-001`) et de cohérence des scopes documentaires (`PGR-SCOPE-001`) pour les phases de stabilisation ;
- aucun snapshot historique (`delta`, `history`, prompt initial) n'est réécrit pour refléter l'état courant.
## Validation opérateur
```bash
test "$(cat VERSION)" = "0.0.1-beta.1"
grep -F 'Les contrats détaillés des artefacts' docs/rules/200-GOVERNANCE.md
grep -F '210-WORKFLOW.md' docs/rules/200-GOVERNANCE.md
grep -F '400-VALIDATION.md' docs/rules/200-GOVERNANCE.md
grep -F 'Les règles détaillées de validation' docs/rules/210-WORKFLOW.md
grep -F '400-VALIDATION.md' docs/rules/210-WORKFLOW.md
if grep -F 'seront définis séparément' docs/rules/200-GOVERNANCE.md; then
echo '200-GOVERNANCE contient encore une promesse de tranche obsolète.' >&2
exit 1
fi
if grep -F 'seront formalisées dans `alpha.5`' docs/rules/210-WORKFLOW.md; then
echo '210-WORKFLOW contient encore une référence de cadrage obsolète à alpha.5.' >&2
exit 1
fi
grep -F 'La famille `100 — general` demeure réservée' docs/rules/000-README.md
grep -F 'Une famille dédiée `100 — general` n'"'"'est matérialisée que si' docs/architecture/002-GOVERNANCE_ARCHITECTURE.md
grep -F '`PGR-NAV-001`' docs/validation/001-VALIDATION_MATRIX.md
grep -F '`PGR-SCOPE-001`' docs/validation/001-VALIDATION_MATRIX.md
for file in \
RULES.md \
ROADMAP.md \
CHANGELOG.md \
docs/000-README.md \
docs/objectives/001-PROJECT_OBJECTIVES.md \
docs/architecture/001-PROJECT_PROFILE.md \
docs/architecture/002-GOVERNANCE_ARCHITECTURE.md \
docs/plans/001-V0_0_1_FOUNDATION_PLAN.md \
docs/rules/000-README.md \
docs/rules/200-GOVERNANCE.md \
docs/rules/210-WORKFLOW.md \
docs/rules/300-DOCUMENTATION.md \
docs/rules/400-VALIDATION.md \
docs/validation/001-VALIDATION_MATRIX.md; do
test -f "$file"
done
git diff --check
git add VERSION README.md docs/architecture/002-GOVERNANCE_ARCHITECTURE.md \
docs/rules/000-README.md docs/rules/200-GOVERNANCE.md docs/rules/210-WORKFLOW.md \
docs/validation/001-VALIDATION_MATRIX.md deltas/0.0.1/beta.1.md
git diff --cached --check
git status --short
```
La sortie attendue avant ajout du history est :
```text
M README.md
M VERSION
A deltas/0.0.1/beta.1.md
M docs/architecture/002-GOVERNANCE_ARCHITECTURE.md
M docs/rules/000-README.md
M docs/rules/200-GOVERNANCE.md
M docs/rules/210-WORKFLOW.md
M docs/validation/001-VALIDATION_MATRIX.md
```
## Transition
PASS : enregistrer `history/0.0.1/beta.1.md`, committer `beta.1`, puis passer à `0.0.1-rc.1`.
FAIL : rester dans `beta.1` avec `beta.1.fix.1`, sauf REPLAN si la réconciliation révèle une contradiction structurelle de la fondation.

View File

@@ -1,5 +1,5 @@
<!-- file: docs/architecture/002-GOVERNANCE_ARCHITECTURE.md --> <!-- file: docs/architecture/002-GOVERNANCE_ARCHITECTURE.md -->
<!-- version: 1 --> <!-- version: 2 -->
# Architecture de gouvernance PGR # Architecture de gouvernance PGR
@@ -65,7 +65,9 @@ Les règles project-specific restent dans le dépôt qui les possède.
PGR crée ses collections et familles de règles lorsque leur premier contenu réel apparaît. Les répertoires vides et les documents placeholders sont évités. PGR crée ses collections et familles de règles lorsque leur premier contenu réel apparaît. Les répertoires vides et les documents placeholders sont évités.
Les futures familles pourront notamment couvrir : Les principes généraux actuellement suffisants restent possédés par le `RULES.md` racine. Une famille dédiée `100 — general` n'est matérialisée que si un corpus général distinct devient réellement utile.
Les familles de croissance peuvent notamment couvrir :
```text ```text
general general
@@ -79,4 +81,4 @@ architecture
project-specific rules project-specific rules
``` ```
sans exiger leur matérialisation complète pendant `0.0.1-alpha.1`. Cette classification guide la navigation sans imposer la création anticipée de fichiers ou répertoires vides.

View File

@@ -1,5 +1,5 @@
<!-- file: docs/rules/000-README.md --> <!-- file: docs/rules/000-README.md -->
<!-- version: 5 --> <!-- version: 6 -->
# Index des règles PGR # Index des règles PGR
@@ -7,6 +7,8 @@ Les règles détaillées de Project Governance Rules sont organisées ici progre
`RULES.md` reste le point d'entrée normatif du dépôt et définit les principes fondamentaux, la force normative et la hiérarchie générale. `RULES.md` reste le point d'entrée normatif du dépôt et définit les principes fondamentaux, la force normative et la hiérarchie générale.
Les règles générales actuellement nécessaires restent dans `RULES.md`. La famille `100 — general` demeure réservée et n'est pas matérialisée tant qu'un document dédié n'apporte pas une meilleure séparation de responsabilités.
## Familles actives ## Familles actives
- [`200-GOVERNANCE.md`](200-GOVERNANCE.md) — versioning, lifecycle des releases, fixes, cadrage, replan et abandon/supersession. - [`200-GOVERNANCE.md`](200-GOVERNANCE.md) — versioning, lifecycle des releases, fixes, cadrage, replan et abandon/supersession.

View File

@@ -1,5 +1,5 @@
<!-- file: docs/rules/200-GOVERNANCE.md --> <!-- file: docs/rules/200-GOVERNANCE.md -->
<!-- version: 1 --> <!-- version: 2 -->
# Governance rules # Governance rules
@@ -7,7 +7,7 @@
Ce document définit les règles communes de versioning et de lifecycle des releases gouvernées par PGR. Ce document définit les règles communes de versioning et de lifecycle des releases gouvernées par PGR.
Les contrats détaillés des artefacts `delta`, `history`, `handoff`, `manifest` et `prompt` sont hors scope de cette tranche et seront définis séparément. Les contrats détaillés des artefacts `delta`, `history`, `handoff`, `manifest` et `prompt` appartiennent à [`210-WORKFLOW.md`](210-WORKFLOW.md). Les règles de preuve et de gate appartiennent à [`400-VALIDATION.md`](400-VALIDATION.md).
## Principe de proportionnalité ## Principe de proportionnalité

View File

@@ -1,5 +1,5 @@
<!-- file: docs/rules/210-WORKFLOW.md --> <!-- file: docs/rules/210-WORKFLOW.md -->
<!-- version: 1 --> <!-- version: 2 -->
# Workflow artifact rules # Workflow artifact rules
@@ -9,7 +9,7 @@ Ce document définit les contrats communs des artefacts de workflow gouvernés p
Il couvre les plans, deltas, histories, prompts, handoffs, manifests de suppression, commits de tranche, reprise de session et baselines stables. Il couvre les plans, deltas, histories, prompts, handoffs, manifests de suppression, commits de tranche, reprise de session et baselines stables.
Les règles détaillées de validation et la taxonomie TEST / AUDIT / DIAGNOSTIC restent hors scope de cette tranche et seront formalisées dans `alpha.5`. Les règles détaillées de validation et la taxonomie des preuves appartiennent à [`400-VALIDATION.md`](400-VALIDATION.md).
## Principe général ## Principe général

View File

@@ -1,5 +1,5 @@
<!-- file: docs/validation/001-VALIDATION_MATRIX.md --> <!-- file: docs/validation/001-VALIDATION_MATRIX.md -->
<!-- version: 3 --> <!-- version: 4 -->
# Matrice de validation PGR # Matrice de validation PGR
@@ -19,6 +19,8 @@ Les catégories et règles de sélection sont définies dans [`../rules/400-VALI
| `PGR-VERSION-001` | `CHECK` | comparer `VERSION` à la version attendue par le delta courant | fichier `VERSION` | changement de tranche/version | alpha/beta/RC/stable | faible | opérateur | | `PGR-VERSION-001` | `CHECK` | comparer `VERSION` à la version attendue par le delta courant | fichier `VERSION` | changement de tranche/version | alpha/beta/RC/stable | faible | opérateur |
| `PGR-LAYOUT-001` | `AUDIT` | comparer les fichiers ajoutés/remplacés/supprimés au scope déclaré du delta | scope du delta | changement de structure | alpha/beta/RC/stable | faible | opérateur/revue | | `PGR-LAYOUT-001` | `AUDIT` | comparer les fichiers ajoutés/remplacés/supprimés au scope déclaré du delta | scope du delta | changement de structure | alpha/beta/RC/stable | faible | opérateur/revue |
| `PGR-DOC-001` | `AUDIT` | vérifier headers `file/version`, chemins, liens et responsabilités des documents touchés | fichiers documentaires | modification documentaire | alpha/beta/RC/stable | faible | opérateur/revue | | `PGR-DOC-001` | `AUDIT` | vérifier headers `file/version`, chemins, liens et responsabilités des documents touchés | fichiers documentaires | modification documentaire | alpha/beta/RC/stable | faible | opérateur/revue |
| `PGR-NAV-001` | `AUDIT` | vérifier que les points d'entrée et liens canoniques ciblent des fichiers existants | index et docs racine | navigation ou réconciliation | beta/RC/stable | faible | opérateur/revue |
| `PGR-SCOPE-001` | `AUDIT` | vérifier que les documents vivants pointent vers les propriétaires normatifs actuels | documents vivants | réconciliation de phase | beta/RC/stable | faible | revue |
| `PGR-STATUS-001` | `CHECK` | `git status --short` | Git | avant fermeture d'une tranche | alpha/beta/RC/stable | faible | opérateur | | `PGR-STATUS-001` | `CHECK` | `git status --short` | Git | avant fermeture d'une tranche | alpha/beta/RC/stable | faible | opérateur |
Un contrôle manuel peut rester dans la matrice lorsqu'aucun audit automatisé fiable n'existe encore. PGR SHOULD automatiser uniquement les propriétés stables et objectivement contrôlables. Un contrôle manuel peut rester dans la matrice lorsqu'aucun audit automatisé fiable n'existe encore. PGR SHOULD automatiser uniquement les propriétés stables et objectivement contrôlables.

66
history/0.0.1/beta.1.md Normal file
View File

@@ -0,0 +1,66 @@
<!-- file: history/0.0.1/beta.1.md -->
<!-- version: 1 -->
# History 0.0.1-beta.1 — foundation reconciliation
## Statut
PASS
La réconciliation de la fondation `0.0.1` a été validée par l'opérateur sans fix supplémentaire.
## Baseline
Version validée par l'opérateur :
```text
0.0.1-beta.1
```
Le delta `0.0.1-beta.1` a été appliqué après commit de `0.0.1-alpha.5` avec son history `PASS`.
## Validation opérateur observée
L'opérateur a confirmé :
- la version `0.0.1-beta.1` ;
- le remplacement des formulations de cadrage devenues obsolètes dans `200-GOVERNANCE.md` et `210-WORKFLOW.md` ;
- les liens vers les propriétaires normatifs actuels `210-WORKFLOW.md` et `400-VALIDATION.md` ;
- l'absence des anciennes promesses de travail futur ciblées par le delta ;
- le choix explicite de ne pas matérialiser la famille `100 — general` tant qu'elle n'apporte pas de séparation utile ;
- la présence des contrôles `PGR-NAV-001` et `PGR-SCOPE-001` dans la matrice de validation ;
- la présence de tous les documents de fondation requis par la gate.
Les contrôles Git ont ensuite été exécutés :
```bash
git diff --check
git add VERSION README.md docs/architecture/002-GOVERNANCE_ARCHITECTURE.md \
docs/rules/000-README.md docs/rules/200-GOVERNANCE.md docs/rules/210-WORKFLOW.md \
docs/validation/001-VALIDATION_MATRIX.md deltas/0.0.1/beta.1.md
git diff --cached --check
git status --short
```
`git diff --cached --check` n'a produit aucun diagnostic.
La sortie finale observée avant ajout du présent history était :
```text
M README.md
M VERSION
A deltas/0.0.1/beta.1.md
M docs/architecture/002-GOVERNANCE_ARCHITECTURE.md
M docs/rules/000-README.md
M docs/rules/200-GOVERNANCE.md
M docs/rules/210-WORKFLOW.md
M docs/validation/001-VALIDATION_MATRIX.md
```
## Résultat
`beta.1` est validée sans fix ni REPLAN.
La tranche suivante est `0.0.1-rc.1`. Son scope est gelé : elle prépare les métadonnées de release, le changelog candidat et le prompt `0.0.2`, puis exécute la gate documentaire complète de la fondation.