subagent wokflows

pi/.pi/agent/skills/subagent-review/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: subagent-review
+description: "Code review using a cross-family reviewer. Use when the user invokes /review."
+---
+
+# /review — Code Review
+
+## Agent Roster
+
+| Agent | Role |
+|-------|------|
+| reviewer | Cross-family code review (finds blind spots the author's model family misses) |
+| fixer | Applies review feedback precisely |
+
+## Workflow
+
+Single reviewer call — no chain needed:
+
+```js
+await subagent({ agent: "reviewer", output: `${chainDir}/review.md`, task: "Review the following changes: <description or files>" })
+```
+
+Read `review.md`. If issues found, apply fixes:
+
+```js
+await subagent({ agent: "fixer", task: `Read and apply the review feedback in ${chainDir}/review.md` })
+```
+
+## Workflow Summary
+
+After review (and optional fix), give the user a brief honest summary:
+
+- **What happened**: did the reviewer find issues, were fixes applied?
+- **Issues**: any agent silent failures, fallbacks used, or unexpected behavior
+- **Agent quality**: did any agent misinterpret the task, produce poor output, or need hand-holding? Name the agent and the problem
+- **Skill improvements**: did this workflow reveal gaps in the skill instructions or agent prompts? Note what should change
+
+Be concise — a few lines is enough when things went well. Only expand on problems.
+
+## Fallback Strategy
+
+When a subagent call returns no output (silent failure), apply cross-family model fallback. **Do not fall back to doing the work yourself** — always retry with the fallback model first.
+
+1. **First attempt**: Use the agent's default model
+2. **If silent failure or error**: Retry with the fallback model using `model` override
+3. **If the fallback also fails**: Report the double-failure to the user. Still do not do the work yourself.
+
+```js
+// Example: reviewer fails silently, retry with fallback
+subagent({ agent: "reviewer", task: "...", model: "zai/glm-5.1" })
+```
+
+| Agent | Primary | Fallback |
+|-------|---------|----------|
+| reviewer | anthropic/claude-opus-4-6 | zai/glm-5.1 |
+| fixer | anthropic/claude-sonnet-4-6 | zai/glm-5.1 |