spec-kit/templates/tasks-template.md

description

description
Task list template for feature implementation

Tasks: [FEATURE NAME]

Input: Design documents from /specs/[###-feature-name]/ Prerequisites: plan.md (required), research.md, data-model.md, contracts/

Tests: The examples below include test tasks. Tests are OPTIONAL - only include them if explicitly requested in the feature specification.

Format: [ID] [P?] Description

• [P]: Can run in parallel (different files, no dependencies)
• Include exact file paths in descriptions

Path Conventions

• Single project: src/, tests/ at repository root
• Web app: backend/src/, frontend/src/
• Mobile: api/src/, ios/src/ or android/src/
• Paths shown below assume single project - adjust based on plan.md structure

Phase 3.1: Setup

• T001 Create project structure per implementation plan
• T002 Initialize [language] project with [framework] dependencies
• T003 [P] Configure linting and formatting tools

Phase 3.2: Tests First (TDD) - OPTIONAL ⚠️

NOTE: This phase is only included if tests are explicitly requested If included: These tests MUST be written and MUST FAIL before ANY implementation

• T004 [P] Contract test POST /api/users in tests/contract/test_users_post.py
• T005 [P] Contract test GET /api/users/{id} in tests/contract/test_users_get.py
• T006 [P] Integration test user registration in tests/integration/test_registration.py
• T007 [P] Integration test auth flow in tests/integration/test_auth.py

Phase 3.3: Core Implementation

• T008 [P] User model in src/models/user.py
• T009 [P] UserService CRUD in src/services/user_service.py
• T010 [P] CLI --create-user in src/cli/user_commands.py
• T011 POST /api/users endpoint
• T012 GET /api/users/{id} endpoint
• T013 Input validation
• T014 Error handling and logging

Phase 3.4: Integration

• T015 Connect UserService to DB
• T016 Auth middleware
• T017 Request/response logging
• T018 CORS and security headers

Phase 3.5: Polish

• T019 [P] Documentation updates in docs/
• T020 Code cleanup and refactoring
• T021 Performance optimization
• T022 [P] Unit tests (if requested) in tests/unit/
• T023 Run quickstart.md validation

Dependencies

• Tests (T004-T007) before implementation (T008-T014)
• T008 blocks T009, T015
• T016 blocks T018
• Implementation before polish (T019-T023)

Parallel Example

# Launch T004-T007 together:
Task: "Contract test POST /api/users in tests/contract/test_users_post.py"
Task: "Contract test GET /api/users/{id} in tests/contract/test_users_get.py"
Task: "Integration test registration in tests/integration/test_registration.py"
Task: "Integration test auth in tests/integration/test_auth.py"

Notes

• [P] tasks = different files, no dependencies
• Verify tests fail before implementing
• Commit after each task
• Avoid: vague tasks, same file conflicts