majiayu000 Core responsibilities:
- Verify task work exists
- Update BACKLOG.md to mark item complete
- Append completion event to JOURNAL.md
- Create archive with task name and timestamp
- Move all task files to archive
- Clean up task folder
Flow: Verify Exists → Update Backlog → Log Journal → Create Archive → Move Files → Clean Up
Source:
./.gtd/<task_name>/— Task work to archive
Destination:
./.gtd/archive/<task_name>-{timestamp}/— Archived task work
Updates:
./.gtd/BACKLOG.md— Mark item as[x]complete./.gtd/JOURNAL.md— Append completion event
Files to archive:
- SPEC.md
- ROADMAP.md (if exists)
- All phase folders with PLAN.md and SUMMARY.md
- Any other task-related files
Archive When Done
Only archive when task is complete or abandoned.
Preserve History
Keep all files for future reference and learning.
Update State
Backlog and Journal must reflect the completion.
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. Update BACKLOG.md
If ./.gtd/BACKLOG.md exists:
- Read the file
- Find the line matching the task name (e.g.,
- [ ] **{task_name}**) - Change
[ ]to[x] - Write updated file
Example:
Before: - [ ] **audio-gateway** — Opus decoding, VAD
After: - [x] **audio-gateway** — Opus decoding, VAD
4. Append to JOURNAL.md
If ./.gtd/JOURNAL.md exists:
Append a new row to the journal table:
| {date} | Task completed: {task_name} | Complete | {task_name} |
5. 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"
6. Move Task Folder
Move entire task folder to archive:
mv "./.gtd/<task_name>" "${ARCHIVE_DIR}"
7. Commit Archive
Commit the archive and state updates:
git add ./.gtd/archive/ ./.gtd/BACKLOG.md ./.gtd/JOURNAL.md
git commit -m "chore: archive task <task_name> to {task_name}-${TIMESTAMP}"
8. Display Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GTD ► TASK ARCHIVED ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Task: {task_name}
Archived to: ./.gtd/archive/{task_name}-{timestamp}/
Phases archived: {count}
Files archived: {count}
✓ BACKLOG.md updated
✓ JOURNAL.md updated
✓ Task folder removed from ./.gtd/
─────────────────────────────────────────────────────