description:

Task list template for feature implementation

Tasks: [FEATURE NAME]

Input: Design documents from /specs/[###-feature-name]/ Prerequisites: plan.md (required), spec.md (required for user stories), 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.

Organization: Tasks are grouped by user story to enable independent implementation and testing of each story.

Format: [ID] [P?] [Story] Description

• [P]: Can run in parallel (different files, no dependencies)
• [Story]: Which user story this task belongs to (e.g., US1, US2, US3)
• 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

<!-- ============================================================================ IMPORTANT: The tasks below are SAMPLE TASKS for illustration purposes only. The /iikit-tasks command MUST replace these with actual tasks based on: - User stories from spec.md (with their priorities P1, P2, P3...) - Feature requirements from plan.md - Entities from data-model.md - Endpoints from contracts/ Tasks MUST be organized by user story so each story can be: - Implemented independently - Tested independently - Delivered as an MVP increment DO NOT keep these sample tasks in the generated tasks.md file. ============================================================================ -->

Phase 1: Setup (Shared Infrastructure)

Purpose: Project initialization and basic structure

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

Phase 2: Foundational (Blocking Prerequisites)

Purpose: Core infrastructure that MUST be complete before ANY user story can be implemented

CRITICAL: No user story work can begin until this phase is complete

• T004 Setup database schema and migrations framework
• T005 [P] Implement authentication/authorization framework
• T006 [P] Setup API routing and middleware structure
• T007 Create base models/entities that all stories depend on
• T008 Configure error handling and logging infrastructure
• T009 Setup environment configuration management

Checkpoint: Foundation ready - user story implementation can now begin in parallel

Phase 3: User Story 1 - [Title] (Priority: P1) MVP

Goal: [Brief description of what this story delivers]

Independent Test: [How to verify this story works on its own]

Tests for User Story 1 (OPTIONAL - only if tests requested)

NOTE: Write these tests FIRST, ensure they FAIL before implementation

• T010 [P] [US1] Contract test for [endpoint] in tests/contract/test_[name].py
• T011 [P] [US1] Integration test for [user journey] in tests/integration/test_[name].py

Implementation for User Story 1

• T012 [P] [US1] Create [Entity1] model in src/models/[entity1].py
• T013 [P] [US1] Create [Entity2] model in src/models/[entity2].py
• T014 [US1] Implement [Service] in src/services/[service].py (depends on T012, T013)
• T015 [US1] Implement [endpoint/feature] in src/[location]/[file].py
• T016 [US1] Add validation and error handling
• T017 [US1] Add logging for user story 1 operations

Checkpoint: At this point, User Story 1 should be fully functional and testable independently

Phase N: Polish & Cross-Cutting Concerns

Purpose: Improvements that affect multiple user stories

• TXXX [P] Documentation updates in docs/
• TXXX Code cleanup and refactoring
• TXXX Performance optimization across all stories
• TXXX [P] Additional unit tests (if requested) in tests/unit/
• TXXX Security hardening
• TXXX Run quickstart.md validation

Dependencies & Execution Order

Phase Dependencies

• Setup (Phase 1): No dependencies - can start immediately
• Foundational (Phase 2): Depends on Setup completion - BLOCKS all user stories
• User Stories (Phase 3+): All depend on Foundational phase completion
• Polish (Final Phase): Depends on all desired user stories being complete

Parallel Opportunities

• All Setup tasks marked [P] can run in parallel
• All Foundational tasks marked [P] can run in parallel (within Phase 2)
• Once Foundational phase completes, all user stories can start in parallel
• All tests for a user story marked [P] can run in parallel
• Models within a story marked [P] can run in parallel

Notes

• [P] tasks = different files, no dependencies
• [Story] label maps task to specific user story for traceability
• Each user story should be independently completable and testable
• Verify tests fail before implementing
• Commit after each task or logical group
• Stop at any checkpoint to validate story independently