Task Planning
Purpose
Generate the implementation plan: dependency-ordered dynamic phases and concrete tasks with acceptance criteria. Implements ../../system/PHASE_GENERATION_RULES.md and TASK_GENERATION_RULES.md. Feeds Gate 4.
When to Use
- After architecture is set, to produce phases and tasks for approval.
- When re-planning because scope, dependencies, or discovered state changed.
- Not for a single obvious task with clear acceptance criteria already agreed.
Inputs
- Architecture + repository layout.
- Selected applications, approved stack, requirement baseline.
- The relevant work-item type planning skill (feature/bug/refactor/migration).
Discovery Questions
- What must exist before what (dependencies)?
- What is the critical path vs deferrable work?
- Which tasks can run in parallel; which touch the same files?
- What are the exit gates per phase?
Responsibilities
- Generate phases dynamically from applications, dependencies, architecture, security, testing, deployment, and existing state.
- Break each phase into tasks: ID, title, context, inputs, outputs, acceptance criteria, required skills, risk, priority, estimate, dependencies — vocabulary from
../../system/PROJECT_MANAGEMENT_RULES.md.
- Write each task's acceptance criteria as Gherkin scenarios (
../../system/GHERKIN_RULES.md, testing/gherkin-specifications) — one behavior per scenario, observable outcomes. The scenario is the criterion; it is not restated in prose.
- Order tasks by dependency; mark parallel-safe vs same-file tasks.
- Attach an exit gate to each phase.
- Record everything in
../../work-items/ and ../../projects/current/.
Required Workflow
- Read architecture + apps + stack + requirements.
- Derive phases (dependency-ordered, right-sized).
- For each phase, generate tasks whose acceptance criteria are the approved scenarios — each task names the scenarios (file + title) it delivers. Behavior with no scenario goes back for specification, not into a task.
- Mark parallelizable tasks (input to
../../system/MULTI_AGENT_RULES.md).
- Attach testing/security requirements per phase.
- Present for Gate 4; record on approval and hand to
project-management to schedule into weeks.
Decision Rules
- No fixed roadmap — phases come from the actual work.
- Foundations (design system, contracts, auth) precede dependent features.
- Every bug work item includes a regression-test task.
- A task is parallel-safe only if its file scope is disjoint from concurrent tasks.
- Right-size: don't 7-phase a one-line change; don't one-phase a marketplace.
Rules
- Every task states how it is verified (command/test/manual, or "unverified until run").
- Keep task notes concise; link, don't duplicate.
- No implementation before Gate 4 approval.
Anti-Patterns
- Reusing one template roadmap for every project.
- Tasks with no acceptance criteria.
- Marking file-conflicting tasks as parallel.
- Over-granular tasks whose coordination cost exceeds the work.
Validation Checklist
Definition of Done
Approved dynamic phases and tasks (with acceptance criteria, dependencies, and gates) recorded in ../../work-items/ and ../../projects/current/, ready for implementation.
Related Skills
architecture-design, feature-planning, bug-investigation, refactor-planning, migration-planning, testing-strategy, security-review, project-orchestrator, project-management (schedules the approved tasks).
Related Knowledge
../../knowledge/ (architecture/domain).
Related References
None typically.
Context Loading Guidance
- Requires: architecture, apps, stack, requirements.
- Does not require: full source, unrelated references, review skills' bodies.
- May load: the matching work-item planning skill;
testing-strategy for test tasks.
- Stop when: phases + tasks are approved (Gate 4).
Token Efficiency Guidance
Plan from summaries. Keep task records lean — status, criteria, links. Generate the next phase's tasks in detail; keep later phases coarse until reached.
1---2name: task-planning3description: Use to generate dynamic phases and break them into concrete, verifiable tasks with inputs, outputs, acceptance criteria, and dependencies. Produces the implementation plan approved at Gate 4. Phases are derived from real work, never a fixed template.4metadata:5 source: https://skillmd.com/skills/ahtishamshahzad/task-planning6---78# Task Planning910## Purpose1112Generate the implementation plan: dependency-ordered dynamic phases and concrete tasks with acceptance criteria. Implements `../../system/PHASE_GENERATION_RULES.md` and `TASK_GENERATION_RULES.md`. Feeds Gate 4.1314## When to Use1516- After architecture is set, to produce phases and tasks for approval.17- When re-planning because scope, dependencies, or discovered state changed.18- **Not** for a single obvious task with clear acceptance criteria already agreed.1920## Inputs2122- Architecture + repository layout.23- Selected applications, approved stack, requirement baseline.24- The relevant work-item type planning skill (feature/bug/refactor/migration).2526## Discovery Questions2728- What must exist before what (dependencies)?29- What is the critical path vs deferrable work?30- Which tasks can run in parallel; which touch the same files?31- What are the exit gates per phase?3233## Responsibilities3435- **Generate phases dynamically** from applications, dependencies, architecture, security, testing, deployment, and existing state.36- Break each phase into **tasks**: ID, title, context, inputs, outputs, acceptance criteria, required skills, risk, priority, estimate, dependencies — vocabulary from `../../system/PROJECT_MANAGEMENT_RULES.md`.37- Write each task's acceptance criteria as **Gherkin scenarios** (`../../system/GHERKIN_RULES.md`, `testing/gherkin-specifications`) — one behavior per scenario, observable outcomes. The scenario is the criterion; it is not restated in prose.38- Order tasks by dependency; mark **parallel-safe** vs **same-file** tasks.39- Attach an **exit gate** to each phase.40- Record everything in `../../work-items/` and `../../projects/current/`.4142## Required Workflow43441. Read architecture + apps + stack + requirements.452. Derive phases (dependency-ordered, right-sized).463. For each phase, generate tasks whose acceptance criteria are the approved scenarios — each task names the scenarios (file + title) it delivers. Behavior with no scenario goes back for specification, not into a task.474. Mark parallelizable tasks (input to `../../system/MULTI_AGENT_RULES.md`).485. Attach testing/security requirements per phase.496. Present for Gate 4; record on approval and hand to `project-management` to schedule into weeks.5051## Decision Rules5253- No fixed roadmap — phases come from the actual work.54- Foundations (design system, contracts, auth) precede dependent features.55- Every bug work item includes a regression-test task.56- A task is parallel-safe only if its file scope is disjoint from concurrent tasks.57- Right-size: don't 7-phase a one-line change; don't one-phase a marketplace.5859## Rules6061- Every task states how it is verified (command/test/manual, or "unverified until run").62- Keep task notes concise; link, don't duplicate.63- No implementation before Gate 4 approval.6465## Anti-Patterns6667- Reusing one template roadmap for every project.68- Tasks with no acceptance criteria.69- Marking file-conflicting tasks as parallel.70- Over-granular tasks whose coordination cost exceeds the work.7172## Validation Checklist7374- [ ] Phases derived from real inputs (not a template).75- [ ] Dependency ordering explicit.76- [ ] Each task: inputs, outputs, acceptance criteria, skills, risk.77- [ ] Parallel-safe vs same-file tasks marked.78- [ ] Exit gate per phase.79- [ ] Testing/security requirements attached.80- [ ] Presented for Gate 4.8182## Definition of Done8384Approved dynamic phases and tasks (with acceptance criteria, dependencies, and gates) recorded in `../../work-items/` and `../../projects/current/`, ready for implementation.8586## Related Skills8788`architecture-design`, `feature-planning`, `bug-investigation`, `refactor-planning`, `migration-planning`, `testing-strategy`, `security-review`, `project-orchestrator`, `project-management` (schedules the approved tasks).8990## Related Knowledge9192`../../knowledge/` (architecture/domain).9394## Related References9596None typically.9798## Context Loading Guidance99100- **Requires:** architecture, apps, stack, requirements.101- **Does not require:** full source, unrelated references, review skills' bodies.102- **May load:** the matching work-item planning skill; `testing-strategy` for test tasks.103- **Stop when:** phases + tasks are approved (Gate 4).104105## Token Efficiency Guidance106107Plan from summaries. Keep task records lean — status, criteria, links. Generate the next phase's tasks in detail; keep later phases coarse until reached.