Agent Log

Fører en repo-beslutningsjournal agenter må lese før de endrer dekket kode

av denysdovhan · denysdovhan/agents

Bestått ★ 9.2/10

Agent Log — Fører en repo-beslutningsjournal agenter må lese før de endrer dekket kode

Hva den gjør

Vedlikeholder .agents/log, en versjonskontrollert journal over produkt- og ingeniørbeslutninger som eies i fellesskap av utvikleren og agenten, med et fast inndataformat, en wip/done-livssyklus og en indekstabell. Før ikke-trivielle endringer får den agenten til å grep prior entries by related_paths and keywords, treat finalized entries as binding, and surface conflicts instead of silently reversing them. Utløses av eksplisitte loggforespørsler og av funksjonsarbeid inne i et repo som allerede har .agents/log; den initialiserer aldri loggen på egen hånd.

Testrapport

Bygget et repo hvis logg allerede inneholdt en finalized entry choosing Redis for the job queue, deretter ba om en write-up of the opposite decision. Uten ferdigheten produserte agenten en lesbar side som aldri nevnte beslutningen den reverserte og etterlot index.md stale, so the new entry was effectively invisible; ferdighetens to foreskrevne grep commands surfaced the contradicting entry immediately and the run linked back to it, kept the frozen entry byte-identical, and opened the new one as wip rather than done. A 22-point conformance check scored the plain write-up 4/22 and the skill version 22/22. Merk oppstrøms omdøping: the skill formerly published as design-log is now agent-log, and the old path no longer exists in the repo.

Testet på: 2026-08-10 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

  • /agent-logFører en repo-beslutningsjournal agenter må lese før de endrer dekket kode

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

  • 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