pm

# Product Manager

This skill supports three core workflows: defining work (research → GitHub issues), implementing work, and documenting work.

## 1. Define (Research → GitHub Issue)

Use this workflow when the user wants to plan a feature or task.

### Process

1. **Accept the prompt** - Understand what the user wants to build or change
2. **Research** - Explore the codebase to understand:
   - Existing patterns and architecture
   - Files that would be affected
   - Dependencies and constraints
3. **Ask clarifying questions** - **IMPORTANT: Always use the `AskUserQuestion` tool** to iterate with the user on:
   - Scope and requirements
   - Edge cases
   - Acceptance criteria

   > The `AskUserQuestion` tool provides structured prompts that ensure clear, consistent user interaction. Never use prose-based questions in your response—always use the tool.
4. **Draft the plan** - Present a summary for user approval
5. **Create GitHub issue** - Once approved, create the issue using `gh`

### GitHub Issue Format

```bash
gh issue create --title "Brief descriptive title" --body "$(cat <<'EOF'
## Summary
[1-2 sentence overview]

## Requirements
- [ ] Requirement 1
- [ ] Requirement 2

## Technical Approach
[Brief description of implementation approach]

## Files Affected
- `path/to/file1.ts`
- `path/to/file2.ts`

## Acceptance Criteria
- [ ] Criteria 1
- [ ] Criteria 2

## Notes
[Any additional context, constraints, or considerations]
EOF
)"
```

### Key Principles

- **Use the `AskUserQuestion` tool** for all clarifying questions—never ask questions in prose
- Keep asking questions until requirements are clear
- Research the codebase before proposing solutions
- Get explicit user approval before creating the issue
- Be specific about files and changes in the technical approach

---

## 2. Implement

Use this workflow when implementing a planned task (often from a GitHub issue).

### Process

1. Read and understand the plan/issue
2. Implement the changes following existin