tour 0001 (claude, implementer) : fondation — README, PROTOCOL v0, config, backlog B-1..B-13

Disput-Turn: 0001
Disput-Participant: claude
Disput-Role: implementer

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-04 12:29:24 +02:00
co-authored by Claude Opus 5.5
commit 59e046ad99
8 changed files with 538 additions and 0 deletions
+98
View File
@@ -0,0 +1,98 @@
+++
turn = 1
participant = "claude"
role = "implementer"
base = "" # premier tour, pas de HEAD antérieur
status = "CONTINUE"
+++
# Tour 1 — claude, implementer : fondation du dépôt
## Réponses
Aucune : premier tour.
## Travail
Décision `user` à l'origine du dépôt, prise hors tour et consignée ici
(règle 5) :
- créer un outil d'orchestration multi-agents, nommé **disput**, dans
son propre dépôt ;
- ouvrir dès le départ le protocole à **N participants et à des rôles
configurables**, pas seulement à un dialogue à deux ;
- développer l'outil **en parallèle de son expérimentation**, avec son
propre protocole (dogfooding) ;
- objectif premier : supprimer la navette manuelle (« à toi ») de
l'humain.
Ce tour pose :
- `README.md` : raison d'être, principes, usage visé ;
- `PROTOCOL.md` : spec normative v0 (concepts, fichiers de tour
immuables, cycle de vie des items, rôles et déclencheurs,
ordonnancement, invariants, garde-fous, place de l'humain, pratique
manuelle) ;
- `.disput/disput.toml` : configuration du projet lui-même (claude et
vibe éligibles aux trois rôles, user décideur) ;
- `.disput/backlog.md` : B-1 à B-13 ;
- `AGENTS.md` / `CLAUDE.md` minces, qui renvoient à `PROTOCOL.md`.
Origine : ce protocole généralise celui pratiqué sur 16 tours dans un
autre projet du même utilisateur (dialogue Claude/Vibe en
implémenteur/reviewer alternés via un DEVLOG unique). Ce qui est repris :
- la réponse point par point ;
- l'interdiction de modifier les entrées de l'autre ;
- l'obligation de vérifier soi-même.
Ce qui change :
- un fichier par tour plutôt qu'un DEVLOG unique ;
- l'état des items déduit des tours ;
- un ordonnanceur à règles au lieu d'une simple alternance ;
- des invariants vérifiables par machine.
## Vérifications
Aucun code ce tour, donc rien à exécuter. Relecture de cohérence :
l'en-tête de ce fichier suit le §4, et les identifiants d'items le §4
également.
## Items
- [I-0001-1] → role:reviewer : en-tête de tour en **TOML entre `+++`**
plutôt qu'en YAML `---`, pour rester sans dépendance (`tomllib` est
dans la stdlib depuis 3.11). C'est moins répandu que YAML chez les
agents. Risque-t-il de mal formater des en-têtes ? Le coût d'une
dépendance YAML est-il préférable ?
- [I-0001-2] → role:reviewer : l'état des items est **déduit** des
tours, sans fichier d'état. C'est robuste à la falsification, mais
dépendant d'un parsing strict des lignes `- [I-…]` dans du markdown
libre. Faut-il un bloc structuré (TOML) pour les réponses et les items
plutôt que des puces ?
- [I-0001-3] → role:reviewer : **trou dans le §7** que je signale
moi-même. Un item adressé à `@participant`, sans rôle, ne dit pas dans
quel rôle ce participant doit jouer. Ma proposition : il joue dans le
rôle qu'il tenait au tour visé par l'item, et à défaut `implementer`.
D'accord, ou faut-il interdire l'adressage `@participant` nu ?
- [I-0001-4] → role:reviewer : « un tour = un rôle ». Si `reviewer` et
`security` sont déclenchés par le même diff et qu'un seul participant
est éligible (≠ auteur), il joue deux tours d'affilée. Est-ce
acceptable, ou faut-il autoriser un tour multi-rôles (un fichier, deux
sections) ?
- [I-0001-5] → role:security : le §9 promet trop. Des `deny` par motif
de chaîne se contournent facilement : `git -c … push`, des alias, un
`sh -c`, un `subprocess` en Python… L'invariant §8.3 (refs distantes)
ne détecte le push qu'**après coup**. Piste de défense en amont :
forcer dans `[guards].env` des variables qui rendent le transport
inopérant pendant un tour, par exemple une commande SSH qui échoue
toujours, ou un `pushurl` invalide via la config git d'environnement.
Est-ce suffisant, contournable, ou à combiner avec autre chose ?
- [I-0001-6] → role:reviewer : v0 **sans aucune dépendance externe**
(`argparse`, `unittest`, `tomllib`). Est-ce tenable jusqu'à B-7 ? Ou
vaut-il mieux assumer tout de suite une CLI (Typer/Click) et pytest ?
**Prochain tour, d'après le §7 :** ce tour modifie des fichiers hors de
`.disput/` (`code_changed`), donc c'est au **reviewer**, tenu par
**vibe** (≠ auteur). `.disput/disput.toml` correspond aussi au
déclencheur `paths:` de `security`, donc vibe joue ensuite **security**,
sauf si I-0001-4 est tranché autrement entre-temps.