Methodology

Iteration Log

An append-only record of actions taken during PRD execution, providing an audit trail of what was done, what was learned, and what changed.

The iteration log is the accountability layer of Ralph Execute. Each iteration appends a timestamped entry: what action was taken, what the outcome was, what was learned, and what the next action should be. The log is append-only by design so previous entries cannot be overwritten or lost during compaction. When debugging why a PRD produced unexpected output, the iteration log shows exactly which decisions were made and in what order. Logs also serve as training data for improving PRD design: patterns of repeated blocked-then-retried iterations reveal structural problems in the plan.

Where it shows up:

PRD execution auditDebugging failed runsProcess improvementAgent accountability

Build your Knowledge OS

90 minutes from zero to your first skill chain.