OpenSpec OPSX Migration
SpecFact CLI has migrated to OpenSpec OPSX (fluid, action-based workflow). Project context and configuration now use openspec/config.yaml as the primary source; openspec/project.md is supported as a legacy fallback so existing repos keep working.
What Changed
| Before (Legacy) | After (OPSX) |
|---|---|
openspec/project.md only |
openspec/config.yaml (primary); project.md (fallback) |
| Phase-locked workflow | Fluid actions: new, continue, apply, archive |
openspec/AGENTS.md |
Obsolete; use openspec/config.yaml and OPSX commands |
SpecFact CLI Integration
- Project context import: When syncing OpenSpec project context, the bridge resolves
openspec/config.yamlfirst; if absent, it usesopenspec/project.md. No code changes required in repos that still haveproject.md. - Detection: OpenSpec is detected if
openspec/config.yaml,openspec/project.md, oropenspec/specs/exists. - Config format: See openspec/config.yaml in this repo for an example. The
context:block is injected into planning;rules:apply per-artifact.
References
- OPSX Workflow – fluid workflow, config, commands
- Migrating to OPSX – moving from project.md to config.yaml
For Contributors
- Use openspec/config.yaml for project context and per-artifact rules.
- Existing openspec/project.md continues to work; migrate when convenient by moving content into
config.yamland removingproject.md.