speckit.migrate

Generate spec.md, plan.md, and tasks.md from an existing codebase structure.

63|13|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/compnew2006/Spec-Kit-Antigravity-Skills --skill speckit-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit.migrate
Source: https://github.com/compnew2006/Spec-Kit-Antigravity-Skills/tree/main/skills/speckit.migrate
Command: npx skills add https://github.com/compnew2006/Spec-Kit-Antigravity-Skills --skill speckit-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This migration tool reverse-engineers existing codebases into the speckit artifact model by generating spec.md, plan.md, and tasks.md that document current architecture and work breakdown.

Core Features & Use Cases

  • Automatically generates spec.md describing current features, architecture, and constraints.
  • Creates a plan.md that maps components to implementation steps and milestones.
  • Produces tasks.md listing concrete work items to transition the project into speckit format and maintain traceability.

Quick Start

Provide the target project path and feature name, then run the migration to generate spec.md, plan.md, and tasks.md.

Frequently Asked Questions about speckit.migrate

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

FAQPage Schema
How do I reverse-engineer an existing codebase into a spec.md file?

Reverse-engineering a codebase into spec.md involves parsing the project structure, detecting entry points, and inferring architecture to generate feature-specific documentation. This tool outputs conservative spec.md, plan.md, and tasks.md artifacts reflecting the live codebase.

What is the best way to generate a tasks.md file from my current project structure?

Generating tasks.md from a project structure requires parsing components and inferring architecture to list concrete work items. This tool produces tasks.md to transition the project into speckit format and maintain traceability for future maintenance.

Can I use this codebase migration tool for projects of any size?

This reverse-engineering workflow applies to projects of any size. It parses the full project structure and generates feature-specific spec.md, plan.md, and tasks.md artifacts that reflect the live codebase regardless of scale.

How do I create a plan.md that maps existing components to implementation milestones?

Creating plan.md to map components to milestones requires inferring architecture and detecting entry points. This tool generates plan.md mapping components to implementation steps and milestones based on the current live codebase structure.

How to start migrating a codebase into the speckit artifact model?

To start migrating into the speckit artifact model, provide the target project path and feature name, then run the migration. The tool outputs spec.md, plan.md, and tasks.md documenting the current architecture and work breakdown.

Does the generated spec.md include invented features not present in the live codebase?

No, the generated spec.md contains conservative, non-inventive content suitable for future development. The tool reverse-engineers only the current architecture, constraints, and features that actually exist in the live codebase.