Project Setup
Initialize a missing DevFlow control plane without inventing planning artifacts.
Route established-project upgrades to dev-flow-refresh.
Capability Routing
Write the minimal workflow.mode: full-openspec configuration. Resolve
triggered capabilities from scripts/workflow_methodology.py and preview
project-local skill activation before apply.
Procedure
- Run dependency and project-mode diagnosis.
- Run
scripts/audit_context_tools.py --repo <repo> --jsonand keep actions read-only unless separately approved. - Run
scripts/scaffold_workflow.py --repo <repo> --dry-run --json. - Review writes, ownership, conflicts, and tracking status. Apply only after the plan is safe.
- Preview
scripts/activate_project_dependencies.py --repo <repo> --refresh-project-skills --dry-run --json; explicit apply generates the six OpenSpec 1.7 skills in isolation and copies them to.agents/skillswithout enabling global OPSX prompts. - Run
scripts/validate_workflow_state.py --repo <repo> --json.
DevFlow writes state, checkpoints, verification, context health, and brownfield
maps only under .planning/devflow/. Existing AGENTS.md is preserved;
AGENTS.md.generated is merge-only.
Legacy state or retired workflow files route through read-only inspection. Do not clean or activate dependencies during scaffold. Setup is complete when the minimal configuration is valid, all planned writes have one owner, and the next action is explicit.