Check for circular dependencies, broken references
Phase 5: Generate tasks.md
Create
tasks.md
in same directory as PRD. See
references/tasks-template.md
for full template.
Task Format
Each task must include:
Task X.Y: [Action-oriented Title]
**
Description
**
What and why, referencing PRD
**
Acceptance Criteria
**
:
-
[ ] Specific, testable condition 1
-
[ ] Specific, testable condition 2
**
Dependencies
**
None / Task X.X
**
PRD Reference
**
[Section]
Task Guidelines
Title
Action-oriented (e.g., "Implement user authentication API")
Size
1-3 days of work; break larger features
Criteria
Cover happy path and edge cases
Dependencies
List prerequisites and external dependencies
Quality Checks
Before finalizing:
All PRD requirements addressed
Each task links to PRD
No circular dependencies
Clear MVP vs post-MVP distinction
Ambiguous requirements flagged
All tasks in dependency table
Critical path identified
README Maintenance (ideas repo)
After writing
tasks.md
, if the PRD lives inside an
ideas
repo, update the repo README ideas table:
Preferred:
cd
to the repo root and run
python3 scripts/update_readme_ideas_index.py
(if it exists)
Fallback: update
README.md
manually (ensure Tasks status becomes ✅ for that idea)
Commit and push (mandatory)
Commit immediately after updates.
Push immediately to remote.
If push is rejected:
git fetch origin && git rebase origin/main && git push
.
Do not ask for additional push permission once this skill is invoked.
Reporting with GitHub links (mandatory)
When reporting completion, include:
GitHub link to
tasks.md
GitHub link to
README.md
when it was updated
Commit hash
Link format:
https://github.com/luongnv89/ideas/blob/main/
Output Summary
After generating, provide:
File location
Sprint overview (count, tasks per sprint)
MVP scope summary
Dependency analysis (waves, critical path, bottlenecks)
Flagged ambiguous requirements
Next steps: Review Sprint 1 and Wave 1 tasks first