Agent Log

Führt ein Repo-Entscheidungsprotokoll, das Agenten lesen müssen, bevor sie abgedeckten Code ändern

von denysdovhan · denysdovhan/agents

Getestet · Funktioniert ★ 9.2/10

Agent Log — Führt ein Repo-Entscheidungsprotokoll, das Agenten lesen müssen, bevor sie abgedeckten Code ändern

Was es kann

Verwaltet .agents/log, ein versionskontrolliertes Journal von Produkt- und Engineering-Entscheidungen, das gemeinsam vom Entwickler und dem Agenten verwaltet wird, mit einem festen Eintragsformat, einem wip/done-Lebenszyklus und einer Indextabelle. Vor nicht-trivialen Änderungen lässt es den Agenten frühere Einträge nach related_paths und Keywords durchsuchen, finalisierte Einträge als bindend behandeln und Konflikte aufzeigen, anstatt sie stillschweigend rückgängig zu machen. Wird bei expliziten Log-Anfragen und bei Feature-Arbeiten innerhalb eines Repos ausgelöst, das bereits .agents/log enthält; es initialisiert das Log niemals von selbst.

Testbericht

Ein Repo erstellt, dessen Log bereits einen finalisierten Eintrag enthielt, der Redis für die Job-Warteschlange wählte, und dann eine Ausarbeitung der entgegengesetzten Entscheidung angefordert. Ohne den Skill erstellte der Agent eine lesbare Seite, die die rückgängig gemachte Entscheidung nie erwähnte und index.md veraltet ließ, sodass der neue Eintrag effektiv unsichtbar war; die beiden vorgeschriebenen grep-Befehle des Skills zeigten den widersprüchlichen Eintrag sofort auf, und der Lauf verlinkte zurück darauf, hielt den eingefrorenen Eintrag byte-identisch und öffnete den neuen als wip statt done. Eine 22-Punkte-Konformitätsprüfung bewertete die einfache Ausarbeitung mit 4/22 und die Skill-Version mit 22/22. Beachten Sie die Umbenennung upstream: Der Skill, der früher als design-log veröffentlicht wurde, ist jetzt agent-log, und der alte Pfad existiert nicht mehr im Repo.

Getestet am: 2026-08-10 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/denysdovhan/agents.git
mkdir -p ~/.claude/skills
cd agents && cp -r skills/agent-log ~/.claude/skills/agent-log

Befehle & Beispiel-Prompts

  • /agent-logFührt ein Repo-Entscheidungsprotokoll, das Agenten lesen müssen, bevor sie abgedeckten Code ändern

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Log our decision to move background jobs to Postgres pg-boss
  • Write a .agents/log entry reversing the Redis job queue decision
  • Check prior agent-log entries for context before this refactor