diff --git a/README.md b/README.md index 7b8a07e..a3e28e1 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ - + # 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/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/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 diff --git a/VERSION b/VERSION index aa5f806..7390193 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.0.1-alpha.5 +0.0.1-beta.1 diff --git a/deltas/0.0.1/beta.1.md b/deltas/0.0.1/beta.1.md new file mode 100644 index 0000000..aa6583a --- /dev/null +++ b/deltas/0.0.1/beta.1.md @@ -0,0 +1,132 @@ + + + +# 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. diff --git a/docs/architecture/002-GOVERNANCE_ARCHITECTURE.md b/docs/architecture/002-GOVERNANCE_ARCHITECTURE.md index 7776d87..6a9066e 100644 --- a/docs/architecture/002-GOVERNANCE_ARCHITECTURE.md +++ b/docs/architecture/002-GOVERNANCE_ARCHITECTURE.md @@ -1,5 +1,5 @@ - + # 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. -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 general @@ -79,4 +81,4 @@ architecture 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. diff --git a/docs/rules/000-README.md b/docs/rules/000-README.md index 67239c8..ffc1314 100644 --- a/docs/rules/000-README.md +++ b/docs/rules/000-README.md @@ -1,5 +1,5 @@ - + # 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. +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 - [`200-GOVERNANCE.md`](200-GOVERNANCE.md) — versioning, lifecycle des releases, fixes, cadrage, replan et abandon/supersession. diff --git a/docs/rules/200-GOVERNANCE.md b/docs/rules/200-GOVERNANCE.md index 7159be8..02c1a32 100644 --- a/docs/rules/200-GOVERNANCE.md +++ b/docs/rules/200-GOVERNANCE.md @@ -1,5 +1,5 @@ - + # 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. -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é diff --git a/docs/rules/210-WORKFLOW.md b/docs/rules/210-WORKFLOW.md index 021e98e..553d953 100644 --- a/docs/rules/210-WORKFLOW.md +++ b/docs/rules/210-WORKFLOW.md @@ -1,5 +1,5 @@ - + # 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. -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 diff --git a/docs/validation/001-VALIDATION_MATRIX.md b/docs/validation/001-VALIDATION_MATRIX.md index da98124..7790cec 100644 --- a/docs/validation/001-VALIDATION_MATRIX.md +++ b/docs/validation/001-VALIDATION_MATRIX.md @@ -1,5 +1,5 @@ - + # 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-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-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 | 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. diff --git a/history/0.0.1/beta.1.md b/history/0.0.1/beta.1.md new file mode 100644 index 0000000..8c412a0 --- /dev/null +++ b/history/0.0.1/beta.1.md @@ -0,0 +1,66 @@ + + + +# 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.