Skip to content

docs(overlay): require parent-authored judge briefs #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
zhanfeng-alpha wants to merge 2 commits into from
Closed

docs(overlay): require parent-authored judge briefs #12

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a392618
fix(architect): require parent-authored judge briefs
Sep 12, 2026
f988ad7
fix(overlay): keep judge brief guidance Pi-only
Sep 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions overlay/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down