adapt

Adapt existing projects to the Superpowers + GStack workflow by adding routing and planning scaffolding.

2|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Paretofilm/superpowers-gstack --skill adapt-paretofilm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adapt
Source: https://github.com/Paretofilm/superpowers-gstack/tree/main/skills/adapt
Command: npx skills add https://github.com/Paretofilm/superpowers-gstack --skill adapt-paretofilm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adapts an existing project to the Superpowers + GStack workflow by preserving CLAUDE.md content while adding routing and planning scaffolding.

Core Features & Use Cases

  • Analyze the current CLAUDE.md and project structure to determine routing needs without disrupting existing instructions.
  • Add a structured Skill routing section to CLAUDE.md and create docs/superpowers/specs/ and docs/superpowers/plans/ with initial .gitkeep placeholders.
  • Validate prerequisites (project directory, framework presence) and guide user through safe adaptation steps.
  • Support stepwise migrations from routing decisions to plan and handoff integration while maintaining session continuity rules.

Quick Start

Run /superpowers-gstack:adapt in your project root to begin the migration.

Frequently Asked Questions about adapt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I adapt an existing CLAUDE.md project to add structured routing and planning scaffolding?

To adapt an existing project, you can use a workflow that preserves your CLAUDE.md content while injecting structured routing sections and creating dedicated specs and plans directories for migration.

Can I add GStack workflow routing to my project without losing my current CLAUDE.md instructions?

Yes, you can safely add GStack workflow routing without losing existing CLAUDE.md instructions. The adaptation process analyzes your current file and appends routing scaffolding while explicitly preserving your original content.

What prerequisites do I need to validate before migrating a project to the Superpowers workflow?

Before migrating to the Superpowers workflow, you need to validate your project directory, ensure CLAUDE Code framework presence, verify plugin availability, and check version alignment at the repository root.

What is the best way to structure specs and plans during a mid-size software project migration?

The best way to structure specs and plans during migration is to create dedicated directories like docs/superpowers/specs/ and docs/superpowers/plans/ with initial .gitkeep placeholders to maintain organized routing.

Does this routing adaptation work for mid-size software projects using CLAUDE Code?

Yes, this routing adaptation is specifically designed for mid-size software projects using CLAUDE Code that require structured routing, specs, and plan management during their workflow migration.

Why do I need structured routing and plan management when transitioning to the GStack workflow?

You need structured routing and plan management when transitioning to the GStack workflow to maintain session continuity, organize handoff integration, and safely guide stepwise migrations from initial routing decisions to final plans.