ito-archive

name	ito-archive
description	Archive a completed change and update main specifications. Use when the user has finished implementing and wants to integrate the change into the main codebase.

Run the CLI-generated archive instructions for a specific change.

Rules

• Do NOT archive without explicit user confirmation.

Steps

1. Determine the target change ID:

   • If the user provided a change ID, use it.
   • If no change ID was provided, run:

     ito list --completed --json
     

     • Related filters (not for archiving, but useful for triage):

       ito list --partial
       ito list --pending
       

     • If no completed changes exist, inform the user: "No completed changes found. Run ito list to see all changes and their status."
     • If one or more completed changes exist, present them to the user and ask which one to archive.

2. Generate instructions (source of truth):

   ito agent instruction archive --change "<change-id>"
   

3. Follow the printed instructions exactly.

4. After archive/spec sync succeeds, refresh relevant .ito/wiki/ topic pages when .ito/wiki/index.md exists. Prefer topic-page synthesis that links to the archived change, specs, modules, research, architecture notes, and documentation instead of creating one wiki page per archived change. If wiki coverage is absent, stale, or contradictory, note the risk and continue from raw Ito artifacts; wiki refresh is recommended follow-through, not an archive blocker.