bruno
ce23ab38f7
- ROADMAP: ne garde que le travail a venir + index compact du complete (995 -> ~155 lignes); detail deplace vers docs/features/ et docs/archive/ - docs/features/: fiches detaillees #74, #75, #76, #77, #78, #79 - docs/archive/COMPLETED_v1-v2.md: detail des items courts livres - CHANGELOG: alignement sur les tags (2.0.0 date, 2.2.0/2.2.1 ajoutes, Unreleased = travail #79 post-2.2.1) - AGENTS.md + docs/DELIVERY_WORKFLOW.md: methode de livraison unique (Definition of Done) referencee par ROADMAP, CONTRIBUTING, ISSUES_TODOLIST
46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# 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`](./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
|
|
|
|
1. Lire [`docs/ROADMAP.md`](./docs/ROADMAP.md) (travail à venir + index) et
|
|
[`docs/ISSUES_TODOLIST.md`](./docs/ISSUES_TODOLIST.md) (bugs).
|
|
2. Identifier ou créer l'**ID stable** (`#NN` pour une feature, `BUG-NNN` pour 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 (`E2E` si UI).
|
|
- Mettre à jour la documentation requise : `CHANGELOG.md` (`[Unreleased]`), `docs/ROADMAP.md`
|
|
(statut + index), fiche `docs/features/` **ou** `docs/archive/`, `docs/ISSUES_TODOLIST.md`,
|
|
guide utilisateur i18n FR/EN + README si impact utilisateur.
|
|
- **Commit** conventionnel référençant l'ID, puis **push**.
|
|
- 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` |
|
|
| 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.
|