Initial commit

commands/advise.md

@@ -0,0 +1,80 @@
+---
+tags: ["workflow", "development", "collaborative"]
+description: "Get implementation guidance for a phase without automated code generation - user implements manually"
+argument-hint: "TASK-### PHASE | TASK-### --next | --next"
+allowed-tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob", "Task"]
+model: claude-sonnet-4-5
+references_guidelines:
+  - docs/development/workflows/pm-workflows.md  # Phase structure, quality gates, completion protocol
+  - docs/development/workflows/worklog-format.md  # ADVICE entry format
+  - docs/development/workflows/task-workflow.md  # Quality gates, collaborative mode
+  - docs/development/workflows/agent-coordination.md  # Advisory mode agent coordination
+---
+
+# /advise Command
+
+**WHAT**: Provide structured implementation guidance for a phase WITHOUT writing code - user implements manually following advice.
+
+**WHY**: Collaborative mode enables hands-on learning, full control over implementation, and balance between automation and manual coding.
+
+**HOW**: See pm-guide.md for phase requirements and completion protocol. See task-workflow.md for collaborative implementation mode. See agent-coordination.md for advisory mode patterns.
+
+## Usage
+
+```bash
+/advise TASK-001 1.2        # Get guidance for Phase 1.2
+/advise TASK-001 --next     # Smart: find and advise on next uncompleted phase
+/advise --next              # Auto-detect current task, advise next phase
+```
+
+## Execution Flow
+
+**Before you start**: Read pm-guide.md for phase requirements and completion protocol. Read task-workflow.md for collaborative implementation mode. Read agent-coordination.md for advisory mode patterns.
+
+### High-Level Steps
+
+1. **Parse & Locate**
+   - Parse issue ID and phase number (or auto-detect next)
+   - Locate issue directory: pm/issues/{ISSUE-ID}-*/
+   - Read TASK.md/BUG.md, PLAN.md
+
+2. **Analyze Context**
+   - Read CLAUDE.md, coding-standards.md, architecture-overview.md
+   - Grep existing code patterns in codebase
+   - Understand phase requirements and project constraints
+
+3. **Invoke Advisory Agents**
+   - code-architect: Architectural approach, patterns, integration points
+   - security-auditor: Security considerations (if applicable)
+   - test-engineer: Test strategy and scenarios
+   - **All agents in advisory mode**: No code generation, guidance only
+
+4. **Compile Guidance Document**
+   - Suggested approach (high-level strategy)
+   - Implementation details (signatures, types, patterns)
+   - Files to create/modify
+   - Security considerations (if applicable)
+   - Testing strategy
+   - Code examples (minimal scaffolding)
+
+5. **Create WORKLOG Entry**
+   - Write ADVICE entry per worklog-format.md
+   - Document guidance provided
+   - Mark phase as advised
+
+6. **Present to User**
+   - Output structured advice for manual implementation
+   - User implements following guidance
+   - User marks phase complete in PLAN.md
+   - Same quality gates apply as /implement
+
+**See task-workflow.md "Collaborative Implementation Mode" for complete workflow and examples.**
+
+## Mode Comparison
+
+**`/implement`** (Automated): AI writes code, fast, best for boilerplate/standard patterns
+**`/advise`** (Collaborative): User writes code with AI guidance, hands-on learning, best for complex logic
+
+**Hybrid approach** (recommended): `/implement` for boilerplate → `/advise` for complex logic → `/implement` for tests
+
+See task-workflow.md for complete workflow patterns and examples.