Add decision-oriented usage guide#34
Conversation
Suggested changes for GUIDE.md
|
rjcorwin
left a comment
There was a problem hiding this comment.
Nice addition! See changes requested. Also plz rebase to drop the unrelated commits. Thank you!
|
|
||
| Runs the entire review loop (work → review → gate → iterate) 3 times. Each round starts fresh work, goes through its own quality gate, and must reach DONE before the next round begins. This gives 3 independent review-gated passes. | ||
|
|
||
| **Use this when:** You want multiple rounds of quality-gated work — for instance, a first round for basic implementation, a second round for edge cases, and a third for polish. Each round builds on the last but goes through its own quality check. |
There was a problem hiding this comment.
Interesting use case, but these operators don't fit that pattern (yet). For example, sounds like we'd want to define a different review/gate prompt for each xN iteration, but in its current form it would use the same prompts for each iteration. This use case might not need an addition to cook, instead chaining them with sequential commands. ie. `cook "add dark mode" review && cook "improve accessibility of dark mode" review
| | Mode | When to use | | ||
| |---|---| | ||
| | `--sandbox agent` (default) | Most of the time. Each agent uses its own built-in sandboxing. No setup required. | | ||
| | `--sandbox docker` | When you need network isolation, a reproducible environment, or you're using OpenCode (which requires Docker). Also useful in CI/CD where you want guaranteed clean environments. | |
There was a problem hiding this comment.
Some more reasons to use docker sandbox:
- I find it useful to not have to define every command that the agent should and shouldn't run like we have to with agent sandbox solutions.
- Your environment variables are not exposed here, like they are in Claude's agent sandbox.
GUIDE.md helps users pick the right command for their situation, structured around escalation levels, decision flowcharts, head-to-head comparisons, and real-world recipes rather than reference docs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
9a9442d to
88649eb
Compare
|
An aside, this guide seems like good context for the cook skill. Adding it into the scale could help steer the agent towards the right configuration. This could also be the basis for a /cook-help skill that instructs the agent to ask the user a series of questions to determine the right config for the job. |
Summary
GUIDE.md— a task-oriented guide that helps users pick the right cook command for their situationxNvsreview,vNvsvs,pickvsmergevscompare), real-world recipes, and an operator-order explainerTest plan
🤖 Generated with Claude Code