advise

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

Aspect	/implement	/advise	/teach
Who writes code	AI	You	You
Speed	Fast	Medium	Slower
Depth	Task completion	Task guidance	Conceptual learning
Questions	Few	As needed	Frequent, Socratic

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