Agent Log

Vedligeholder en repo-beslutningsjournal, som agenter skal læse, før de ændrer dækket kode

Af denysdovhan · denysdovhan/agents

Testet · Virker ★ 9.2/10

Agent Log — Vedligeholder en repo-beslutningsjournal, som agenter skal læse, før de ændrer dækket kode

Hvad det gør

Vedligeholder .agents/log, en versionsstyret journal over produkt- og ingeniørbeslutninger, der ejes i fællesskab af udvikleren og agenten, med et fast indtastningsformat, en wip/done livscyklus og en indekstabel. Før ikke-trivielle ændringer får den agenten til at greppe tidligere indtastninger efter related_paths og keywords, behandle færdiggjorte indtastninger som bindende og synliggøre konflikter i stedet for lydløst at vende dem. Udløses af eksplicitte loganmodninger og af feature-arbejde inde i et repo, der allerede har .agents/log; den initialiserer aldrig loggen af sig selv.

Testrapport

Byggede et repo, hvis log allerede indeholdt en færdiggjort post, der valgte Redis til jobkøen, og bad derefter om en beskrivelse af den modsatte beslutning. Uden skillen producerede agenten en læsbar side, der aldrig nævnte den beslutning, den vendte, og efterlod index.md forældet, så den nye post var effektivt usynlig; skillens to foreskrevne grep-kommandoer fandt den modstridende post med det samme, og kørslen linkede tilbage til den, holdt den frosne post byte-identisk og åbnede den nye som wip snarere end done. En 22-punkts overensstemmelseskontrol scorede den almindelige beskrivelse 4/22 og skill-versionen 22/22. Bemærk omdøbningen upstream: skillen, der tidligere blev udgivet som design-log, er nu agent-log, og den gamle sti eksisterer ikke længere i repoet.

Testet: 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

Kommandoer og eksempelprompter

  • /agent-logVedligeholder en repo-beslutningsjournal, som agenter skal læse, før de ændrer dækket kode

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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