Feature Request: Capture agent decision rationale in audit trail, not just actions #3
Description
Source
Reddit feedback from u/ultrathink-art on r/ClaudeCode
Problem
Current audit trail logs what was done and by whom, but not why an agent chose approach A over B. At scale, the hard part isn't merge conflicts — it's debugging a decision an agent made two days ago when something breaks.
Real-world pain points:
- Agents produce artifacts (diffs, commits, synced records) but almost no decision rationale
- Rolling back requires understanding the reasoning, not just the action
- Training new agents on lessons from past sessions requires knowing the "why"
Current State
The audit trail is an action log: who (human or agent) did what, on which task, when. Full traceability on actions, but not the agent's reasoning chain behind each decision.
Proposed Solution
Implement decision point audit logging, referencing the AIDLC methodology:
- Create explicit decision points that enforce agents to interact with humans by proposing multiple-choice questions
- Log all human decisions (which option was chosen and why) for traceback
- Transform the audit trail from action log → decision rationale log
Impact
Enables debugging, rollback decisions, and institutional memory across agent sessions — the gap between knowing WHAT happened and understanding WHY.