Agent skill

dev-swarm-project-restore

Restore a project from 99-archive, a remote git repo, or a local codebase back to the workspace root, including reconstructing missing docs, stages, and sprints. Use when the user asks to resume work on an existing project.

View SKILL.md on GitHub Repository
Stars 7
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/X-School-Academy/ai-dev-swarm/tree/main/dev-swarm/skills/dev-swarm-project-restore

SKILL.md

AI Builder - Project Restore

This skill restores an existing project to the workspace root from an archive, remote git repo, or local codebase, including re-adding {SRC} and reconstructing missing docs when needed.

When to Use This Skill

  • User asks to restore a project from 99-archive/
  • User wants to restore a project from a remote git repository or a non-archived local codebase
  • User needs ideas.md, stage folders, or sprints reconstructed to resume work

Your Roles in This Skill

See dev-swarm/docs/general-dev-stage-rule.md for role selection guidance.

Role Communication

See dev-swarm/docs/general-dev-stage-rule.md for the required role announcement format.

Instructions

Follow these steps in order:

Step 1: Archive the Current Project

Archive the current project using agent skill dev-swarm-project-archive.

Step 2: Identify the Restore Source

Confirm whether the source is:

  • 99-archive/{archive-folder}
  • Remote git repository URL
  • Local codebase path (not created by archive; with or without git history)

Record the source in your notes before proceeding.

Step 3: Restore the Project

  • If restoring from 99-archive/, follow references/restore-procedure.md.
  • If restoring from a remote git repo or local codebase, follow references/external-restore.md.

Step 4: Reverse-Engineer Missing Docs (If Needed)

If the codebase has little or no documentation, follow references/reverse-engineering.md to reconstruct:

  • ideas.md
  • stage folders 00-* through 10-*
  • sprints and backlogs in 10-sprints/
  • feature specs under features/

Expected Output

  • Archived project content restored to workspace root
  • ideas.md present at the root
  • {SRC}/ re-added as a submodule at the correct commit
  • 99-archive/ retains the archived snapshot
  • Reconstructed stages, sprints, and features when docs were missing

Key Principles

  • Keep the restore process reversible and traceable in git history
  • Prefer existing git history to restore the {SRC} submodule state
  • Ask for user approval before destructive or irreversible operations

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

X-School-Academy/ai-dev-swarm

awslabs-aws-api-mcp-server-call-aws

To run an exact AWS CLI command, execute a validated `aws ...` command for direct AWS operations when you already know the precise service and parameters; use instead of suggesting commands.

7 3
Explore
X-School-Academy/ai-dev-swarm

dart-get-runtime-errors

To read recent runtime errors from a running Dart or Flutter app, fetch runtime errors after connecting to the Dart Tooling Daemon.

7 3
Explore
X-School-Academy/ai-dev-swarm

dart-set-widget-selection-mode

To enable or disable widget selection mode in a running Flutter app, set selection mode after connecting to the Dart Tooling Daemon.

7 3
Explore
X-School-Academy/ai-dev-swarm

background-process-stop-process

To stop a managed background task, terminate a running process by ID to shut it down cleanly.

7 3
Explore
X-School-Academy/ai-dev-swarm

playwright-browser-network-requests

To inspect network activity since page load, list network requests to review API calls and resources.

7 3
Explore
X-School-Academy/ai-dev-swarm

playwright-browser-console-messages

To read console logs from the current page, retrieve console messages for debugging JavaScript output.

7 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results