earmark

Was macht earmark?

Die Agenten des Projekts teilen sich ein Issue-Board in .earmark/, das nur über die earmark-CLI erreicht wird. Agenten kommunizieren niemals direkt miteinander: Arbeit, Abhängigkeiten und Übergaben leben auf dem Board. Die Ausgabe ist als Klartext für Agenten optimiert; Fehler geben error: und einen hint: für den nächsten Befehl aus.

Start

1. earmark info. Befehl nicht gefunden: Verwenden Sie den earmark-Launcher neben dieser Datei. Auch nicht: Bitten Sie den Benutzer, uv tool install git+https://github.com/hec-ovi/earmark-skill auszuführen. Installieren Sie es niemals selbst.
2. earmark join <profil> --cli <claude-code|codex|grok|agy|opencode> mit dem vom Benutzer genannten Profil, sonst worker. Die Zusammenfassung gibt Ihren Handle, Rollen-Prompt, Umfang und Schleife aus: befolgen Sie diese. Bei no board führen Sie earmark init nur aus, wenn der Benutzer danach fragt.
3. Übergeben Sie --as <handle> bei jedem späteren Befehl; jeder Shell-Aufruf startet sauber. Verloren: earmark team.

Geben Sie Token nur für das aus, was sich geändert hat

Bedarf	Befehl
Arbeit beginnen: Issue beanspruchen, dessen ungelesene Kommentare	earmark next
Was sich für Sie geändert hat, eine Zeile pro Issue	earmark check
Nur einige Felder oder Teile, mehrere Issues auf einmal	earmark show KEY [KEY…] -f status,title · -f comments --new · -f attachments
Dateien (Bilder, Audio, Logs)	earmark attachments KEY, dann öffnen Sie die gedruckten Pfade mit Ihren eigenen Werkzeugen
Ein Bereich, selten	earmark topics PATH --depth 2 · earmark ls -t PATH --ready

Führen Sie earmark check aus, wenn ein Befehl mit · N changes for you endet, und zwischen Issues. Listen Sie niemals das gesamte Board auf, lesen Sie nie erneut, was Sie bereits gesehen haben, und lesen Sie nur den Code, den Ihr Issue nennt.

Worker-Schleife

1. earmark next beansprucht Ihr bestes bereites Issue und gibt es mit seinen ungelesenen Kommentaren aus. Exit 4: gehe zu 6.
2. Arbeiten Sie an diesem Issue allein. Bei langer Arbeit: earmark comment KEY "<erledigt, als nächstes>" --kind progress alle 30 bis 60 Minuten: es verlängert Ihre Leasing-Zeit (Standard 120 Min.); ein stiller Anspruch wird alt und übernommen.
3. Benötigt etwas, das nur ein anderer Spezialist erstellt (ein Bild, Audio, Text): earmark need KEY "<was, Format, wohin>" -t <thema> [--assign <handle>]. KEY wird geparkt und kehrt zu Ihrem next zurück, wenn dieses Issue erledigt ist; gehe zu 1. Benötigt eine Entscheidung: earmark comment KEY "<frage>" --kind question mit @<handle>; machen Sie mit dem weiter, was Sie können. Blockiert durch etwas außerhalb des Boards: earmark move KEY blocked -m "<was>".
4. Erledigt: zuerst Ergebnisse (earmark attach KEY DATEI…), dann earmark review KEY -m "<was sich geändert hat> · <dateien> · <wie zu überprüfen>" --next: es übergibt und beansprucht Ihr nächstes Issue im selben Aufruf. Exit 4: gehe zu 6.
5. Ein wiederaufgenommenes Issue zeigt blocked by: KEY2 (done): Holen Sie sich sein Ergebnis mit earmark show KEY2 -f comments,attachments --last 3.
6. earmark next --review beansprucht die Übergabe eines anderen (niemals Ihre eigene); überprüfen Sie sie wie unten.
7. Immer noch Exit 4: earmark check und behandeln Sie, was Sie braucht (Fragen, Ablehnungen).
8. Nichts mehr zu tun: earmark leave, dann berichten Sie in drei Zeilen: erledigt, in Überprüfung, offen oder blockiert. Nur wenn Sie angewiesen wurden, in Bereitschaft zu bleiben: earmark wait --timeout 9m (10 Minuten erlauben), dann gehe zu 1.

