Home / Build Pattern

Master Build Pattern · v0.5.1

One unit loop, the same gates every time.

The Build Pattern is the operational layer under Bloom Protocol governance: Seed-from-idea, roles, the unit loop, hard gates, post-merge CLOSEOUT, CP-0 policy, and a copyable scaffold — expressed at ground level, without forking the governance SOP it sits on.

One unit of work

A unit is one blueprint or workstream slice, always the same shape: one git worktree outside the primary checkout, one branch from fresh origin/main, one independent audit report, one future PR after preview, and one post-merge CLOSEOUT. The primary checkout itself stays on main — feature work never parks there in a long-lived branch.

Seed, then the loop

A program starts with Admin's idea, not with code. Only after Admin locks the program does the recurring unit loop begin:

Admin idea → Seed agent drafts MASTER-PLAN + WORKSTREAMS + BP-01 + COMPOSER + AGENTS
  → STOP — awaiting Admin program lock (no CP-0, no worktree, no feature code)
  → Admin locks program (status → admin-locked / active)
  → hand off to the unit loop
CP-0 per CP0-POLICY → Orchestrator picks next unit → worktree from fresh origin/main
  → Build agent: Plan → Build → Check (acceptance) → handoff-ready
  → Audit agent (never the builder): PASS / PASS-WITH-NOTES / FAIL
  → Admin sandbox preview — not yet a PR
  → Publisher: PR after preview approval → merge
  → CLOSEOUT → next unit, again per CP0-POLICY

Handoff-ready ≠ PR-ready ≠ closeout-done. Handoff-ready means audited. PR-ready means audited and Admin sandbox-preview-approved. Closeout-done means the land is verified, the SoR is updated, dual worklogs and linked history are written, and the primary checkout is synchronized.

Line drawing of ten connected hex nodes in a row, Idea through Learn

Roles

Role Owns Must not
Admin (human)Program lock after Seed; PREP/READY go; sandbox preview; waivers; merge authority; CP-0 mode; cross-hive share gatesLeave preview to agents as substitute; skip program lock
Seed agentDraft MASTER-PLAN, WORKSTREAMS, first BP, COMPOSER, AGENTSImplement feature code; CP-0; open worktrees; grant program lock
Executive-ops beeExecutive docs; COMPOSER / INSTANCES hygiene draftsProgram lock; promote; preview; merge
Design beedesign-handoff/; UI catalog slotsFeature merge without audit/preview; expand walls alone
OrchestratorPick unit, CP-0 per policy, spawn build/audit, keep the ledger trueWrite feature code; auto-CP-0 unless eligible; expand walls
Build agentImplement the unit in a worktree; self-check; reach handoff-readyAudit itself; open a PR before preview; write outside assigned paths
Audit agentIndependent check: PASS / PASS-WITH-NOTES / FAILCommit to the build branch; grant preview approval
PublisherPR after preview; attach audit; merge; hand off to CLOSEOUTOpen a PR without preview approval; skip CLOSEOUT

Hard gates

A representative slice of the required gates — the full list runs to twelve:

Gate Rule
Admin program lockNo unit CP-0 until program status is admin-locked or active
Independent auditNever the build agent auditing itself
Human sandbox preview before PRAdmin may waive docs-only in writing
One unit / one worktree / one PRNo shared worktrees across units
Post-merge CLOSEOUTFull recipe in 04-agent-ops/CLOSEOUT.md
Dual worklogs on CLOSEOUTOverview + tech under the product's workLogsRoot
CP-0 policyDefault admin-gated; automation-eligible only when the adapter sets it and every CP0-POLICY check PASSes

CP-0 policy

CP-0 is the ledger-started + worktree-spawn gate. It has exactly two modes, and automation never expands hard walls, skips audit, or skips preview:

Mode Who starts units
admin-gated (default)Admin unlock phrase before each gated CP-0
automation-eligibleOrchestrator may auto-CP-0 when all circumstance checks PASS — in-domain, program locked, blueprint exists, COORDINATION ok, local safe defaults; preview rules still apply

Red lines

  • Do not fork BLOOM-PROTOCOL.md — cite the suite, don't copy and drift.
  • Do not CP-0 before Admin program lock.
  • Do not auto-CP-0 unless the adapter is automation-eligible and every CP0-POLICY circumstance check PASSes.
  • Do not leave Seed without a filled bee roster in AGENTS.md.
  • Do not work outside the assigned local project without a human-Admin-gated cross-hive share.
Next: Agent Team Pools → See the full roster