dev-playbooks-cn 1.0.1 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -438,6 +438,74 @@ Decision: `Approved`, `Revise`, `Rejected`
|
|
|
438
438
|
|
|
439
439
|
---
|
|
440
440
|
|
|
441
|
+
## Migration from Other Frameworks
|
|
442
|
+
|
|
443
|
+
DevBooks provides migration scripts to help you transition from other spec-driven development tools.
|
|
444
|
+
|
|
445
|
+
### Migrate from OpenSpec
|
|
446
|
+
|
|
447
|
+
If you're currently using [OpenSpec](https://github.com/Fission-AI/OpenSpec) with an `openspec/` directory:
|
|
448
|
+
|
|
449
|
+
```bash
|
|
450
|
+
# Download and run the migration script
|
|
451
|
+
curl -sL https://raw.githubusercontent.com/ozbombor/dev-playbooks-cn/master/scripts/migrate-from-openspec.sh | bash
|
|
452
|
+
|
|
453
|
+
# Or run with options
|
|
454
|
+
./scripts/migrate-from-openspec.sh --project-root . --dry-run # Preview changes
|
|
455
|
+
./scripts/migrate-from-openspec.sh --project-root . --keep-old # Keep original directory
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
**What gets migrated:**
|
|
459
|
+
- `openspec/specs/` → `dev-playbooks/specs/`
|
|
460
|
+
- `openspec/changes/` → `dev-playbooks/changes/`
|
|
461
|
+
- `openspec/project.md` → `dev-playbooks/project.md`
|
|
462
|
+
- All path references are automatically updated
|
|
463
|
+
|
|
464
|
+
### Migrate from GitHub spec-kit
|
|
465
|
+
|
|
466
|
+
If you're using [GitHub spec-kit](https://github.com/github/spec-kit) with `specs/` and `memory/` directories:
|
|
467
|
+
|
|
468
|
+
```bash
|
|
469
|
+
# Download and run the migration script
|
|
470
|
+
curl -sL https://raw.githubusercontent.com/ozbombor/dev-playbooks-cn/master/scripts/migrate-from-speckit.sh | bash
|
|
471
|
+
|
|
472
|
+
# Or run with options
|
|
473
|
+
./scripts/migrate-from-speckit.sh --project-root . --dry-run # Preview changes
|
|
474
|
+
./scripts/migrate-from-speckit.sh --project-root . --keep-old # Keep original directories
|
|
475
|
+
```
|
|
476
|
+
|
|
477
|
+
**Mapping rules:**
|
|
478
|
+
|
|
479
|
+
| Spec-Kit | DevBooks |
|
|
480
|
+
|----------|----------|
|
|
481
|
+
| `memory/constitution.md` | `dev-playbooks/specs/_meta/constitution.md` |
|
|
482
|
+
| `specs/[feature]/spec.md` | `changes/[feature]/design.md` |
|
|
483
|
+
| `specs/[feature]/plan.md` | `changes/[feature]/proposal.md` |
|
|
484
|
+
| `specs/[feature]/tasks.md` | `changes/[feature]/tasks.md` |
|
|
485
|
+
| `specs/[feature]/quickstart.md` | `changes/[feature]/verification.md` |
|
|
486
|
+
| `specs/[feature]/contracts/` | `changes/[feature]/specs/` |
|
|
487
|
+
|
|
488
|
+
### Migration Features
|
|
489
|
+
|
|
490
|
+
Both migration scripts support:
|
|
491
|
+
|
|
492
|
+
- **Idempotent execution**: Safe to run multiple times
|
|
493
|
+
- **Checkpoints**: Resume from where you left off if interrupted
|
|
494
|
+
- **Dry-run mode**: Preview changes before applying
|
|
495
|
+
- **Automatic backup**: Original files are backed up to `.devbooks/backup/`
|
|
496
|
+
- **Reference updates**: Path references in documents are automatically updated
|
|
497
|
+
|
|
498
|
+
### Post-Migration Steps
|
|
499
|
+
|
|
500
|
+
After migration:
|
|
501
|
+
|
|
502
|
+
1. Run `dev-playbooks-cn init` to set up DevBooks Skills
|
|
503
|
+
2. Review migrated files in `dev-playbooks/`
|
|
504
|
+
3. Update `verification.md` files with proper AC mappings
|
|
505
|
+
4. Run `/devbooks:bootstrap` if you need baseline specs
|
|
506
|
+
|
|
507
|
+
---
|
|
508
|
+
|
|
441
509
|
## Repository Structure
|
|
442
510
|
|
|
443
511
|
```
|