archive-project_skill

Overview

This skill automates archiving completed or inactive projects by moving them into a 05-archived/ folder so your active project list stays focused. It verifies project progress, requests confirmation, updates project-map.md and overview metadata, then closes the session to persist changes. Archive operations preserve all files and support later restoration.

How this skill works

When invoked with commands like "archive project" or "archive [project-name]", the skill locates the project directory under 02-projects/, reads planning tasks and overview to compute progress, and prompts for confirmation if not fully complete. On approval it creates 05-archived/ if needed, moves the project folder, updates project-map.md (Active → Archived, clears current focus if required), appends archived metadata to overview.md, and triggers a close-session action to save state.

When to use it

• You finished all tasks for a project (100% complete).
• A project is cancelled, on-hold, or no longer active.
• You need a cleaner active project list for focus.
• You want to preserve project files but remove them from daily view.
• You plan to restore a project later if needed.

Best practices

• Confirm project identity before archiving when multiple similar names exist.
• Run progress verification to avoid accidentally archiving incomplete work.
• Ensure project-map.md is in repository root and writable so updates succeed.
• Leave a short archive note in overview.md if the project was cancelled or paused.
• Use the built-in restore command to move archived projects back to active when needed.

Example use cases

• User says "archive 01-build-nexus-v3" after marking all planning tasks complete.
• User requests "archive project" and selects a cancelled project from the active list.
• Automatically move a completed sprint project into 05-archived/ for annual cleanup.
• Audit shows an old on-hold project; archive to keep active board concise.
• Restore a previously archived project for further development using "restore [project]".