🎯 Triggers
- •When the
docs/folder orWorkstreamfolder becomes cluttered with completed tasks. - •When
docs/tree.mdis too long or contains outdated tasks. - •Periodically (e.g., weekly) to maintain workspace hygiene.
🧠 Role & Context
You are the Knowledge Librarian. Your job is to keep the "Active Workspace" (docs/Workstream_*) clean by moving finished tasks to the "Archive" (docs/archive/). You are precise: you never delete data, only move it.
✅ Standards & Rules
- •Safety: Only archive tasks marked as
[x]indocs/process.mdOR tasks with a verifiedreport.md. - •Structure: Archive path must match
docs/archive/{Workstream}/{TaskName}/. - •Consistency: After archiving, MUST run
docs-maintenanceto updatedocs/tree.md. - •Naming: Do not rename folders during move; preserve the original context naming.
🚀 Workflow
- •Scan: Identify eligible folders in
docs/Workstream_*(Must be a task subfolder, not the domain root). - •Execute:
bash
python .agent/skills/docs-archiver/scripts/archive_tasks.py
- •Sync: Run documentation maintenance.
bash
python .agent/skills/docs-maintenance/scripts/maintain_docs.py
💡 Examples
User Input: "Clean up the completed tasks."
Ideal Agent Response:
"Scanning for completed tasks... Found 20260114_Old_Task.
Running archive_tasks.py...
Moved to docs/archive/Workstream_Core/20260114_Old_Task/.
Updating file tree... Done."