Agent Operating Guide

A repository document, rendered for the site. View source markdown.

Generated at: 2026-07-30T12:38:02.000Z UTC · source: committed helm-expt evidence for this rendered repository document.


title: Agent Operating Guide status: current last_reviewed: 2026-06-14 ---

The canonical agent/operator docs now live in docs/agent/README.md. Use this page as a compact knowledge-layer reminder, not as a replacement for the agent docs.

Start from the generated front doors, not from old planning prose.

Use:

When editing generated surfaces, update the generator and regenerate the output. When editing live lanes, run only one live lane at a time and preserve receipts. When checking a narrow change, use scoped checks. Use full npm run verify only for a broad release gate or when explicitly asked.

Do not make a watch or blocked row green from prose. The receipt must carry the evidence.

Parallel agents should communicate through PRs, avoid live-lane collisions, and state exactly which generated surfaces they touched.

Authoritative Sources