Skip to content
claude-foundation

What is Change Loop?

Change Loop is a software-change harness for AI coding agents. It gives the agent a repeatable way to agree on a change, implement it away from your working tree, prove it with real evidence, and only then bring it into the project.

Investigate? → Change → Build → Prove → Land

It is not an AI, and it does not write code. It is a deterministic control plane around your coding agent. It does not replace your agent, test framework, CI system, or Git workflow either — it drives the tools your repository already owns.

The workflow is called Change Loop. Its installed package and CLI remain claude-foundation, so current commands and integrations keep working.

Users keep the six intent-level commands: /investigate, /change, /build, /prove, /land, and /dev. The agent compiles one semantic draft and drives one advance coordinator; it does not ask the user to operate the internal CLI chain. The compiled OpenSpec packet remains the source of truth.

The problem it solves

Section titled “The problem it solves”

An AI coding agent will tell you it finished. That claim is usually the weakest link in the whole workflow: the agent read its own output, decided it looked right, and reported success. Nothing independently checked that the code runs, that the tests it claims to have written exist, or that the thing you asked for is the thing that shipped.

Change Loop refuses to take the agent’s word for it. Every observable behaviour the change promises becomes a claim with a stable ID, and a claim is only satisfied by a receipt produced by actually executing a project-owned tool. A passing command is not automatically proof, and an agent’s summary is never proof.

Who does what

Section titled “Who does what”

Change Loop deliberately splits responsibility so that no single party can both do the work and certify it.

Part Responsibility
You Define intent, make consequential decisions, review the result, and explicitly authorize Land
AI coding agent Investigates, writes the agreement, implements code and tests, fixes what evidence reports
Change Loop harness Controls lifecycle state, scope, sandboxes, evidence, proof freshness, budgets, and Land guards
OpenSpec Stores the durable, human-reviewable requirements and change agreement
Project tools Test runners, linters, Playwright, scanners — these produce the executable evidence
Git and CI Version control and automation, through your existing process

What makes it different

Section titled “What makes it different”

One native owner. The coding agent reads a compact change packet and owns implementation. There is no relay race between PM, lead, engineer, QA, and retro personas — that shape preserved quality but let orchestration dominate cost and latency.

Executable evidence. Claims select capabilities. Capabilities are satisfied by provider contracts that run your tools and produce receipts the runtime validates. Change Loop never installs a test framework or downloads a browser to make evidence appear.

Reuse before rerun. Receipts bind to code, agreement, claims, configuration, environment, protocol, and artifacts. Change a bound input and the receipt goes stale; leave it alone and the work is reused instead of repeated.

Transactional finish. Land checks proof freshness, applies only the proven sandbox, verifies identity, syncs specs, archives, and cleans up. An interrupted or multi-repository Land resumes from its journal rather than leaving you half-applied.

Risk, not size, selects rigor. Size only controls budget and slicing. A one-line change that touches an auth boundary is not treated as trivial.

Where to go next

Section titled “Where to go next”