gitwtfhub

wtf is fable-sonnet-orchestrator-kit?

nickalaslight/fable-sonnet-orchestrator-kit — explained in plain English

Analysis updated 2026-05-18

1PowerShellAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A Claude Code configuration kit that turns the main AI agent into an orchestrator: it creates GitHub issues, dispatches focused subagents per issue to a git worktree, and a code-enforced hook gates PR creation and review before merging.

Mindmap

mindmap
  root((orchestrator-kit))
    Workflow loop
      GitHub issues as todo list
      Git worktree per issue
      PR open and review
      Merge as approval
    Roles
      Orchestrator main agent
      Sonnet executor subagents
      Issue triage agent
    Enforcement
      Stop hook PowerShell script
      Blocks without PR
      Injects review feedback
    Memory
      Handoff.md rolling summary
      SessionStart auto-inject
    Audience
      Developers
      Vibe coders
      AI workflow builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Drop the .claude folder into a project and give Claude Code a request, it will break the work into GitHub issues, dispatch subagents to implement each one, and manage the PR review loop.

REASON 2

Use the Stop hook to enforce that every subagent session produces a pull request before it ends, preventing silent incomplete work.

REASON 3

Pin subagent model versions in the agent definition files to control cost when the main orchestrator session runs on an expensive model.

What's in the stack?

PowerShellClaude CodeGitHub CLI

How it stacks up

nickalaslight/fable-sonnet-orchestrator-kitc0urag1/break-risk-intel-skillpnwcomputers/jwrapper-screenconnect-rat-remediation-toolkit
Stars111
LanguagePowerShellPowerShellPowerShell
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Claude Code, the GitHub CLI authenticated non-interactively, and PowerShell 7+ installed, three placeholder values must be replaced before use.

No license file is included in the repository.

Wtf does this do

This repository is a set of configuration files for Claude Code, an AI coding assistant, that wires up a specific way of working on GitHub projects. The goal is to split the AI's role in two: one main agent acts as a manager that breaks down requests into GitHub issues and hands each issue off to a separate focused subagent to implement. The subagents work on isolated copies of the code, open pull requests, and the main agent reviews and merges them. The workflow goes in a fixed loop: a request comes in, the main agent turns it into one or more GitHub issues, a subagent per issue creates a separate working branch, makes the smallest correct change needed to close that issue, opens a pull request, and the main agent reviews it. A PowerShell script enforces the hand-offs at every step. If a subagent finishes its turn without opening a pull request, the script blocks it from proceeding until one exists. If the main agent has requested changes on a pull request, the script injects the review feedback into the subagent's context so it fixes the issues in that same session. The practical benefit is that this structure keeps the two agents from doing each other's jobs. The main agent handles judgment and sequencing. The subagents handle implementation. The configuration pins the subagents to a specific Claude model version so that cost does not accidentally escalate if the main session is running on a more expensive model. A rolling handoff document keeps a summary of current state so that if the main agent is interrupted or restarted, a fresh instance can pick up where the previous one left off. Installation is copying the .claude folder into your project and replacing three placeholder values with your GitHub organization, local checkout path, and secrets directory path. No credentials are stored in the repository files themselves.

Yoink these prompts

Prompt 1
I want to use the fable-sonnet-orchestrator-kit with my GitHub repo. Walk me through the three placeholder replacements I need to make in the .claude folder files and what each value should be.
Prompt 2
Explain how the executor-stop-gate.ps1 Stop hook works in this kit: what conditions does it check, when does it block the agent, and how does it inject review feedback?
Prompt 3
I am setting up this orchestrator kit. How does the SessionStart hook inject the orchestrator role, and why do the subagents need separate agent definition files while the main agent only needs a skill?

Frequently asked questions

wtf is fable-sonnet-orchestrator-kit?

A Claude Code configuration kit that turns the main AI agent into an orchestrator: it creates GitHub issues, dispatches focused subagents per issue to a git worktree, and a code-enforced hook gates PR creation and review before merging.

What language is fable-sonnet-orchestrator-kit written in?

Mainly PowerShell. The stack also includes PowerShell, Claude Code, GitHub CLI.

What license does fable-sonnet-orchestrator-kit use?

No license file is included in the repository.

How hard is fable-sonnet-orchestrator-kit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fable-sonnet-orchestrator-kit for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.