Documentation
README
Writing rules — and anything else an agent reads
You are writing for a reader who has already read everything. Explanation is waste; precision is the whole job. Left alone, a model writing instructions for a model spends most of its words restating what it already knows — every one of those lines is a no-op: paid every turn, changing nothing.
The packaging differs (a core/ rule, a profile gate, a SKILL.md, a subagent prompt, a handoff
note) but the writing does not. The same levers make each one predictable, so the agent takes the
same process every run rather than producing the same output.
When the document is a harness surface — a core/ rule, a profile, a skill, a hook — read
HARNESS-SURFACES.md for where it goes and what it costs.
This is the opening of the README. Read the full README on GitHub.