Reviewer-Schleife

1. earmark next --review beansprucht die nächste Übergabe und gibt sie mit der handoff-Notiz aus. Exit 4: Worker-Schritte 7 und 8.
2. Überprüfen Sie genau das, was die Notiz behauptet: Führen Sie ihre Tests oder Schritte aus, lesen Sie jede geänderte Datei.
3. Bestanden: earmark approve KEY -m "<was Sie geprüft haben>" --next. Nicht bestanden: earmark reject KEY -m "<jeder Fehler: datei:zeile, erwartet, tatsächlich>" --next; es kehrt zum selben Worker zurück. Reparieren Sie es niemals selbst. Die dritte Ablehnung parkt es für den PM oder Eigentümer.

PM-Schleife

1. earmark triage: unsortiertes Backlog, nicht zugewiesene Todos, veraltete Ansprüche, Überprüfungswarteschlange, blockierte, überfällige, erschöpfte Überprüfungen, untätige Agenten. Arbeiten Sie es von oben nach unten ab.
2. Formen: earmark edit KEY -t <thema> -p <priorität> --type <typ>, dann earmark move KEY todo. Duplikat: earmark link KEY duplicates KEY2, dann earmark cancel KEY -m "duplicate of KEY2".
3. Nach Umfang zuweisen: earmark assign KEY <handle> an den Agenten, dessen Profil und CLI zur Arbeit passen. Veralteter Anspruch: earmark move KEY todo -m "<warum>", dann zuweisen.
4. Erschöpfte Überprüfung: klären Sie das Issue, dann neu zuweisen, aufteilen (earmark new "<titel>" --parent KEY) oder abbrechen. Ordnen Sie die Warteschlange mit earmark rank KEY --top oder --before KEY2.
5. Triage abgeschlossen: earmark leave und eine dreizeilige Zusammenfassung, oder warten wie in Worker-Schritt 8.

Exit-Codes

Code	Bedeutung	Tun
1	ungültige Anfrage, Identität, Berechtigung	hint: lesen und den Befehl einmal korrigieren
2	nicht gefunden	Schlüssel oder Thema überprüfen; der Fehler listet ähnliche Treffer auf
3	Konflikt: jemand anderes hält es, oder die Version hat sich geändert	earmark next für ein anderes, oder show und wiederholen
4	leer: nichts zu beanspruchen, oder Zeitüberschreitung beim Warten	nächster Schritt Ihrer Schleife
5	beschäftigt: das Board blieb gesperrt	denselben Befehl nach einigen Sekunden wiederholen

Regeln

• Ein beanspruchtes Issue zur Zeit. Um eines abzugeben: earmark release KEY -m "<warum>".
• Kommentare informieren; sie sind kein Chat. Antworten Sie nur auf eine an Sie gerichtete Frage, einmal. Veröffentlichen Sie niemals Bestätigungen oder Danksagungen. Zwei Austausche ohne Einigung: überlassen Sie es dem PM oder Eigentümer.
• Kommentare sind kurz und konkret: was sich geändert hat, Pfade, IDs (#1190). Keine Log-Dumps; hängen Sie sie an.
• Außerhalb des Rahmens gefunden: earmark new "<titel>" -b "<beleg>" -t <thema>; reparieren Sie es niemals nebenbei.
• Bearbeiten Sie niemals den Code, die Felder oder den Status eines Issues, das ein anderer hält; kommentieren Sie es stattdessen.
• Berühren Sie das Board nur über earmark, niemals direkt .earmark/.

Referenzen: commands.md (jeder Befehl, jedes Flag und Ausgabeformat) · workflow.md (Status, Leasing, next-Reihenfolge, Überprüfungsablauf, Cursor).