os-archive-item

Archiving a portfolio item requires creating a durable summary.md, updating the item stage metadata, moving its tracker row to Archived, and appending a one-line learning to LEARNINGS.md to preserve outcomes and reasoning.

Closing out campaigns involves capturing whether the item was completed or stopped, recording the correct stop reason, and generating a structured summary that you review and edit to ensure accurate portfolio bookkeeping.

Updating TRACKER.md moves the item row from Active to Archived, while LEARNINGS.md receives a newly appended one-line learning, ensuring both files stay synchronized with the item's stage metadata during the archive process.

You cannot overwrite an existing summary.md file; the archiving process requires producing a new structured summary for your review and edits to prevent accidental data loss of previous portfolio documentation.

You need active item context, such as existing TRACKER.md artifacts, to begin document synthesis; otherwise, the system will prompt you for portfolio and item selection before generating the archived summary.

Portfolio archiving requires review because the generated outcome-driven summary is structured for future reference, ensuring you verify the completion status, stop reasons, and lessons learned before updating your portfolio records.