WHY LOOPS, WHY GRAPHS
In their own words.
I did not start running agents overnight because of a benchmark. I started because the people building Claude Code kept saying the same two things in public: the next step is loops, and long-running work needs memory outside the context window. This page is those quotes, verbatim and linked, with one line each on what it became in the folder. If a quote is wrong, the source is one click away.
Rule: nothing paraphrased, nothing undated, nothing without a link. Updated by hand.
I Loops
The work is a loop, the loop has stopping conditions, and the person's job moves from prompting to writing loops.
I don’t prompt Claude anymore. I have loops running that prompt Claude and figuring out what to do. My job is to write loops.
in loopsThe whole folder. A loop is written once and renews itself; you read four lines, not a transcript.
Two years ago, we wrote source code by hand. We started to transition so agents write the code. And now we’re transitioning to the point where agents are prompting agents that then write the code. As big as the step from source code to agents was, loops are just as important and as big a step.
in loopsWhy the site is named after the loop and not the agent.
They are typically just LLMs using tools based on environmental feedback in a loop.
in loopsOne bounded pass of claude -p is the whole run. No framework in between.
The task often terminates upon completion, but it’s also common to include stopping conditions (such as a maximum number of iterations) to maintain control.
in loopsBudget per run, budget per loop, a review date, and two no-progress runs park it. Nothing runs forever.
the most successful implementations weren’t using complex frameworks or specialized libraries. Instead, they were building with simple, composable patterns.
in loopsMarkdown files, a shell script, a permissions fence, launchd. Copy the folder.
In Claude Code, Claude often operates in a specific feedback loop: gather context -> take action -> verify work -> repeat.
in loopsEvery loop’s definition of done says verify before you report. The morning judge checks that it did.
Each new session begins with no memory of what came before.
in loopsEach run re-verifies the last run’s key claim before extending it, and ends with a next: line for the one after.
Agents need a way to bridge the gap between coding sessions.
in loopsA loop’s state file is append-only and dated. That file is the bridge.
You can also schedule work that runs independent of any open session, such as nightly tests or morning triage.
in loopsNightly is the default cadence. The laptop is the scheduler.
II Graphs
Every session forgets. Notes persisted outside the context window are how work survives, and a pile of notes only answers questions when the facts are connected.
Structured note-taking, or agentic memory, is a technique where the agent regularly writes notes persisted to memory outside of the context window.
in loopsFour lines per loop per night, in files the run cannot edit later. Those notes are what the graph reads.
Context, therefore, must be treated as a finite resource with diminishing marginal returns.
in loopsA run starts from the loop’s state file and the charter, not from last night’s transcript.
The LeadResearcher begins by thinking through the approach and saving its plan to Memory to persist the context, since if the context window exceeds 200,000 tokens it will be truncated and it is important to retain the plan.
in loopsThe plan lives in the loop, not in the session. The session can die; the plan cannot.
In agentic systems, minor changes cascade into large behavioral changes, which makes it remarkably difficult to write code for complex agents that must maintain state in a long-running process.
in loopsState is owned by the runner and written to disk between runs. The agent never holds it.
No single document contains the answer. RAG retrieval won’t chain the facts for you.
in loopsA month of reports is a pile of documents. The graph is how last month’s mistake becomes one query.
Auto memory lets Claude accumulate knowledge across sessions without you writing anything.
in loopsTheir memory remembers your preferences. Ours has to remember your decisions. Same idea, one level up.
THE FOLDER THOSE QUOTES BECAME
INSTALL LOOPS · MACOS · RUNS ON THE PLAN YOU ALREADY PAY FOR
Pick one and the steps below adapt. Either way it runs on your own Mac, on your own subscription, and nothing phones home.