---
name: generate-tasks
description: Convert PRD to structured task list with automatic linking
argument-hint: <prd-file> [--output-dir <directory>]
---
# generate-tasks
**Category**: Task Management
## Usage
```bash
generate-tasks <prd-file> [--output-dir <directory>]
```
## Arguments
- `<prd-file>`: Required - Path to the PRD file to convert
- `--output-dir`: Optional - Directory for task file (default: ./tasks/)
## Execution Instructions for Claude Code
When this command is run, Claude Code should:
1. Read the PRD file and extract metadata
2. Analyze PRD content to generate a comprehensive task list
3. Create task file with proper naming convention:
- For `*-prd.md`: create `*-prd-tasks.md`
- For `*-frd.md`: create `*-frd-tasks.md`
- For `*-simple-frd.md`: create `*-simple-frd-tasks.md`
4. Save task file in the specified output directory (create if needed)
5. Update the PRD with a reference to the generated task file:
- Add or update the "Implementation Tracking" section
- Include task file path and generation date
6. Follow any additional process in the source documentation
## Task File Format
Generated task file should include:
```markdown
# [PRD Title] Implementation Tasks
Source PRD: [relative path to PRD]
Generated: [date]
Total Tasks: [count]
Completed: 0
## Tasks
- [ ] 1.0 Setup and Configuration
- [ ] 1.1 Review relevant documentation
- [ ] 1.2 Set up development environment
- [ ] 2.0 Core Implementation
- [ ] 2.1 [Specific task based on PRD]
...
```
## PRD Update
Add to PRD under "Implementation Tracking" section:
```markdown
## Implementation Tracking
Task List: ./tasks/[filename]-tasks.md
Generated: 2025-01-06
Status: See task file for current progress
```
## Source Content Location
The full process documentation can be found at:
`claude_settings/python/shared/processes/task-generation.md`
Claude Code should read this file and follow the documented process exactly.
## Example
```bash
# Generate tasks in default location
generate-tasks user-auth-frd.md
# Generate tasks in specific directory
generate-tasks inventory-prd.md --output-dir ../tasks/
# Generate from PRD in another directory
generate-tasks ./drafts/feature-prd.md
```
## Implementation Tips for Claude Code
1. **Smart Task Generation**: Analyze PRD sections to create relevant tasks
2. **Task Grouping**: Organize tasks by implementation phases
3. **Documentation First**: Always include doc review as first subtask
4. **Path Management**: Use relative paths for portability
5. **Metadata Preservation**: Extract PRD title and key info for task file header
