# Project Progress Tracking
# This file tracks the overall progress of the project, including milestones, tasks, and recent work.
# Update this file regularly as work progresses.

project:
  name: project-name                    # Replace with your project name
  version: 0.1.0                        # Current version (semantic versioning)
  started: YYYY-MM-DD                   # Date project started
  status: not_started                   # not_started | in_progress | completed
  current_milestone: M1                 # Current milestone identifier
  description: |                        # Brief project description
    A short description of what this project does and its main purpose.

# Milestones represent major phases of the project
milestones:
  - id: M1                              # Unique milestone identifier
    name: Milestone Name                # Descriptive name
    status: not_started                 # not_started | in_progress | completed
    progress: 0                         # Percentage complete (0-100)
    started: null                       # YYYY-MM-DD when started, null if not started
    completed: null                     # YYYY-MM-DD when completed, null if not completed
    estimated_weeks: 2                  # Estimated duration in weeks
    tasks_completed: 0                  # Number of tasks completed
    tasks_total: 5                      # Total number of tasks in this milestone
    notes: |                            # Progress notes and observations
      Notes about this milestone's progress, blockers, or important decisions.
  
  - id: M2
    name: Second Milestone Name
    status: not_started
    progress: 0
    started: null
    completed: null
    estimated_weeks: 3
    tasks_completed: 0
    tasks_total: 7
    notes: |
      This milestone depends on M1 completion.

# Tasks are granular work items within milestones
tasks:
  milestone_1:                          # Group tasks by milestone
    - id: task-1                        # Unique task identifier
      name: Task Name                   # Descriptive task name
      status: not_started               # not_started | in_progress | completed
      file: agent/tasks/task-1-name.md  # Path to task document
      estimated_hours: 4                # Estimated time in hours
      completed_date: null              # YYYY-MM-DD when completed, null if not completed
      notes: |                          # Task-specific notes
        Any important notes about this task.
    
    - id: task-2
      name: Second Task Name
      status: not_started
      file: agent/tasks/task-2-name.md
      estimated_hours: 2
      completed_date: null
      notes: |
        Depends on task-1 completion.
  
  milestone_2:
    - id: task-3
      name: Third Task Name
      status: not_started
      file: agent/tasks/task-3-name.md
      estimated_hours: 6
      completed_date: null
      notes: |
        First task of second milestone.

# Documentation tracking
documentation:
  design_documents: 0                   # Number of design documents created
  milestone_documents: 0                # Number of milestone documents
  pattern_documents: 0                  # Number of pattern documents
  task_documents: 0                     # Number of task documents
  last_updated: YYYY-MM-DD              # Last documentation update date

# Overall progress metrics
progress:
  planning: 0                           # Planning phase completion (0-100%)
  implementation: 0                     # Implementation phase completion (0-100%)
  testing: 0                            # Testing phase completion (0-100%)
  documentation: 0                      # Documentation completion (0-100%)
  overall: 0                            # Overall project completion (0-100%)

# Recent work log (most recent first)
recent_work:
  - date: YYYY-MM-DD                    # Date of work
    description: |                      # Description of what was done
      Brief description of work completed on this date.
    items:                              # Specific items completed
      - ✅ Completed item 1
      - ✅ Completed item 2
      - ⚠️  Warning or note about something
      - 📋 Pending item or follow-up needed
  
  - date: YYYY-MM-DD
    description: |
      Earlier work session description.
    items:
      - ✅ Another completed item
      - 📋 Something to revisit

# Next steps (prioritized list)
next_steps:
  - Next action item 1 (highest priority)
  - Next action item 2
  - Next action item 3
  - Future consideration or enhancement

# General notes and observations
notes:
  - Important note 1 about the project
  - Important note 2 about architectural decisions
  - Important note 3 about dependencies or constraints

# Current blockers (remove when resolved)
current_blockers:
  - Blocker 1: Description of what's blocking progress
  - Blocker 2: Another blocker and potential resolution

# Team and contributors (if applicable)
team:
  - role: Lead Developer              # Role or responsibility
    name: Name or "Agent"             # Name or identifier
    focus: |                          # Current focus area
      What this person/agent is currently working on
  
  - role: Documentation
    name: Name or "Agent"
    focus: |
      Maintaining documentation and patterns

# Dependencies and integrations
dependencies:
  external_services:                  # External services this project depends on
    - name: Service Name
      status: configured | pending | blocked
      notes: |
        Notes about this dependency
  
  libraries:                          # Key library dependencies
    - name: Library Name
      version: 1.0.0
      purpose: |
        Why this library is used
  
  infrastructure:                     # Infrastructure requirements
    - name: Infrastructure Component
      status: ready | pending | blocked
      notes: |
        Notes about this infrastructure

# Quality metrics (optional)
quality:
  test_coverage: 0                    # Percentage (0-100)
  code_review_status: pending         # pending | in