35dc87ef53
- Rebrand commits already in history (gsd → forge) - Sync pre-existing doc, docker, and CI config updates - All rebrand artifacts verified in place: * Native crates: forge-engine, forge-ast, forge-grep * Log prefixes: [forge] across 22+ files * Binary: ~/bin/sf-run * Workspace scopes: @sf-run/*, @singularity-forge/* * Nix flake: Rust toolchain ready System ready for: nix develop && bun run build:native Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
47 lines
1.2 KiB
Text
47 lines
1.2 KiB
Text
---
|
|
title: "Migration from v1"
|
|
description: "Migrate .planning directories from the original SF to SF's .gsd format."
|
|
---
|
|
|
|
If you have projects with `.planning` directories from the original Singularity Forge (v1), you can migrate them to SF's `.gsd` format.
|
|
|
|
## Running the migration
|
|
|
|
```bash
|
|
# From within the project directory
|
|
/gsd migrate
|
|
|
|
# Or specify a path
|
|
/gsd migrate ~/projects/my-old-project
|
|
```
|
|
|
|
## What gets migrated
|
|
|
|
The migration tool:
|
|
|
|
- Parses `PROJECT.md`, `ROADMAP.md`, `REQUIREMENTS.md`, phase directories, plans, summaries, and research
|
|
- Maps phases → slices, plans → tasks, milestones → milestones
|
|
- Preserves completion state (`[x]` phases stay done, summaries carry over)
|
|
- Consolidates research files
|
|
- Shows a preview before writing anything
|
|
- Optionally runs an agent-driven review of the output
|
|
|
|
## Supported formats
|
|
|
|
The migration handles various v1 format variations:
|
|
|
|
- Milestone-sectioned roadmaps with `<details>` blocks
|
|
- Bold phase entries
|
|
- Bullet-format requirements
|
|
- Decimal phase numbering
|
|
- Duplicate phase numbers across milestones
|
|
|
|
## Post-migration
|
|
|
|
Verify the output:
|
|
|
|
```
|
|
/gsd doctor
|
|
```
|
|
|
|
This checks `.gsd/` integrity and flags any structural issues.
|