Request Log
Keep a raw, dated log of everything the director says in docs/records/log/<date>.md: requests, feedback, questions, asides and go-aheads alike, written before any of it goes where the project's workflow files new work, such as the intake of Work Workflow. Minimal cleanup only: spelling, careful rewording, prose into a flat list. The essence stays. The wiki lists the log newest first as the Request Log.
Why
Every doc and ticket can be checked against the words that produced it.
The File
- The H1 is the date with its DEV day:
2026-09-14 - DEV day 6(Changelog Per Version). - One
##per message, titled with its time. The heading is written by the shell itself in the append,printf '\n## %s\n\n' "$(date +%H:%M)", never typed: typed headings run ahead of the clock. - The days before the agent are reconstructed from the commit history as entries of their own, so the log starts at the project's first day.
How To Apply
- Log first, in the same turn, then file the work.
- A message that lands mid-turn is logged the same way, with its own time, before the work goes on.
- A question the director asks is logged too, since the answer shapes the project.
- A secret in a message is left out (Keep Secrets Away From Agents).
- Past entries only get typo fixes.
- New understanding gets a new entry.
- The log entry is committed as its own
docs(log)commit, in the same pass as what was parsed from it. Never left uncommitted waiting for a go. - The raw chat transcripts stay where the tool keeps them, on disk and uncommitted. The log is the curated record. Now and then a debt ticket schedules a gap analysis of the raw transcripts against the log and the docs, looking for interpretation errors.