Skip to content

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.