task_completion_workflow

Task Archival Process

Overview

When a task is completely finished, follow this archival process to maintain a clean, performant workspace while preserving all completed work.

Step 1: Verify Completion

[ ] All requirements in the task are met (check the Requirements checklist) [ ] All subtasks are marked complete [ ] Full test suite passes [ ] All deliverables are working as specified

Step 2: Archive Task File

[ ] Move task file from tasks/task_XXX.md to tasks/completed_tasks/task_XXX.md [ ] Preserve all task content and history in the archived file

Step 3: Clean Up Dependencies

[ ] Search all active task files in tasks/ directory for dependencies on the completed task [ ] Remove the completed task number from dependency lists of active tasks [ ] Update any task descriptions that reference the completed task if needed

Directory Structure

tasks/
├── task_001.md                  # Active task files
├── task_002.md
├── task_003.md
└── completed_tasks/
    ├── task_010.md             # Completed task files
    ├── task_015.md
    └── task_020.md

Benefits of Archival

• Clean workspace: Only active tasks visible in main tasks/ directory
• Preserved history: All completed work maintained in completed_tasks/
• Dependency integrity: No broken references to completed tasks
• Performance: Smaller active task set for better navigation

Validation

This process ensures:

• Completed work is preserved with full context
• Active task dependencies remain clean and accurate
• No loss of historical information or decision context
• Clean separation between active and completed work

This script will:

• ✅ Automatically identify complete task units (main + all subtasks done)
• ✅ Move task files to archive directory
• ✅ Update completed_tasks.json with proper metadata
• ✅ Remove archived tasks from main tasks.json
• ✅ Report file size improvements and performance gains
• ✅ Preserve work integrity by only archiving complete units