···44444545When a goal becomes an executable slice, make sure it has goal/non-goals, relevant files/contracts, verified facts, steps or constraints, validation, risks/open decisions, and review expectations.
46464747-For small, immediate implementation handoffs, you may use `write_plan` and `handoff_plan` directly, but run the handoff review gate first: at least one `code-reviewer`; for larger plans, the three-reviewer panel with pinned `model_override` values `codex/gpt-5.5(medium)`, `anthropic/claude-opus-4-8(medium)`, and `zai/glm-5.2(max)`. Fix or rebut every Critical/High finding, re-run until clean, and stop for operator input if a pinned model does not resolve.
4747+For small, immediate implementation handoffs, you may use `write_plan` and `handoff_plan` directly, but run the handoff review gate first: at least one `code-reviewer`; for larger plans, the three-reviewer panel with pinned `model_override` values `codex/gpt-5.5(medium)`, `anthropic/claude-opus-4-8(medium)`, and `zai/glm-5.2(max)`. Fix or rebut every Critical/High finding, re-run until clean, and stop for operator input if a pinned model does not resolve. Ensure you tell the reviewer the exact absolute path to the plan file to read it.
48484949For larger implementation planning, switch to `plan` so the dedicated planning facet can produce and review the execution handoff.
+1
.polytoken/facets/plan.md
···2626- For small/simple handoffs, run at least one `plan-reviewer` subagent against the handoff plan.
2727- For larger plans, run three reviewers in parallel using `code-reviewer` with `model_override` values `codex/gpt-5.5(medium)`, `anthropic/claude-opus-4-8(medium)`, and `zai/glm-5.2(max)`.
2828- If a pinned `model_override` does not resolve at runtime, stop and ask the operator; do not silently substitute a weaker model.
2929+- ensure you tell the reviewer the exact absolute path to the plan file to read it.
2930- Fix or rebut every Critical/High finding with evidence. If `edit_plan` is available, edit the plan; otherwise write a revised handoff plan with `write_plan`.
3031- Re-run the same reviewer set while any reviewer returns any Critical or High finding.
3132- Only call `handoff_plan` when all reviewers report zero Critical and zero High findings, or when the operator explicitly accepts the risk.
···100100101101Run the configured reviewer set. Default panel:
102102103103-- `code-reviewer` with `model_override` `codex/gpt-5.5(high)`
104104-- `code-reviewer` with `model_override` `anthropic/claude-opus-4-8(medium)`
103103+- `code-reviewer` with `model_override` `codex/gpt-5.5(medium)`
104104+- `code-reviewer` with `model_override` `codex/gpt-5.4-mini(xhigh)`
105105- `code-reviewer` with `model_override` `zai/glm-5.2(max)`
106106107107Ask reviewers for Critical/High/Medium/Low findings, with evidence and suggested fixes.
+1-1
.polytoken/skills/jira-solo-tasker-plan/SKILL.md
···125125Before `handoff_plan`, run three `plan-reviewer` subagents in parallel with the configured/pinned models:
126126127127- `codex/gpt-5.5(medium)`
128128-- `anthropic/claude-opus-4-8(medium)`
128128+- `codex/gpt-5.4-mini(xhigh)`
129129- `zai/glm-5.2(max)`
130130131131Fix or rebut every plan finding with evidence. Re-run the same reviewer set while any reviewer returns any Critical or High finding.
+1-1
.polytoken/subagents/code-reviewer.md
···33description: Adversarial reviewer for implementation plans, code changes, tests, and shipping quality. Use before handoff, after implementation, or when review gates require independent scrutiny.
44polytoken:
55 model: default_model:full
66- tools: [file_read, grep, glob, shell_exec, skill]
66+ tools: [file_read, grep, glob, shell_exec, skill, mcp__atlassian]
77 undeferred_tools: [file_read, grep, glob]
88 skills_allow: ["reviewing-code-for-shipping-quality", "polytoken:investigating-a-codebase"]
99---