diff --git a/overlay/AGENTS.md b/overlay/AGENTS.md index c090209..c46e13c 100644 --- a/overlay/AGENTS.md +++ b/overlay/AGENTS.md @@ -8,6 +8,8 @@ This file maps Cursor verbs onto Pi. It is process, not repository architecture. When delegation is needed, use only `{ agent: "poteto-agent", task }`. `install.sh` installs this child in `~/.pi/agent/agents/`, disables builtins, and retires the six old role profiles. Give the child a bounded implementation, investigation, or read-only task instead of selecting a different persona. Do not use a parallel worker+reviewer workflow as the default bug-fix loop. Tiny known-mechanism fixes stay parent-inline. +For competing-design bakeoffs, prefer a parent-inline pick when context allows. If using a judge child, the parent must author its task with hard constraints and an explicit preference order. Include "Do not invent parent preference." Limit judge file access to listed `design/*.md` paths. Pass paths, not pasted designs or transcripts. The parent owns the final pick. + The child reads poteto-mode in full and decides reversible details without supervisor gates. It returns missing authorization or genuine product ambiguity in its normal result before taking the blocked action. New sessions see the installed settings and prompts. Existing children keep their old prompts until respawn. Leave `async` on. That is the default. `async:false` only when this turn cannot continue without the child. Do not sleep-poll. Use blocking `subagent_wait` only when this turn must consume the result.