archive-build

Archive Build

Move completed builds to the complete folder for a clean, focused build list.

Purpose

Archive builds that are:

• 100% complete
• Cancelled or on-hold
• No longer active

Archived builds stay accessible in 02-builds/complete/ but don't clutter your active list.

---

Workflow

Step 1: Initialize TodoList

Create TodoWrite with all workflow steps:

- [ ] Identify build to archive
- [ ] Load and verify build status
- [ ] Confirm archive action
- [ ] Move build to complete
- [ ] Update build-map.md
- [ ] Display success message
- [ ] Close session to save progress

Mark tasks complete as you finish each step.

Step 2: Identify Build

If user specified build (e.g., "archive 01-build-nexus-v3") → Use that

If not → List active builds and ask: "Which build?"

Step 3: Load & Verify

Load 02-builds/active/{ID}-{name}/01-planning/tasks.md and overview.md

Count checkboxes → Calculate progress

Display:

Build: {name}
Progress: X/Y tasks (Z%)
Status: {status}

[If <100%] → "Not complete. Archive anyway? (yes/no)"
[If 100%] → "Ready to archive!"

Step 4: Confirm

Ask: "Archive {name}? This moves it to 02-builds/complete/. (yes/no)"

If "no" → Exit

Step 5: Archive

1. Move build: 02-builds/active/{ID}-{name}/ → 02-builds/complete/{ID}-{name}/
2. Update build-map.md:
   • Remove from Active Builds
   • Add to Completed Builds section
   • Clear Current Focus if this was it
3. Add archive metadata to overview.md:

   archived: 2025-11-02
   

4. Mark roadmap item complete (REQ-5):

   # Roadmap completion marking (executed inline by AI)
   from pathlib import Path
   from datetime import datetime
   
   roadmap_path = Path("01-memory/roadmap.yaml")
   if roadmap_path.exists():
       import yaml
       with open(roadmap_path) as f:
           roadmap = yaml.safe_load(f)
   
       build_id = "{ID}-{name}"  # The build being archived
   
       for item in roadmap.get("items", []):
           if item.get("build_id") == build_id:
               if not item.get("completed_at"):
                   item["completed_at"] = datetime.now().strftime("%Y-%m-%d")
                   with open(roadmap_path, "w") as f:
                       yaml.dump(roadmap, f, default_flow_style=False, allow_unicode=True)
                   print(f"Marked roadmap item '{item['name']}' as complete")
               break