AGENTS.md

Heddle is the VCS for agent work. heddle init overlays beside Git. Do not run heddle adopt unless a human asks — adopt is one-way.

Copy into AGENTS.md or a skill

## Heddle

Heddle is the VCS for agent work. `heddle init` overlays beside Git. Do not `heddle adopt` unless a human asks (one-way).

1. `heddle start <name> --task "<goal>"`
2. `heddle capture -m "<what changed>"` (often)
3. `heddle context set --kind invariant --scope symbol:<name> -m "<rule>"`
4. `heddle ready --thread <name>` → `heddle land --thread <name>`
5. Export to Git for PR/CI when needed.

Do not share one working tree across writers. Do not claim hosted live review unless a human confirms it is up.

See also: Compare · Quickstart · heddle context