Destynova2/cli-code-skills / cli-forge-chef
cli-forge-chef
VerifiedGenerate a multi-agent orchestrator for any project using the Brigade de Cuisine pattern: Chef (plans, decides), Sous-Chef (validates, merges), Commis (execute). Clients order via a Menu (PERT), the kitchen delivers Plats (merged features). Creates tmuxinator config, prompts, shared-state memory, quality gates, and permissions. Uses Claude Code Agent Teams (TeamCreate + SendMessage) with visible tmux panes. Use when the user wants to parallelize work across multiple Claude Code agents, orchestrate a multi-agent sprint, or says 'boss', 'multi-agent', 'orchestrate', 'parallelize agents', 'team of claudes', 'sprint multi-agent', 'brigade', 'chef'. Also triggers on 'swarm', 'agent team', 'parallel workers', 'PERT multi-agent'.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 51.4 KB |
| references/anti-patterns-chef.md | markdown | 2.7 KB |
| references/apply-quorum.md | markdown | 9.3 KB |
| references/brigade-setup-worktrees.shexecutable | script | 4.7 KB |
| references/ccheck-prompt-template.md | markdown | 4.2 KB |
| references/chef-prompt-template.md | markdown | 37.6 KB |
| references/conflict-resolution.md | markdown | 10.1 KB |
| references/contre-chef-inter-prompt-template.md | markdown | 8.9 KB |
| references/gotchas-chef.md | markdown | 38.0 KB |
| references/maitre-dhotel.md | markdown | 14.4 KB |
| references/parallel-exploration.md | markdown | 9.1 KB |
| references/permissions-template.md | markdown | 16.7 KB |
| references/pert-computation.md | markdown | 17.5 KB |
| references/quality-gates.md | markdown | 1.9 KB |
| references/raw-tmux-fallback.md | markdown | 3.3 KB |
| references/shared-state-template.md | markdown | 8.4 KB |
| references/simplified-model.md | markdown | 9.8 KB |
| references/sprint-persistence.md | markdown | 7.0 KB |
| references/sprint-report-template.md | markdown | 8.0 KB |
| references/templates.md | markdown | 762 B |
| references/tmuxinator-template.md | markdown | 7.4 KB |
references/apply-quorum.md
View on GitHub# Reference — Apply Quorum (plan-then-apply protocol)
> Every irreversible shell command goes through a quorum vote on its plan before it executes.
> The file-diff quorum protects code. This protocol protects infrastructure and releases.
## Contents
- Why this exists
- Gated commands
- The protocol
- Quorum rule
- Plan artefact format
- Voter checklists
- Implementation sketch
- Audit trail
- Scale rule
- Interaction with the file-diff quorum
- When the apply quorum should be SKIPPED
---
## Why this exists
`permissions-template.md` already denies dangerous commands to every role except
the apply pane. But the apply pane's *own* permission is unconditional — once an
agent is in `{project}-wt-apply`, it can run `tofu apply` whenever it wants.
That's the same failure mode the file-diff quorum solves for code: a single agent
decides alone and can be wrong. The fix is the same: the 3 voting sous-chefs
must see the plan and approve 3/3 before the apply pane executes.
## Gated commands
| Command | Why gated |
|---|---|
| `tofu apply` / `terraform apply` | Mutates cloud infra — irreversible without state surgery |
| `tofu destroy` / `terraform destroy` | Deletes resources |
| `helm upgrade --install` / `helm install` | Deploys / reconfigures workloads |
| `helm uninstall` / `helm rollback` | Removes / reverts workloads |
| `kubectl apply` (when targeting prod or shared) | Mutates cluster state |
| `kubectl delete` | Removes resources |
| `kubectl rollout restart` | Service interruption |
| `ansible-playbook` on mutating plays | System-level mutation |
| `git push --force` / `--force-with-lease` on feature branches | History rewrite (maître d'hôtel only, base branches never) |
| `gh release create` | Public release — cannot be cleanly unpublished |
| `gh api -X DELETE` / `-X PATCH` on repo settings | Repo-level mutation |
Dev-loop variants are **not** gated: `tofu plan`, `helm template`, `helm diff`,
`kubectl diff`, `ansible-playbook --check`, `git push` to feature branches without
`--force`.
## The protocol
```mermaid
sequenceDiagram
participant C as Commis / Sous-Chef
participant A as Apply pane
participant S as 3 voting sous-chefs
participant H as Human (only if 3/3 DENY)
C->>A: SendMessage "apply request: module=X, command=tofu apply"
A->>A: git checkout <ref>, tofu init
A->>A: tofu plan -out=plan.bin
A->>A: tofu show -no-color plan.bin > plan.txt
A->>S: SendMessage VOTE_APPLY with plan.txt + command
par parallel votes
S->>A: scope: APPROVE / DENY+reason
S->>A: secu: APPROVE / DENY+reason
S->>A: qualite: APPROVE / DENY+reason
end
alt 3/3 APPROVE
A->>A: tofu apply plan.bin
A->>C: SendMessage "applied: <tag>, <n> resources changed"
else any DENY
A->>C: SendMessage "DENIED by <role>: <reason>. Fix and resubmit."
else timeout (>5 min)
A->>H: Escalate — quorum unavailable
end
```
## Quorum rule
Apply commands are **always sensitive zone → 3/3 unanimity**. No 2/3 fallback.
Reason: the blast radius of an apply is by construction non-local. Even a
"routine" `kubectl apply -f deployment.yaml` can cascade — a ConfigMap change
restarts pods, a CRD change breaks controllers. The cost of false-negative
(apply blocked, re-vote) is minutes. The cost of false-positive (bad apply
merged) is an incident.
## Plan artefact format
Each voter must see:
1. **The command** — full command line the apply pane will execute
2. **The target** — cluster / cloud account / namespace / workspace
3. **The ref** — git SHA and branch the plan was produced from
4. **The plan text** — `tofu show plan.bin`, `helm diff upgrade`,
`kubectl diff -f`, or equivalent. Truncate to ~500 lines with head + tail if
larger; the full plan stays in `{project}/.claude/plans/{timestamp}.txt` for
audit.
5. **The justification** — the requesting agent's one-line reason
("feat: add RDS read replica", "fix: bump helm chart to 2.4.1")
## Voter checklists
### sous-chef-scope
- Does this match a plat in the PERT?
- Does the target (cluster / account / namespace) match the plat's intended scope?
- Any resource outside the plat's declared write-set? → DENY
- Dev / staging / prod — which one, and is it expected?
### sous-chef-secu
- Any new public ingress, open port, public bucket, IAM policy widening? → DENY unless justified
- Any secret materialized in plan output (unredacted)? → DENY, request re-plan with sensitive-value masking
- Any destroy / replace of stateful resource (DB, volume, bucket)? → DENY unless backup confirmed
- Any IAM role with `*:*` or `Administrator`? → DENY
### sous-chef-qualite
- Diff size proportionate to the justification? A one-line fix should not touch 40 resources
- Naming consistent with existing resources? Drift from naming convention?
- Any "replace" (destroy + create) where an "update-in-place" was possible?
- For Helm: `.Values` change vs chart version bump — is the change mechanism the right one?
- For kubectl: is this really a `kubectl apply` moment, or should it go through Helm / Kustomize?
## Implementation sketch
In the apply pane prompt:
```
You are the APPLY PANE for {session_name}. Your sole job is to execute
infrastructure mutations after the quorum approves the plan.
WHEN YOU RECEIVE AN APPLY REQUEST:
1. cd to the correct checkout (your worktree root)
2. git fetch && git checkout <ref>
3. Run the PLAN step for the requested command:
tofu apply → tofu init && tofu plan -out=plan.bin && tofu show -no-color plan.bin
helm upgrade → helm diff upgrade <release> <chart> -f <values>
kubectl apply → kubectl diff -f <manifest>
4. Save the plan to /{project}/.claude/plans/{timestamp}-{requester}.txt
5. Send VOTE_APPLY in parallel to sous-chef-scope, sous-chef-secu, sous-chef-qualite:
VOTE_APPLY {
command: <full command>,
target: <cluster/account/namespace>,
ref: <sha>,
plan_head: <first 200 lines>,
plan_tail: <last 100 lines>,
plan_full_path: /{project}/.claude/plans/...,
justification: <requester's reason>
}
6. Wait up to 5 min for 3 votes
7. Decision:
3/3 APPROVE → execute the command, report to requester
any DENY → forward DENY + reason to requester, DO NOT execute
timeout / missing → escalate to human (SendMessage to chef with "QUORUM TIMEOUT")
8. After execution:
- log the result to /{project}/.claude/plans/{timestamp}-result.txt
- update shared-state.md "Applied changes" section
- SendMessage to the requester AND to the Chef
NEVER:
- Execute without a 3/3 APPROVE
- Skip the plan step
- Run apply on ref that is not on origin (prevents "apply from local uncommitted state")
- Hide errors — forward them verbatim
```
In the 3 voting sous-chef prompts (extension to the existing file-diff vote
handler):
```
WHEN YOU RECEIVE A VOTE_APPLY REQUEST:
Apply the checklist for your role (see apply-quorum.md §Voter checklists).
Vote strictly: unanimity required. If uncertain → DENY with reason.
Response format:
APPROVE
or
DENY — <specific reason> — SUGGESTION: <what the requester should change>
```
## Audit trail
Every apply request produces, under `{project}/.claude/plans/`:
- `{timestamp}-{requester}.txt` — the plan submitted for vote
- `{timestamp}-votes.json` — the 3 votes + reasons
- `{timestamp}-result.txt` — stdout/stderr of the executed command (or "DENIED")
- `{timestamp}-meta.json` — `{command, target, ref, approvers, result, duration}`
These are committed to the sprint-history at shutdown so the sprint report has
a complete trace of every mutation.
## Scale rule
| Signal | Protocol active? |
|---|---|
| No infra in the repo | Not applicable — skip this reference |
| Infra present but dev-only (local k3s, kind, Minikube) | Optional — default off, enable with `--apply-quorum` |
| Infra targets staging | **Yes** — 3/3 mandatory |
| Infra targets prod | **Yes, with human ACK** — 3/3 + require "PATRON: ACK apply on prod" before executing |
| Release tags (`gh release create`) | **Yes** — 3/3 mandatory |
| Force-push on feature branches | Maître d'hôtel only, no vote needed (already scoped to feature) |
## Interaction with the file-diff quorum
The two quorums run on the same 3 voters but on different inputs:
| Quorum | Input | Trigger | Latency budget |
|---|---|---|---|
| File diff | `{file, diff}` | Commis edit | 30 s |
| Apply | `{command, plan.txt}` | Apply request from any role | 5 min |
A single sprint can fire both — a commis edits `terraform/vpc.tf` (file-diff
quorum on the diff), then asks the apply pane to apply it (apply quorum on the
plan). Both must pass.
## When the apply quorum should be SKIPPED
- **Dry runs** — `tofu plan`, `helm diff`, `kubectl diff`. These never mutate,
vote not needed.
- **Local dev loops** — single-developer laptop targeting `kind` / `k3d` /
Minikube, no prod credentials in env. The apply pane prompt should check
`kubectl config current-context` against a user-declared `LOCAL_ALLOWLIST` and
skip the vote only for that allowlist.
- **Rollback under incident** — if the Chef declares `INCIDENT_ROLLBACK` in
shared-state, one voter + requester is enough (2/1 fast path). Log loudly and
review post-incident.
Everything else goes through the full 3/3.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |