Files

Tom Boucher e3262d94d3 feat(capabilities): add claude-orchestration capability (Workflow backend) (#1143 )

Default-off, BETA, claude-only capability adopting Claude Code's Workflow tool
(/effort ultracode, Agent SDK >= v0.3.149) as an optional parallel-execution
backend for the GSD loop. Restores the wave parallelism + plan-checker + verifier
that #853 forces inline on Claude Code, and folds gsd-ultraplan-phase under one
runtime gate.

- Pure fail-closed core (src/claude-orchestration.cts): detectWorkflowBackend
  (gate ladder: enabled -> Claude -> backend != inline -> nested+background host
  -> valid Agent SDK -> SDK >= floor; every miss degrades to inline) and
  emitWorkflowScript (waves -> parallel() barriers, plans -> gsd-executor +
  worktree, files_modified overlap -> separate stages, resumeFromRunId, budget).
  All interpolated identifiers validated script-safe; briefs JSON-quoted.
- claude-orchestration command family (gsd-tools claude-orchestration
  detect-backend|emit-workflow) for orchestrator invocation.
- Two gated loop contributions at wired points (execute:wave:post, plan:post);
  federated config keys (enabled/execution_backend/min_agent_sdk_version).
- ADR-1143 implementation amendment; CONTEXT.md glossary entry; explanation doc.

On any runtime lacking the Workflow tool, behaviour is byte-identical to today.

closes #1143

2026-07-06 15:18:23 -04:00

1.3 KiB

Raw Blame History

Claude orchestration — ultraplan plan-offload ownership (BETA)

Injected at plan:post into: planner only when claude_orchestration.enabled is true. Default-off; onError: skip.

Ownership declaration

The gsd-ultraplan-phase plan-offload surface (offloading GSD's plan phase to Claude Code's ultraplan cloud) is owned by this capability, not by a standalone BETA skill. Both surfaces share one runtime gate (claude_orchestration.enabled), one BETA boundary, and one Claude-Code-only detection seam.

When the planner should consider ultraplan offload

When this contribution is active (capability enabled, Claude Code runtime), the planner MAY offer the /gsd-ultraplan-phase path as an alternative to local /gsd-plan-phase for phases where cloud-assisted planning adds value. This is advisory, not mandatory — the stable local planner remains the default.

Fallback contract

If the capability is disabled, or the runtime is not Claude Code, ultraplan offload is not surfaced and the planner proceeds with the standard local /gsd-plan-phase. The gsd-ultraplan-phase command itself remains installed (its own runtime gate already no-ops on non-Claude runtimes); this contribution only governs whether the capability manifest advertises it as part of the orchestration surface.

1.3 KiB Raw Blame History

Claude orchestration — ultraplan plan-offload ownership (BETA)

Ownership declaration

When the planner should consider ultraplan offload

Fallback contract

1.3 KiB

Raw Blame History