Use when an existing documentation tree must be reorganised wholesale — "migrate the docs", "reorganise docs/", hundreds of files with no structure, overlapping documents that contradict each other, a docs directory nobody can navigate, or documentation whose accuracy is unknown and must be established before anyone relies on it. Also use to resume a migration already in progress. Not for creating a tree that does not exist (use scaffold-documentation) and not for a single documentation change (use update-documentation).
