Agent Log

Mantiene un journal delle decisioni del repo che gli agenti devono leggere prima di modificare il codice coperto

di denysdovhan · denysdovhan/agents

Promosso ★ 9.2/10

Agent Log — Mantiene un journal delle decisioni del repo che gli agenti devono leggere prima di modificare il codice coperto

Cosa fa

Mantiene .agents/log, un journal versionato di decisioni di prodotto e ingegneria co-posseduto dallo sviluppatore e dall'agente, con un fixed entry format, un wip/done lifecycle e un index table. Prima di modifiche non banali, fa in modo che l'agente grep prior entries by related_paths e keywords, tratti le finalized entries come binding, e surface conflicts invece di silently reversing them. Si attiva su richieste esplicite di log e su feature work all'interno di un repo che ha già .agents/log; non inizializza mai il log da solo.

Rapporto di test

Ho costruito un repo il cui log conteneva già una finalized entry che sceglieva Redis per la job queue, quindi ho chiesto una write-up della decisione opposta. Senza la skill l'agente ha prodotto una readable page che non menzionava mai la decisione che stava annullando e ha lasciato index.md stale, quindi la nuova entry era effettivamente invisibile; i due prescribed grep commands della skill hanno fatto emergere immediatamente la contradicting entry e l'esecuzione vi ha collegato, ha mantenuto la frozen entry byte-identical, e ha aperto la new one come wip piuttosto che done. Un 22-point conformance check ha valutato la plain write-up 4/22 e la skill version 22/22. Nota il rename upstream: la skill precedentemente pubblicata come design-log è ora agent-log, e il old path non esiste più nel repo.

Testato il: 2026-08-10 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

  • /agent-logMantiene un journal delle decisioni del repo che gli agenti devono leggere prima di modificare il codice coperto

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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