Project Archive

For completing a project (approve/archive), use Project_Complete first.

When to Use

When a completed project needs to be archived or an archived project needs to be restored.

Context Boundary

Read only the Phase document and sidebar configuration.

Prerequisites

• Project must have already been completed via Project_Complete (Phase: Complete_Completed).

Procedure — Archive

1. Update {Project}_Phase.md: set Phase: Complete_Started
2. Build, commit, push
3. Set status: archived on all .md files in the project
4. Move project directory to {Dept}/Archived/ using git mv
5. Update sidebar paths from projects/ to archived/ in .internal/astro.config.mjs
6. Move the sidebar group from Projects to Archived section
7. Update or create {Dept}/Archived/index.md
8. Clear Learnings file
9. Update sidebar by spawning the Page Manager bot via spawnAgent with { botGroup: 'forge', botHandle: 'page-manager' }
10. Build, commit, push
11. Present the result to the user for review
12. Iterate until the user approves
13. Update {Project}_Phase.md: set Phase: Complete_Completed
14. Build, commit, push

Procedure — Unarchive

To restore an archived project back to approved:

1. Move the directory back:

   git mv DEPT/Archived/PROJECT DEPT/Projects/PROJECT

2. Set status to approved on every .md file in the project:

   find DEPT/Projects/PROJECT -name "*.md" | xargs sed -i 's/^status: archived/status: approved/'

3. Update sidebar — reverse the changes from the archive:

   • Replace dept_lower/archived/project_lower/ with dept_lower/projects/project_lower/ in astro.config.mjs
   • Move the project group from the Archived sidebar section back to Projects
   • If the Archived section is now empty, remove it

4. Remove from DEPT/Archived/index.md — delete the project’s line. If the index is now empty (no projects left), delete the file.

5. Commit and push:

   git add -A
   git commit -m "chore: unarchive PROJECT project"
   git push origin dev

Relationship to Project_Complete

Project_Complete is the lifecycle phase that closes a project. It handles both approve and archive outcomes. Project_Archive is a utility skill for restoring an archived project. Use Project_Complete to close a project; use Project_Archive to unarchive one.

Rules

• Always use git mv — not mv — to preserve history
• Every Archived/ directory must have an index.md listing its projects