bruno
0841778b99
AGENTS.md : la checklist de fin de tache rappelle que VERSION est la source unique de verite, incrementee a chaque commit par le hook, avec resynchronisation des derives et publication du tag au push ; ligne ajoutee a la cartographie documentaire. Suppression des captures de diagnostic (diag-*.png, ogdiag.png, state.png) et du script jetable tmp-verify-inline.cjs.
2.8 KiB
2.8 KiB
AGENTS.md — Instructions obligatoires du dépôt ObsiGate
Ces instructions s'appliquent à toute intervention (humaine ou IA) sur ce dépôt.
Règle n°1 — Méthode de livraison unique
Avant toute tâche (fonctionnalité, bug, refactor), lire et appliquer
docs/DELIVERY_WORKFLOW.md (Definition of Done).
Aucune tâche n'est terminée avant que sa checklist soit complète et le CI vert.
Avant de commencer
- Lire
docs/ROADMAP.md(travail à venir + index) etdocs/ISSUES_TODOLIST.md(bugs). - Identifier ou créer l'ID stable (
#NNpour une feature,BUG-NNNpour un bug) et passer son statut à « en cours » avant de coder.
À la fin de chaque tâche (obligatoire)
- Ajouter/mettre à jour les tests unitaires.
- Vérifications locales vertes :
pytest,ruff,mypy, tests frontend (E2Esi UI). - Mettre à jour la documentation requise :
CHANGELOG.md([Unreleased]),docs/ROADMAP.md(statut + index), fichedocs/features/oudocs/archive/,docs/ISSUES_TODOLIST.md, guide utilisateur i18n FR/EN + README si impact utilisateur. - Commit conventionnel référençant l'ID, puis push.
- Version : le fichier VERSION (racine du dépôt) est la source unique de vérité (MAJEUR.MINEUR.CORRECTIF), incrémenté automatiquement à chaque commit par le hook .githooks/prepare-commit-msg — feat → mineur, !: / BREAKING CHANGE → majeur, sinon correctif. Le même commit resynchronise package.json, le desktop Tauri, README.md/ README.fr.md, docs/ROADMAP.md et publie la section [Unreleased] du CHANGELOG.md en [X.Y.Z] — date ; le tag vX.Y.Z est créé au commit et publié au push (push.followTags). Hooks à installer une fois par clone : scripts/install-hooks.sh. Garde-fou : tests/test_version.py (détail : docs/DELIVERY_WORKFLOW.md §7).
- Vérifier le CI Gitea vert (jobs
lint,test,security,build,e2e).
Cartographie documentaire
| Sujet | Fichier |
|---|---|
| Méthode de livraison / DoD | docs/DELIVERY_WORKFLOW.md |
| Version livrée (source unique) | VERSION + scripts/bump_version.py |
| Travail à venir + index | docs/ROADMAP.md |
| Historique des versions | CHANGELOG.md |
| Conception par feature | docs/features/<slug>.md |
| Archive du complété | docs/archive/COMPLETED_v1-v2.md |
| Bugs / TODO | docs/ISSUES_TODOLIST.md |
| Build & releases | docs/DEVELOPMENT_AND_RELEASES.md |
| Standards de code | docs/CONTRIBUTING.md |
Conventions
- Commits :
type: description—feat,fix,perf,refactor,docs,style,chore,test. - Ne jamais committer de secrets, clés ou tokens.
- Réponses et documentation en français ; respecter le style du code existant.