Step 2 · Make Actionable Plan and Add to TODO

Goal

Break down the product scope into actionable development tasks and populate TODO.md with prioritized work items.

Instructions

You are in workflow step 2 of the scope-cycle. Your goal is to create a detailed, actionable development plan.

Tasks to perform

1. Review SCOPE.md

  • Read the complete product scope document.
  • Understand all features, requirements, and constraints.
  • Identify dependencies between components.

2. Create Implementation Phases

  • Phase 1: Foundation (database, models, basic structure)
  • Phase 2: Core Features (main functionality)
  • Phase 3: Advanced Features (nice-to-have items)
  • Phase 4: Polish (testing, optimization, documentation)

3. Break Down Into Tasks

For each feature in SCOPE.md, create specific tasks:

  • Database migrations
  • Model creation
  • API endpoints
  • Business logic
  • Frontend components
  • Tests
  • Documentation

4. Create PLAN.md

  • Document the implementation plan with phases.
  • List all tasks organized by phase.
  • Include estimated complexity (S/M/L).
  • Note dependencies between tasks.

5. Populate TODO.md

  • Add Phase 1 tasks to TODO.md with checkboxes.
  • Use conventional commit prefixes (feat:, fix:, refactor:, etc.).
  • Prioritize tasks from most foundational to dependent.

Expected Output

After completing this workflow step, you should have created:

  • PLAN.md — complete implementation roadmap with phases.
  • TODO.md — populated with Phase 1 actionable tasks.

Example TODO.md output

## Todo

### Phase 1: Foundation
- [ ] feat: create database migration for users table _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_
- [ ] feat: create database migration for teams table _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_
- [ ] feat: create User model with relationships _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_
- [ ] feat: create Team model with relationships _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_
- [ ] feat: add authentication scaffold (login, register, logout) _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_

### Phase 2: Core Features
- [ ] feat: implement project creation endpoint _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_
- [ ] feat: implement project listing with pagination _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_
- [ ] test: add unit tests for User model _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_

TODO status rules: [ ] = not started · [~] = in progress (one at a time) · [x] = done (prefix the date). Always include _(ref: workflows/scope-cycle/02-make-actionable-plan.md)_ on every task written by this step.

Example PLAN.md template

# Implementation Plan

## Phase 1: Foundation (Week 1)
| Task | Complexity | Depends On |
|---|---|---|
| Database migrations | S | — |
| Core models | M | Migrations |
| Auth scaffold | M | User model |

## Phase 2: Core Features (Week 2–3)
...

Exit Criteria

This workflow step is complete when:

  • PLAN.md has been created with all phases.
  • TODO.md is populated with Phase 1 tasks.
  • Tasks are ordered by priority and dependency.
  • You have committed both files.