cook

# Cook - Smart Feature Implementation End-to-end implementation with automatic workflow detection. **Principles:** YAGNI, KISS, DRY | Token efficiency | Concise reports ## Usage ``` /cook <natural language task OR plan path> ``` **IMPORTANT:** If no flag is provided, the skill will use the `interactive` mode by default for the workflow. **Optional flags to select the workflow mode:** - `--interactive`: Full workflow with user input (**default**) - `--fast`: Skip research, scout→plan→code - `--parallel`: Multi-agent execution - `--no-test`: Skip testing step - `--auto`: Auto-approve all steps **Example:** ``` /cook "Add user authentication to the app" --fast /cook path/to/plan.md --auto ``` ## Smart Intent Detection | Input Pattern | Detected Mode | Behavior | |---------------|---------------|----------| | Path to `plan.md` or `phase-*.md` | code | Execute existing plan | | Contains "fast", "quick" | fast | Skip research, scout→plan→code | | Contains "trust me", "auto" | auto | Auto-approve all steps | | Lists 3+ features OR "parallel" | parallel | Multi-agent execution | | Contains "no test", "skip test" | no-test | Skip testing step | | Default | interactive | Full workflow with user input | See `references/intent-detection.md` for detection logic. ## Workflow Overview ``` [Intent Detection] → [Research?] → [Review] → [Plan] → [Review] → [Implement] → [Review] → [Test?] → [Review] → [Finalize] ``` **Default (non-auto):** Stops at `[Review]` gates for human approval before each major step. **Auto mode (`--auto`):** Skips human review gates, implements all phases continuously. **Claude Tasks:** Utilize all these tools `TaskCreate`, `TaskUpdate`, `TaskGet` and `TaskList` during implementation step. | Mode | Research | Testing | Review Gates | Phase Progression | |------|----------|---------|--------------|-------------------| | interactive | ✓ | ✓ | **User approval at each step** | One at a time | | auto | ✓ | ✓ | Auto if score≥9.5 | All at once (no stops) | | fast | ✗ | ✓ | **User approval at each step** | One at a time | | parallel | Optional | ✓ | **User approval at each step** | Parallel groups | | no-test | ✓ | ✗ | **User approval at each step** | One at a time | | code | ✗ | ✓ | **User approval at each step** | Per plan | ## Step Output Format ``` ✓ Step [N]: [Brief status] - [Key metrics] ``` ## Blocking Gates (Non-Auto Mode) Human review required at these checkpoints (skipped with `--auto`): - **Post-Research:** Review findings before planning - **Post-Plan:** Approve plan before implementation - **Post-Implementation:** Approve code before testing - **Post-Testing:** 100% pass + approve before finalize **Always enforced (all modes):** - **Testing:** 100% pass required (unless no-test mode) - **Code Review:** User approval OR auto-approve (score≥9.5, 0 critical) - **Finalize (MANDATORY - never skip):** 1. `project-manager` subagent → update plan/phase status to complete 2. `docs-manager` subagent → update `./docs` if changes warrant 3. `TaskUpdate` → mark all Claude Tasks complete 4. Ask user if they want to commit via `git-manager` subagent ## Required Subagents (MANDATORY) | Phase | Subagent | Requirement | |-------|----------|-------------| | Research | `researcher` | Optional in fast/code | | Scout | `scout` | Optional in code | | Plan | `planner` | Optional in code | | UI Work | `ui-ux-designer` | If frontend work | | Testing | `tester`, `debugger` | **MUST** spawn | | Review | `code-reviewer` | **MUST** spawn | | Finalize | `project-manager`, `docs-manager`, `git-manager` | **MUST** spawn all 3 | **CRITICAL ENFORCEMENT:** - Steps 4, 5, 6 **MUST** use Task tool to spawn subagents - DO NOT implement testing, review, or finalization yourself - DELEGATE - If workflow ends with 0 Task tool calls, it is INCOMPLETE - Pattern: `Task(subagent_type="[type]", prompt="[task]", description="[brief]")` ## References - `references/intent-detection.md` - Detection rules and routing logic - `references/workflow-steps.md` - Detailed step definitions for all modes - `references/review-cycle.md` - Interactive and auto review processes - `references/subagent-patterns.md` - Subagent invocation patterns