Claude-skill-registry 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.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/dev-swarm-project-restore" ~/.claude/skills/majiayu000-claude-skill-registry-dev-swarm-project-restore && rm -rf "$T"
manifest: skills/data/dev-swarm-project-restore/SKILL.md
source content

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
    09-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