Sasedev/pgr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

0.1.5-alpha.4

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-10-01 10:25:20 +02:00
parent 7079b150a8
commit 43ee26b856
9 changed files with 365 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
docs/objectives/001-PROJECT_OBJECTIVES.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/objectives/001-PROJECT_OBJECTIVES.md -->
<!-- version: 1 -->
<!-- version: 2 -->
# Objectifs de Project Governance Rules
@@ -18,9 +18,11 @@ PGR doit permettre de :
- favoriser des validations ciblées pendant le développement et des gates plus larges aux jalons appropriés ;
- automatiser les contrôles déterministes et fiables sans automatiser artificiellement les décisions nécessitant du jugement ;
- fournir des templates techniques éprouvés sans créer de dépendance vers PGR après instanciation ;
- décrire des skeletons de projets sous forme de recettes Markdown composables plutôt que de générateurs rigides ;
- décrire des skeletons de projets sous forme de spécifications Markdown composables plutôt que de générateurs rigides ;
- supporter plusieurs langages, plateformes et frameworks sans chercher une uniformité artificielle ;
- conserver une traçabilité historique utile tout en gardant les documents vivants lisibles ;
- rester auto-suffisant pour comprendre et appliquer les contrats normatifs PGR, sans dépendre d’un howto, snippet ou dépôt documentaire externe ;
- permettre que les howtos détaillés, recettes pratiques, snippets, exemples d’intégration, dépannage, comparatifs et variantes d’implémentation vivent dans une base de connaissances séparée lorsqu’une telle séparation apporte une valeur réelle ;
- permettre des règles project-specific et des exceptions explicites sans contaminer les règles générales ;
- privilégier la sécurité, l'explicité, la maintenabilité et la proportionnalité.
@@ -45,6 +47,7 @@ PGR n'a pas pour objectif de :
- créer des audits regex pour remplacer le jugement architectural ;
- réimplémenter les fonctionnalités des toolchains officielles sans bénéfice réel ;
- maintenir automatiquement les projets créés à partir de PGR ;
- devenir une base exhaustive de howtos, recettes, snippets ou dépannage lorsque ces contenus ne sont pas nécessaires pour comprendre ou appliquer un contrat PGR ;
- imposer une stratégie Git complexe ou une topologie universelle de branches.
## Critères de succès à terme