gsd-orchestrator v1.0.0
gsd-orchestrator v1.0.0
The first production release of an autonomous GitHub workflow system that converts a GitHub issue into a reviewed pull request — without human intervention.
What it does
gsd-orchestrator reads a GitHub issue, plans the code changes required, branches, edits the target files through a Claude-powered ReAct loop, validates the diff, commits, opens a pull request, posts a bot review comment, and updates the project changelog — all autonomously. If GSD_AUTO_MERGE=true, it squash-merges after documentation is complete.
How it works
State machine architecture — A 9-state workflow engine (Idle → Analyzing → Branching → Editing → Validating → Committing → PrCreating → Reviewing → Documenting → Done) makes each step auditable, resumable, and independently testable. Any state can transition to Failed without corrupting the workflow.
Stdio-based MCP integration — GitHub operations (branch creation, file reads and writes, PR management) are performed via a stdio-spawned github-mcp-server.exe process, using the Model Context Protocol as the transport layer. No HTTP polling, no webhook infrastructure required.
Polly resilience — Transient MCP failures trigger exponential backoff via Polly.Extensions 8.6.6. The orchestrator retries automatically rather than crashing on intermittent network errors.
File-based checkpointing — Workflow state is persisted to .gsd/state/{workflowId}.json after each state transition. Interrupted workflows resume from the last committed state with dotnet run -- --resume <workflow-id>.
Watch mode — --watch polls the target repository for open issues every 5 minutes, enabling fully unattended operation.
Stack
| Component | Version |
|---|---|
| Runtime | .NET 10 (Worker SDK) |
| LLM client | Anthropic.SDK 5.10.0 |
| AI abstractions | Microsoft.Extensions.AI 10.6.0 |
| Resilience | Polly.Extensions 8.6.6 |
| Hosting | Microsoft.Extensions.Hosting 10.0.7 |