Skip to content

README.fr.md

Latest commit

 

History

History
110 lines (83 loc) · 4.31 KB

README.fr.md

File metadata and controls

110 lines (83 loc) · 4.31 KB
Raw
Animation du slogan AgentGit

AgentGit

Orchestration multi-agents git-native. Les agents travaillent sur des branches isolées. Rien n'est fusionné sans une porte de validation réelle et déterministe.

License: MIT npm version Build Status PRs Welcome GitHub stars

English · Français · Spécification du protocole · Architecture · Comparaison

Positionnement, en une phrase

Les protocoles de coordination comme gnap répondent à quel agent possède quelle tâche. AgentGit répond à la question qu'ils laissent volontairement ouverte : comment le travail d'une tâche est-il validé et fusionné sans faire confiance à la seule parole d'un agent ?

Le détail complet : docs/fr/comparaison.md.

Fonctionnement

Orchestrateur
     │
  ┌──┼──┐
Agent Agent Agent      ← chacun sur sa propre branche, son propre workspace
  │    │    │
Commit Commit Commit
  └──┼──┘
     │
scripts/validate.sh      ← exécute une vraie commande, lit un vrai code de sortie
     │
  passe ? ── non ──▶ tâche marquée "rejected", retour à l'agent
     │
    oui
     │
scripts/merge.sh         ← refuse de s'exécuter tant que l'état n'est pas "approved"
     │
   main

Aucune tâche n'atteint main parce qu'un agent l'a dit. Elle l'atteint parce que scripts/validate.sh a exécuté une commande et obtenu le code de sortie 0. C'est toute la proposition de valeur — tout le reste de ce dépôt sert cette seule règle.

Démarrage rapide

cd ton-depot
npx agentgit init
npx agentgit create-task "Add OAuth callback handler"
npx agentgit status

# un agent (ou toi) fait le travail sur la branche créée, puis :
npx agentgit validate AG-1
npx agentgit merge AG-1     # ne réussit que si AG-1 est "approved"

Tu n'as même pas besoin du CLI — .agentgit/ est du JSON simple et documenté. Voir docs/fr/protocole.md pour le format de fichiers, et examples/.agentgit/ pour un exemple fonctionnel.

Principes de conception

  • Git, pas GitHub. Le cœur ne parle jamais qu'à un dépôt Git local. Aucune API de plateforme d'hébergement requise. Voir docs/fr/architecture.md.
  • Le format de fichiers est le contrat, pas le CLI. Tout agent capable de lire des fichiers et de lancer git peut participer — dans n'importe quel langage, sur n'importe quel runtime.
  • La validation est déterministe, sinon elle ne compte pas. Pas de « l'agent dit que ça passe ». Une vraie commande, un vrai code de sortie.
  • Cœur restreint, limites honnêtes. Voir ce qui est explicitement hors périmètre dans docs/fr/architecture.md#limite-du-mvp.

Où se trouve quoi

Carte complète (pour les humains et pour les agents IA qui naviguent dans ce code) : MAP.md.

État du projet

Pré-alpha. Les portes de validation et de fusion (scripts/validate.sh, scripts/merge.sh) sont implémentées et testées de bout en bout. Le découpage automatique des tâches, un agent reviewer, et un tableau de bord ne sont pas encore construits — voir CHANGELOG.md et la limite du MVP dans docs/fr/architecture.md.

Contribuer

Voir CONTRIBUTING.fr.md (anglais : CONTRIBUTING.md).

Licence

MIT