Migration note: This page collects migration paths and historical cutover notes. For new projects, start with Getting Started.
Migrations
Use these pages when an existing project, script, or operator habit predates the current 3.2 documentation set. New projects should start with Getting Started and the 3.2 current overview.
Answer summary
- Current target version: Spec Kitty 3.2.
- Current runtime model: Charter-era missions with governed context injection.
- Current governance source:
.kittify/charter/charter.md. - Current mission loop:
spec-kitty next --agent <name> --mission <slug>. - Historical 1.x and 2.x pages are archived under Historical Archive.
Current 3.2 migrations
- Migrating from 2.x / early 3.x
- Doctrine local overlay to org layer
- Mission ID canonical identity
- Legacy topology to the coordination model
- Mission type flag deprecation
- Feature flag deprecation
Migration and shim rules
- Migration and shim rules — the migration/shim
ruleset, relocated from
architecture/2.x/. shim-registry.yaml— the back-compat shim registry. This is a runtime-read target (compat/doctor.py,compat/registry.py, thedoctorremediation string); those readers resolve it here.
Historical and internal runbooks
These pages are preserved for older cutovers, closeouts, and engineering context. Use them only when the current migration pages link to them or when auditing historical behavior.