Field noteAug 4, 20261 min read1 source

AGENTS.md Becomes The Operating Constitution

A long-running coding-agent practice turns AGENTS.md from a prompt convenience into an operational boundary for scope, verification, and local habits.

In one minute

A long-running coding-agent practice turns AGENTS.md from a prompt convenience into an operational boundary for scope, verification, and local habits. A project instruction file starts as a convenience. After enough real agent work, it becomes something closer to operations infrastructure.

New Runtime synthesiseditorial-diagram
Hand-drawn flow where many coding-agent sessions are distilled into an AGENTS.md file that produces scoped refactors, onboarding, and repeatable checks.
New Runtime synthesis: durable instructions become infrastructure only when they are maintained inside the project boundary.New Runtime synthesis from public source materialOriginal source ->
  1. SessionsRepeated work produces failures, corrections, and local conventions.
  2. AGENTS.mdThe durable file captures instructions that future agents can load before acting.
  3. Scope gateRules need boundaries; not every local habit belongs in public API compatibility policy.

A project instruction file starts as a convenience. After enough real agent work, it becomes something closer to operations infrastructure.

The useful part is not that every preference gets pasted into one file. The useful part is that repeated failures become scoped rules: how to inspect the worktree, when to preserve dirty changes, how to validate a release, what not to publish, and which local paths are canonical.

That makes AGENTS.md a boundary object between chat memory and repository memory. A new session can enter the project without rediscovering every local habit from scratch.

The warning is scope. Advice that is correct for a greenfield prototype can be wrong for a public API, a migration path, or an owner-approved publication flow. Instructions become stronger when they say where they apply.

For New Runtime, this is the same lesson as the drip queue: durable behavior should live in files, scripts, and gates, not in the confidence of the current conversation.

Evidence / sources

  1. 1x.com/MarcosHernanz/status/2083954734487212511
All Field Notes

Next reads

Read next

Open the graph
  1. 01topicCoding AgentsExplore the coding-agents topic hub.
  2. 02topicOperationsExplore the operations topic hub.
  3. 03topicDeveloper ToolsExplore the developer-tools topic hub.
  4. 04archiveField NotesOpen the latest editorial analysis.
  5. 05source ledgerSource LedgerInspect the public source evidence graph.
Who read this page?Machine requests, hidden until opened

Loading the privacy-safe route aggregate...

Open the JSON contract