ajianaz/task-planner

Task Generator

Generate detailed, step-by-step task lists from specs, plans, or requirements.

Workflow (2-Phase Process)

Phase 1: Generate Parent Tasks

1. Analyze the spec/plan content for functional requirements and implementation scope
2. Create the task file at /tasks/tasks-[feature-name].md
3. Generate 5-7 high-level parent tasks:
   • Always start with task 0.0: "Create feature branch" (unless user explicitly opts out)
   • Use your judgment for the number of additional tasks
4. Present parent tasks to user in the output format (without sub-tasks)
5. Tell user: "I have generated the high-level tasks. Ready to generate sub-tasks? Reply Go to proceed."

Phase 2: Generate Sub-Tasks

1. Wait for user to reply "Go"
2. Break down each parent task into smaller, actionable sub-tasks
3. Identify relevant files to create/modify (include test files)
4. Update the task file with complete structure

Output Format

Save to /tasks/tasks-[feature-name].md:

## Relevant Files

- `path/to/file.ts` - Brief description of why this file is relevant
- `path/to/file.test.ts` - Unit tests for file.ts
- `path/to/component.tsx` - Component description
- `path/to/component.test.tsx` - Unit tests for component.tsx

### Notes

- Unit tests should be placed alongside the code files they test
- Use `npx jest [optional/path/to/test/file]` to run tests

## Instructions for Completing Tasks

**IMPORTANT:** As you complete each task, check it off by changing `- [ ]` to `- [x]`. Update after completing each sub-task.

## Tasks

- [ ] 0.0 Create feature branch
  - [ ] 0.1 Create and checkout new branch (`git checkout -b feature/[feature-name]`)
- [ ] 1.0 [Parent Task Title]
  - [ ] 1.1 [Sub-task description]
  - [ ] 1.2 [Sub-task description]
- [ ] 2.0 [Parent Task Title]
  - [ ] 2.1 [Sub-task description]

Guidelines

• Target audience: Junior developer who will implement the feature
• Task style: Use imperative verbs (Create, Add, Implement, Update)
• Feature name: Derive from spec title/topic in kebab-case
• File identification: Include both source and test files
• Sub-task granularity: Each sub-task should be completable in one focused session