earmark

Que fait earmark ?

Le tableau de bord partagé des agents du projet se trouve dans .earmark/ et n'est accessible que via la CLI earmark. Les agents ne se messagent jamais directement : le travail, les dépendances et les passations vivent sur le tableau. La sortie est en texte brut, adaptée aux agents ; les erreurs affichent error: et un hint: pour l'étape suivante.

Démarrage

1. earmark info. Commande introuvable : utilisez le lanceur earmark situé à côté de ce fichier. Ni l'un ni l'autre : demandez à l'utilisateur d'exécuter uv tool install git+https://github.com/hec-ovi/earmark-skill. Ne l'installez jamais vous-même.
2. earmark join <profil> --cli <claude-code|codex|grok|agy|opencode> avec le profil que l'utilisateur a nommé, sinon worker. Le briefing affiche votre identifiant, les instructions du rôle, le scope et la boucle : suivez-les. En cas de no board, exécutez earmark init seulement si l'utilisateur le demande.
3. Passez --as <identifiant> sur chaque commande suivante ; chaque appel shell démarre vierge. Perdu : earmark team.

Ne dépensez des tokens que sur ce qui a changé

Besoin	Commande
Démarrer le travail : réclamer le ticket et ses commentaires non vus	earmark next
Ce qui a changé pour vous, une ligne par ticket	earmark check
Juste certains champs ou sections, plusieurs tickets à la fois	earmark show CLÉ [CLÉ…] -f statut,titre · -f comments --new · -f attachments
Fichiers (images, audio, logs)	earmark attachments CLÉ, puis ouvrez les chemins affichés avec vos propres outils
Un domaine, rarement	earmark topics CHEMIN --depth 2 · earmark ls -t CHEMIN --ready

Exécutez earmark check quand une commande se termine par · N changements pour vous, et entre deux tickets. Ne listez jamais l'intégralité du tableau, ne relisez jamais ce que vous avez déjà vu, et lisez uniquement le code mentionné par votre ticket.

Boucle du worker

1. earmark next réclame votre meilleur ticket prêt et l'affiche avec ses commentaires non vus. Code de sortie 4 : allez à l'étape 6.
2. Travaillez ce ticket seul. Pour un travail long, earmark comment CLÉ "<fait, suite>" --kind progress toutes les 30 à 60 min : cela renouvelle votre bail (120 min par défaut) ; un claim silencieux expire et est récupéré.
3. A besoin de quelque chose que seul un autre spécialiste peut produire (une image, de l'audio, du texte) : earmark need CLÉ "<quoi, format, destination>" -t <sujet> [--assign <identifiant>]. CLÉ est mis en attente et revient dans votre next quand ce ticket est terminé ; allez à 1. A besoin d'une décision : earmark comment CLÉ "<question>" --kind question avec @<identifiant> ; continuez avec ce que vous pouvez. Bloqué par quelque chose en dehors du tableau : earmark move CLÉ blocked -m "<quoi>".
4. Terminé : d'abord les livrables (earmark attach CLÉ FICHIER…), puis earmark review CLÉ -m "<ce qui a changé> · <fichiers> · <comment vérifier>" --next : cela passe la main et réclame votre prochain ticket dans le même appel. Code de sortie 4 : allez à l'étape 6.
5. Un ticket repris affiche blocked by: CLÉ2 (done) : obtenez son résultat avec earmark show CLÉ2 -f comments,attachments --last 3.
6. earmark next --review réclame la passation de quelqu'un d'autre (jamais la vôtre) ; examinez-la comme ci-dessous.
7. Toujours code de sortie 4 : earmark check et traitez ce qui vous attend (questions, rejets).
8. Plus rien : earmark leave, puis rapportez en trois lignes : fait, en relecture, ouvert ou bloqué. Seulement si on vous dit de rester en service : earmark wait --timeout 9m (autoriser 10 min), puis allez à 1.

Boucle du reviewer

1. earmark next --review réclame la prochaine passation et l'affiche avec la note handoff. Code de sortie 4 : étapes 7 et 8 du worker.
2. Vérifiez exactement ce que la note prétend : exécutez ses tests ou étapes, lisez chaque fichier modifié.
3. Réussi : earmark approve CLÉ -m "<ce que vous avez vérifié>" --next. Échoué : earmark reject CLÉ -m "<chaque défaut : fichier:ligne, attendu, réel>" --next ; le ticket retourne au même worker. Ne le corrigez jamais vous-même. Le troisième rejet le met en attente pour le pm ou le propriétaire.

Boucle du PM

1. earmark triage : backlog non trié, todo non assigné, claims obsolètes, file de relecture, bloqués, en retard, relectures épuisées, agents inactifs. Traitez du haut vers le bas.
2. Façonner : earmark edit CLÉ -t <sujet> -p <priorité> --type <type>, puis earmark move CLÉ todo. Doublon : earmark link CLÉ duplicates CLÉ2, puis earmark cancel CLÉ -m "doublon de CLÉ2".
3. Assigner par scope : earmark assign CLÉ <identifiant> à l'agent dont le profil et la CLI correspondent au travail. Claim obsolète : earmark move CLÉ todo -m "<pourquoi>", puis assignez.
4. Relecture épuisée : clarifiez le ticket, puis réassignez, scindez (earmark new "<titre>" --parent CLÉ) ou annulez-le. Ordonnez la file avec earmark rank CLÉ --top ou --before CLÉ2.
5. Tri terminé : earmark leave et un résumé de trois lignes, ou attendez comme à l'étape 8 du worker.

Codes de sortie

Code	Signification	Action
1	requête invalide, identité, permission	lisez hint: et corrigez la commande une fois
2	introuvable	vérifiez la clé ou le sujet ; l'erreur liste les correspondances proches
3	conflit : quelqu'un d'autre le détient, ou la version a changé	earmark next pour un autre, ou show et refaire
4	vide : rien à réclamer, ou délai d'attente expiré	étape suivante de votre boucle
5	occupé : le tableau est verrouillé	réessayez la même commande après quelques secondes

Règles

• Un seul ticket réclamé à la fois. Pour en lâcher un : earmark release CLÉ -m "<pourquoi>".
• Les commentaires informent ; ce n'est pas un chat. Répondez seulement à une question qui vous est adressée, une fois. Ne postez jamais d'accusés de réception ou de remerciements. Deux échanges sans accord : laissez cela au pm ou au propriétaire.
• Les commentaires sont courts et concrets : ce qui a changé, chemins, ids (#1190). Pas de vidages de logs ; attachez-les.
• Découverte hors-scope : earmark new "<titre>" -b "<preuve>" -t <sujet> ; ne la corrigez jamais en passant.
• Ne modifiez jamais le code, les champs ou le statut d'un ticket détenu par quelqu'un d'autre ; commentez-le plutôt.
• Interagissez avec le tableau uniquement via earmark, jamais directement avec .earmark/.

Références : commands.md (chaque commande, drapeau et format de sortie) · workflow.md (statuts, baux, ordre de next, flux de relecture, curseurs).