| name | audit-logging |
| description | How to record completed work in logs/agent-log.md so humans can inspect what the agent read, wrote, and concluded. |
Audit logging
Every completed task gets one entry appended to logs/agent-log.md. Tool calls are logged automatically to logs/tool-calls.jsonl; the agent log is the human-readable layer on top: what you did and why.
When to log
Append exactly one entry after finishing a task (successful or not), as your final action before giving your final answer. Use writeFile with append: true.
Entry format
## <ISO timestamp> — <one-line task summary>
- task: <the request, restated in one line>
- read: <comma-separated list of files you relied on>
- wrote: <comma-separated list of files you created/updated, or "none">
- conclusion: <1-3 lines: outcome, key findings, or why the task could not be completed>
- caveats: <conflicts found, missing data, low-confidence items, or "none">
Keep the entry under 15 lines. The log is append-only: never rewrite or delete previous entries.