D Archive

Core responsibilities:

• Check if current debug work is complete
• Create archive with timestamp
• Move all debug files to archive
• Clean up current debug folder

Flow: Verify Complete → Create Archive → Move Files → Clean Up

• ./.gtd/debug/current/ — Current debug work

Destination:

• ./.gtd/archive/debug-{timestamp}/ — Archived debug work

Files to archive:

• SYMPTOM.md
• HYPOTHESES.md (if exists)
• ROOT_CAUSE.md (if exists)
• FIX_PLAN.md (if exists)
• FIX_SUMMARY.md (if exists)

Archive When Done

Only archive when debug work is complete (bug is fixed) or abandoned.

Preserve History

Keep all files for future reference and learning.

Clean Current

After archiving, current/ folder should be empty for next debug session.

1. Check Current Debug Work

Verify ./.gtd/debug/current/ exists and has files:

if [ ! -d "./.gtd/debug/current" ] || [ -z "$(ls -A ./.gtd/debug/current)" ]; then
    echo "No debug work to archive"
    exit 0
fi

2. Create Archive Directory

Generate timestamp-based archive name:

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

3. Move Files

Move all files from current to archive:

mv ./.gtd/debug/current/* "${ARCHIVE_DIR}/"

4. Commit Archive

Commit the archive:

git add ./.gtd/archive/
git commit -m "chore: archive debug work to debug-${TIMESTAMP}"

5. Display Summary

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 GTD ► DEBUG WORK ARCHIVED ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Archived to: ./.gtd/archive/debug-{timestamp}/

Files archived: {count}

Current debug folder is now empty and ready for next investigation.

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