# Understanding the progress.txt Format and How to Structure Learnings in Ralph

> Learn the progress.txt format and structure your learnings effectively for the snarktank/ralph AI agent. Discover how this markdown log persists patterns and insights between iterations.

- Repository: [Ryan Carson/ralph](https://github.com/snarktank/ralph)
- Tags: how-to-guide
- Published: 2026-04-13

---

**[`progress.txt`](https://github.com/snarktank/ralph/blob/main/progress.txt) is an append-only markdown log that persists discovered patterns and implementation learnings between AI-agent iterations in the snarktank/ralph workflow.**

The [`progress.txt`](https://github.com/snarktank/ralph/blob/main/progress.txt) format provides a machine-readable yet human-friendly way to accumulate institutional knowledge across multiple AI coding sessions. According to the snarktank/ralph source code, this file lives in your project root and serves as the primary mechanism for transferring context to future agent iterations without polluting your Git history.

## What Is the progress.txt File?

[`progress.txt`](https://github.com/snarktank/ralph/blob/main/progress.txt) functions as an