explaingit

nickalaslight/fable-sonnet-orchestrator-kit

Analysis updated 2026-05-18

1PowerShellAudience · developerComplexity · 3/5Setup · moderate

TLDR

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 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.

USE CASE 2

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

USE CASE 3

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

What is it built with?

PowerShellClaude CodeGitHub CLI

How does it compare?

nickalaslight/fable-sonnet-orchestrator-kitblackvenom5iix/winget-toctou-pocgrafikerdem/agent-context-economy
Stars106
LanguagePowerShellPowerShellPowerShell
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperresearcherdeveloper

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

How do you get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub nickalaslight on gitmyhub

Verify against the repo before relying on details.