Openspec Bulk Apply Change

OpenSpec Bulk Apply

Apply multiple active OpenSpec changes by creating isolated worktrees, dispatching delegated apply flows in parallel subagents, running verification in each flow, and reporting back without merging or archiving.

REQUIRED SUB-SKILL: Use openspec-git-discipline before any apply or worktree workflow.

When to Use

• More than one active OpenSpec change exists
• /opsx-bulk-apply was invoked without an explicit single-change target
• The user wants multiple changes applied in parallel
• The user asks to apply all active OpenSpec changes

Do not use bulk mode when only one candidate change remains. Stop and tell the user to use /opsx-apply <change> instead.

Steps

1. Get candidate changes

   Run:

   openspec list --json

   • If command input included change names, limit analysis to those changes.
   • If fewer than 2 active candidate changes remain, stop and tell the user to use /opsx-apply <change>.
   • Do not ask the user to choose one change when 2 or more candidates remain and the request is clearly bulk apply.

2. Run git discipline checks

   For each candidate change, verify apply is allowed before creating worktrees:

   • Run git status --short.
   • Verify openspec/changes/<change>/ has no uncommitted proposal files.
   • Verify the proposal change exists on main before applying from any branch or worktree.

   If any candidate fails the gate, exclude it from execution and report the reason. If fewer than 2 executable candidates remain, stop and report that bulk apply is not appropriate.

3. Collect change context

   For each executable candidate change:

   openspec status --change "<name>" --json
   openspec instructions apply --change "<name>" --json

   Then:

   • Read all listed contextFiles.
   • Read the tasks artifact and summarize pending work.
   • Note the implementation scope needed by the delegated apply flow.
   • Exclude blocked or all-done changes from execution and include them in the final report.

4. Create isolated worktrees

   For each executable candidate change:

   • Create a git worktree under .worktrees/<change> unless the user specified another root.
   • Keep the parent agent out of direct implementation work in the main workspace.
   • Do not create commits, branches, or merges unless the user explicitly approved them.

5. Dispatch subagents in parallel

   For each executable candidate change:

   • Dispatch one subagent in that change's worktree.
   • Run all delegated apply flows in parallel.
   • Do not apply any change directly in the parent agent.

   Subagent prompt requirements:

   • Work only in the assigned worktree.
   • Use openspec-git-discipline before applying.
   • Run /opsx-apply <change>.
   • Run /opsx-verify <change> after apply work is complete.
   • Stop after verification.
   • Do not merge, archive, or commit unless explicitly instructed by the parent prompt.
   • Return implementation outcome, verification status, changed files, blockers, and unresolved warnings.

6. Collect and normalize reports

   For each executed change, capture:

   • Worktree path
   • Apply status: complete, paused, or failed
   • Verify status: ready, warnings, critical, or failed
   • Files changed summary
   • Blockers or unresolved warnings

7. Report back without merging

   Present a final bulk-apply report:

   • Changes analyzed
   • Changes skipped and why
   • Worktrees created
   • Apply result per change
   • /opsx-verify result per change
   • Which changes are ready for human review

   End with: "No merge or archive was performed. Explicit user approval is required before any merge or archive."