docs-archiver

You can automate archiving completed Workstream tasks by running the archive_tasks.py script, which moves finished tasks from docs/Workstream_* directories to docs/archive/{Workstream}/{TaskName} and creates the destination path if needed.

A Workstream task can be safely archived only when a report.md file exists in the task directory, and if a todo.md is present, all its items must be checked off with no unchecked items remaining. This ensures data is not lost.

Archiving Workstream tasks does not delete documentation files. It moves completed tasks from active Workstream directories to docs/archive/ to maintain workspace hygiene while keeping historical records fully intact.

After moving completed tasks to the archive, a post-archive maintenance pass is required to refresh and update the docs tree, ensuring the active workspace structure accurately reflects the remaining unarchived tasks.

Avoid automatic task archiving if a task lacks a final report.md file or still has unchecked items in todo.md, as the safety mechanism prevents moving incomplete documentation away from the active Workstream directory.