# The Agent Loop

## What this project is

A companion repo for the From AI to Chitta article on **The Agent Loop**
(concept ID: `CC-001`). It contains exercises that let you observe and
control Claude Code's core execution cycle.

Article: https://fromaitochitta.com/the-agent-loop

## How to use this

1. Open Claude Code in this directory: `cd claude-code-agent-loop && claude`
2. Work through exercises in order: `exercises/01-watch-the-loop.md`, then 02, then 03
3. Each exercise has a self-contained prompt you paste into Claude Code
4. Compare your output to the expected output described in each exercise

## Code quality expectations

- This is a learning repo. Clarity over cleverness.
- Every exercise must run without modification on a clean clone
- No external dependencies unless explicitly listed in the exercise
- If something does not work as expected, that is useful information: note it

## Project structure

```
exercises/          Numbered exercises with prompts and expected output
CLAUDE.md           This file: project instructions
README.md           Overview for anyone who clones this repo
```

## Domain

Claude Code Foundation

## Memory

Keep session notes in a local `MEMORY.md` (gitignored). This file
(CLAUDE.md) is for instructions. MEMORY.md is for state.