byre/docs/agent-corrections.md

Corrections given to agents

Keep this file minimal. Include a correction only when both apply:

• It was given to an agent after the agent took an incorrect path.
• Another agent is likely to take that path again unless the correction is documented.

Write rules only; omit incident histories and anecdotes.

Terminology

• Use “snapshot” for a point-in-time capture of code and conversation context; “revision” implies source control and changes the meaning.

Performance

• Keep the app preloading the transcript of every active, visible task when it loads the task list, so opening a task is instant; never trade that away to save downloads or memory.

Security

• Accept other local OS accounts reaching preview forwards and Chrome’s loopback debugger on personal Macs; do not add authentication or account-isolating brokers for that threat.