Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Mutli-Agent orchestration workflow for Claude Code with automated task management using Beads CLI
| Date | Stars |
|---|---|
| 2026-07-31 | 342 |
| 2026-08-03 | 342 |
| 2026-08-06 | 342 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
0.0
growth rate 0.00%/day
<div align="center">
# THE CLAUDE PROTOCOL
**Enforcement-first orchestration for Claude Code. Every agent tracked. Every decision logged. Nothing gets lost.**
**Claude Code plans great. Without structure, nothing survives past one session.**
[](https://www.npmjs.com/package/beads-orchestration)
[](https://github.com/AvivK5498/The-Claude-Protocol)
[](LICENSE)
<br>
```bash
npx skills add AvivK5498/The-Claude-Protocol
```
**macOS and Linux.**
<br>
<br>
[Why This Exists](#why-this-exists) · [How It Works](#how-it-works) · [Getting Started](#getting-started) · [Hooks](#hooks)
</div>
---
## Why This Exists
Claude Code is the best coding agent out there. But let it run unsupervised and you get agents editing main, commits without PRs, lost context every session, and zero traceability on what was done and why.
Plan mode helps — until you need to coordinate across files, track what was planned vs what shipped, or pick up a task three sessions later. Plans vanish. Context resets. Investigation gets redone from scratch.
The Claude Protocol is the enforcement layer. It wraps Claude Code with 13 hooks that physically block bad actions, isolates every task in its own git worktree, and documents everything automatically — dispatch prompts, agent knowledge, decisions, all of it. [Beads](https://github.com/steveyegge/beads) (git-native tickets) track every unit of work from creation to merge.
The complexity is in the system. What you see: Claude plans with you, you approve, agents execute in isolation, PRs get merged. Done.
---
## How It Works
```
┌─────────────────────────────────────────┐
│ ORCHESTRATOR (Co-Pilot) │
│ Plans with you (Plan mode) │
│ Investigates with Grep/Read/Glob │
│ Delegates implementation via Task() │
└──────────────────┬──────────────────────┘
│
┌───────────┼───────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ react- │ │ python- │ │ nextjs- │
│supervisor│ │supervisor│ │supervisor│
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
.worktrees/ .worktrees/ .worktrees/
bd-BD-001 bd-BD-002 bd-BD-003
```
**The orchestrator** investigates, discusses with you, and plans. It never writes code. Dispatch prompts are auto-logged to the bead so nothing gets lost.
**Supervisors** are created automatically based on your tech stack. They read bead comments for full context, work in isolated worktrees, and push clean PRs.
**Beads** are git-native tickets. Every task, every epic, every dependency — tracked in your repo, not a third-party service. One bead = one unit of work = one worktree = one PR.
### Workflow
**Standalone** — Investigate → plan → approve → create bead → dispatch supervisor → worktree → PR → merge.
**Epics** — Cross-domain work (DB + API + frontend) becomes an epic with enforced child dependencies. Each child gets its own worktree. Dependencies prevent dispatching out of order.
**Quick Fix** — For trivial changes (<10 lines), the orchestrator can edit directly on a feature branch. The hook prompts the user for approval with file name and change size. Hard blocked on main — must use bead workflow there.
Every task goes through beads — unless the user explicitly approves a quick fix.
### Kanban UI
The Claude Protocol pairs with the [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) for visual task management and GitOps directly from the browser. Track epics, subtasks, dependencies, and PR status across columns — without leaving the board.
---
## Getting Started
```baExcerpt of 7,790 characters
Read on GitHubWould you bet a product on this? Bounded 0–100 and slow moving.
matched fp:1530a4a529406072, llm:Repository description: 'Mutli-Agent orchestration workflow for Claude Code with automated task management using Beads CLI' (Python).
matched fp:1530a4a529406072, llm:Repository description: 'Mutli-Agent orchestration workflow for Claude Code with automated task management using Beads CLI' (Python).
matched fp:1530a4a529406072, llm:Repository description: 'Mutli-Agent orchestration workflow for Claude Code with automated task management using Beads CLI' (Python).