Skip to content

aspiers/ai-config / .agents/skills/task-generation

task-generation

Verified

Turns an existing Product Requirements Prompt at .ai/[feature]/prp.md into a step-by-step task list of parent tasks and sub-tasks, saved to .ai/[feature]/tasks.md and committed. Use when a PRP is ready to be broken down into implementable work, or when planning how a feature will be built before any implementation starts. To write the PRP itself first, use prp- generation.

Task Generation

Generate a detailed, step-by-step task list in Markdown format based on an existing Product Requirements Prompt (PRP).

When to Use This Skill

Use this skill when:

  • A PRP exists at .ai/[feature-name]/prp.md
  • You need to break down the feature into implementable tasks
  • Planning how a junior developer will implement the feature

Input

  • feature_name - Locates the PRP at .ai/[feature-name]/prp.md

Process

  1. Receive PRP Reference: The user points to a specific PRP file
  2. Analyze PRP: Read and analyze the functional requirements, user stories, and other sections
  3. Clarify Open Questions: If there are still any open questions, ask the user for clarification and amend the PRP accordingly before proceeding
  4. Phase 1: Generate Parent Tasks: Based on the PRP analysis, create the main high-level tasks (3-8 parent tasks). Present these to the user in the specified format (without sub-tasks yet). Inform: "I have generated the high-level tasks. Ready to generate sub-tasks? Respond with 'go' to proceed."
  5. Wait for Confirmation: Pause and wait for the user to respond with "go"
  6. Phase 2: Generate Sub-Tasks: Once confirmed, break down each parent task into smaller, actionable sub-tasks
  7. Identify Relevant Files: Based on tasks and PRP, identify potential files that need creation or modification
  8. Generate Final Output: Combine parent tasks, sub-tasks, relevant files, and notes
  9. Save Task List: Save to .ai/[feature-name]/tasks.md
  10. Commit Task List: Stage and commit the new task list

Commit Message Template

feat: add .ai/[feature-name]/tasks.md

Generate tasks according to .ai/[feature-name]/prp.md

Output Format

The tasks.md file must follow this structure:

# Context

See [prp.md][./prp.md] for the corresponding Product Requirements Prompt.

# Relevant Files

- `path/to/file1.ts` - Brief description of why this file is relevant
- `path/to/file1.test.ts` - Unit tests for `file1.ts`
- `path/to/another/file.tsx` - Brief description
- `path/to/another/file.test.tsx` - Unit tests for `another/file.tsx`
- `lib/utils/helpers.ts` - Utility functions needed for calculations
- `lib/utils/helpers.test.ts` - Unit tests for helpers.ts

# Tasks

- [ ] 1. Parent Task Title
  - [ ] 1.1. Sub-task description 1.1
  - [ ] 1.2. Sub-task description 1.2

- [ ] 2. Parent Task Title
  - [ ] 2.1. Sub-task description 2.1

- [ ] 3. Parent Task Title (may not require sub-tasks)

Target Audience

Assume the primary reader is a junior developer who will implement the feature. Tasks should be clear, actionable, and provide enough context for someone less familiar with the codebase to complete them.

Interaction Model

The process explicitly requires a pause after generating parent tasks to get user confirmation ("Go") before proceeding to generate detailed sub-tasks. This ensures the high-level plan aligns with user expectations.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall