0.1.10 — Rendre le dépôt agent-friendly avec AGENTS.md #10

Closed
opened 2026-08-20 18:11:32 +00:00 by lfabry · 0 comments
Owner

Description

Créer le premier contrat entre le dépôt et les agents IA susceptibles d'y travailler.

Un agent arrivant dans le repository doit savoir rapidement quel est le projet, quel est le périmètre actuel, où se trouve le domaine, quelles contraintes architecturales ne doivent pas être violées et comment vérifier son travail.

AGENTS.md ne doit pas devenir une encyclopédie. Il doit principalement servir à empêcher les erreurs coûteuses et orienter vers les bonnes sources.

Definition of Done — technique

  • Un AGENTS.md existe à la racine.
  • Il indique l'objectif actuel du projet et le jalon en cours.
  • Il indique les principaux répertoires.
  • Il indique les contraintes architecturales importantes.
  • Il indique les commandes de build, test, lint, typecheck et verify.
  • Il indique la localisation des specs et ADR.
  • Il indique les attentes de preuve avant de considérer une tâche terminée.
  • Il indique explicitement que le domaine ne doit pas dépendre de NestJS ou de l'infrastructure.
  • Il demande de consulter les specs avant de modifier une règle métier.
  • Il ne duplique pas inutilement toute la documentation d'architecture.
  • Les instructions sont suffisamment concrètes pour être exécutées par un agent sans contexte conversationnel.
  • Une relecture manuelle depuis le point de vue d'un nouvel arrivant ne révèle aucune étape indispensable cachée uniquement dans le chat.
## Description Créer le premier contrat entre le dépôt et les agents IA susceptibles d'y travailler. Un agent arrivant dans le repository doit savoir rapidement quel est le projet, quel est le périmètre actuel, où se trouve le domaine, quelles contraintes architecturales ne doivent pas être violées et comment vérifier son travail. `AGENTS.md` ne doit pas devenir une encyclopédie. Il doit principalement servir à empêcher les erreurs coûteuses et orienter vers les bonnes sources. ## Definition of Done — technique - [ ] Un `AGENTS.md` existe à la racine. - [ ] Il indique l'objectif actuel du projet et le jalon en cours. - [ ] Il indique les principaux répertoires. - [ ] Il indique les contraintes architecturales importantes. - [ ] Il indique les commandes de build, test, lint, typecheck et verify. - [ ] Il indique la localisation des specs et ADR. - [ ] Il indique les attentes de preuve avant de considérer une tâche terminée. - [ ] Il indique explicitement que le domaine ne doit pas dépendre de NestJS ou de l'infrastructure. - [ ] Il demande de consulter les specs avant de modifier une règle métier. - [ ] Il ne duplique pas inutilement toute la documentation d'architecture. - [ ] Les instructions sont suffisamment concrètes pour être exécutées par un agent sans contexte conversationnel. - [ ] Une relecture manuelle depuis le point de vue d'un nouvel arrivant ne révèle aucune étape indispensable cachée uniquement dans le chat.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
lfabry/LaGuerreDuPeloton#10
No description provided.