Purpose
Archive a backlog task by:
- •updating its header table fields (
status,finished_on), and - •moving the task file from
.backlog/to.backlog/.archive/.
Prerequisites
- •The task file exists in
.backlog/and matchesTXXX-*.md.
Procedure
Use todowrite with the below checklist.
- •
Identify the task
- •Ask the human for the task ID (
TXXX) or the exact filename. - •Locate the file in
.backlog/(NOT in.backlog/.archive/).
- •Ask the human for the task ID (
- •
Update task header
- •Ask the human for the final status:
- •
DONEorCANCELLED
- •
- •Update the standardized header table (immediately below the title):
- •set
statustoDONEorCANCELLED - •set
finished_ontoYYYY-MM-DD HH:mm
- •set
- •If the header table is missing, add it.
- •Ask the human for the final status:
- •
Move to archive
- •Ensure
.backlog/.archive/exists (create it if missing). - •Move the file to
.backlog/.archive/<same-filename>.
- •Ensure
- •
Verify
- •The task no longer exists in
.backlog/. - •The archived file exists in
.backlog/.archive/. - •The archived file’s header table has:
- •
statusset toDONEorCANCELLED - •
finished_onset toYYYY-MM-DD HH:mm
- •
- •The task no longer exists in
Notes
- •Archiving is intentionally simple: no registry/index updates.
- •Do not change the task ID or filename during archive (only status + location).