name: advise
description: "Interactive conversational guidance - user implements with step-by-step advice. Use when you want hands-on implementation with expert guidance while maintaining control."
model: claude-sonnet-4-20250514
allowed-tools: Read, Glob, Grep

/advise

Interactive, conversational guidance as you implement a task yourself.

Usage

/advise 001              # Guide through issue 001
/advise yourbench 001    # Explicit project
/advise 001 --phase 2.1  # Start at specific phase

Comparison: /implement vs /advise vs /teach

What to Expect

Conversational Flow

AI: "First step: Initialize Next.js. The directory has some docs,
     so we'll move those temporarily..."

User: "What does the --no-git flag do?"

AI: "Good question! It tells create-next-app to skip running
     'git init' since you already have a repo..."

User: "Done"

AI: "Let me check... Looks good. Next, we need to clean up
     the boilerplate..."

Guidance Style

• Explains WHAT to do - Clear instructions per step
• Answers questions - Responds to clarifications
• Checks your work - Reviews when you say "done"
• Adapts pace - Moves forward when ready
• Practical focus - Task-focused, not teaching concepts

Execution Flow

1. Load Context

Read: ideas/[project]/issues/###-*/TASK.md
Read: ideas/[project]/issues/###-*/PLAN.md
Read: ideas/[project]/specs/SPEC-###.md (if linked)
Glob: spaces/[project]/docs/project/adrs/ADR-*.md

2. Conversational Guidance

1. Explain the current step simply
2. Wait for user questions or confirmation
3. Answer questions as they come up
4. Check work when user says "done"
5. Move to next step when ready

3. Research as Needed

• Use Context7 for library docs
• WebSearch for best practices
• Reference codebase patterns

4. Check Work

When user says "done":
- Read the modified file
- Check for common mistakes
- Verify it matches requirements
- Suggest fixes if needed

5. Update WORKLOG

At checkpoints:

## YYYY-MM-DD HH:MM - ADVICE: Phase 1 Complete

Guided user through Next.js initialization.
Completed: ...
Next: Phase 2

When to Use

• Know the stack, need guidance on THIS task
• Want control but avoid mistakes
• Prefer hands-on implementation
• Task has complexity worth discussing

Use /implement instead: Just want it done quickly, boilerplate code
Use /teach instead: Learning the technology, need conceptual understanding

Workflow

/issue -> /plan -> /advise -> [you implement] -> /worklog -> /commit