Archive

Preserve History

Keep all files for future reference and learning.

Clean Workspace

After archiving, task folder is removed to keep .gtd/ clean.

1. Determine Task Name

If no argument provided, ask user:

Which task would you like to archive?

Available tasks:
- {task 1}
- {task 2}

2. Check Task Exists

Verify ./.gtd/<task_name>/ exists:

if [ ! -d "./.gtd/<task_name>" ]; then
    echo "Error: Task '<task_name>' not found"
    exit 1
fi

3. Create Archive Directory

Generate archive name with timestamp:

TIMESTAMP=$(date +%Y%m%d-%H%M%S)
ARCHIVE_DIR="./.gtd/archive/<task_name>-${TIMESTAMP}"
mkdir -p "./.gtd/archive"

4. Move Task Folder

Move entire task folder to archive:

mv "./.gtd/<task_name>" "${ARCHIVE_DIR}"

5. Commit Archive

Commit the archive:

git add ./.gtd/archive/
git commit -m "chore: archive task <task_name> to {task_name}-${TIMESTAMP}"

6. Display Summary

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 GTD ► TASK ARCHIVED ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Task: {task_name}
Archived to: ./.gtd/archive/{task_name}-{timestamp}/

Phases archived: {count}
Files archived: {count}

Task folder removed from ./.gtd/

─────────────────────────────────────────────────────

<forced_stop> STOP. The workflow is complete. Do NOT automatically run the next command. Wait for the user. </forced_stop>