020-tasks-workflow

Task Workflow System (Multi-File in tasks/ Directory)

• Purpose: Standardize task implementation with proper tracking and status updates across a distributed task list.
• Implementation: Tasks are distributed across tasks/tasks-N.md files, indexed by tasks/tasks-index.md.

Overall Task Management Structure

• Index File (tasks/tasks-index.md):

  • Contains the Overall Project Task Summary (Total Tasks, Pending, Complete for the entire project).

  • Contains the Task File Index, mapping Task ID ranges to specific tasks/tasks-N.md files.

    ## Overall Project Task Summary
    
    - **Total Tasks**: {Total for project}
    - **Pending**: {Pending for project}
    - **Complete**: {Complete for project}
    
    ## Task File Index
    
    - `tasks/tasks-1.md`: Contains Tasks {start_id_1} - {end_id_1} ({task_count_1} tasks)
    - `tasks/tasks-2.md`: Contains Tasks {start_id_2} - {end_id_2} ({task_count_2} tasks)
    - ...
    

• Task Files (tasks/tasks-N.md):

  • Each file starts with its own local summary:

    ## Summary (tasks-N.md) // Clarify which task file this summary is for
    
    - **Tasks in this file**: {Count for this file}
    - **Task IDs**: {start_id_N} - {end_id_N} // e.g., 001 - 030
    

  • Followed by the ## Tasks section containing individual tasks.

• Task Structure (within tasks/tasks-N.md)

  • Tasks are defined with:

    ### Task ID: {ID}
    
    - **Title**: Example title
    - **File**: example/file/path (relative to project root, excluding project root dir)
    - **Complete**: [ ]
    
    #### Prompt:
    
    ```markdown
    DETAILED PROMPT INCLUDING TARGET FILE PATH AND CONTEXT
    ```
    

Task Management Workflow

1. Locating a Task

• When user requests "next task":
  1. Open and consult tasks/tasks-index.md to understand the overall project status and identify the sequence of task files.
  2. Iterate through tasks/tasks-1.md, tasks/tasks-2.md, etc., in numerical order as listed in the index.
  3. Within each tasks/tasks-N.md file, find the first task where Complete: [ ]. This is the next task.
  4. Note the tasks/tasks-N.md file this task resides in.
• When user specifies a Task ID (e.g., "Task 042"):
  1. Open and consult tasks/tasks-index.md.
  2. Read the "Task File Index" to determine which tasks/tasks-N.md file contains that Task ID.
  3. Open the identified tasks/tasks-N.md file (e.g., if Task 042 is in tasks-2.md, open tasks/tasks-2.md).
  4. Locate the task with the specified ### Task ID: {ID}.