Repository navigation
Factory 0.4.0
Factory 0.4.0 adds fresh design review: reviewers who haven't seen the Planner's reasoning check each READY plan before any Builder starts. It's adapted from Google's Elephant & Goldfish Model (Apache-2.0). Questions a plan says only you can answer now reach you before work starts.
Design review
- Fresh reviewers, one per lens. When a Planner marks a plan READY, the factory starts a reviewer thread for each lens. Each one reads only the plan and the code it names, read-only.
- Core lenses: Zoom Out (simplicity, YAGNI, reuse of existing code), Comprehension (a naive reader, which starts with a paraphrase) and Codebase Details (what the plan says about the code, checked against the code).
- Full depth adds Design Critic (failure modes, scale, trade-offs) and Implementation Readiness (files, steps and tests). It runs when the plan names sensitive paths, the same ones that bring in Reviewer 2 on a PR, or when the Lead or you set
bb factory design-depth APP-12 full. - Findings and evidence. Each finding is a Blocker, Major or Nit, recorded with
bb factory design-findings. Every report ends with what it checked and what it didn't, so a clean review shows what it looked at. - The Planner resolves each Blocker and Major with
bb factory design-resolve:- fix: a new READY plan follows and starts the next round.
- contest: with evidence the reviewer could have read. A Comprehension finding can't be contested.
- escalate: for you to decide.
- decline: for Nits only.
- The gate. A Builder can't start until no Blocker or Major is unsettled. The same plan can't be marked ready again to shake off its findings, and a round's findings can't change once it has ended.
- What reaches you: only escalations, through the Lead (
bb factory design-decide) or as Keep the plan and Fix it buttons on the task on the Factory page. After 5 rounds, the Lead brings the plan to you, andbb factory design-accepttakes it as it is. - Clean-up. Once a reviewer finishes, the factory archives its thread and deletes the worktree and branch bb made for it.
Questions for you
A READY plan can list questions only you can answer, as - For the person: Q1. <question> Assumed: <what the plan builds on> under "## Open questions". The Lead gets them as soon as the plan is READY, while design review runs. No Builder starts until you've answered each one, through the Lead (bb factory plan-answer APP-12 keep|change --question Q1) or on the task. A different answer sends the plan back to the Planner.
READY plans also need a "## Success checks" heading.
When you upgrade
- New factories get design review. Existing ones keep working as before until you turn it on from outside an agent thread:
bb factory design-review APP on. It applies to plans marked ready from then on, and turning it off lets plans it was holding go ahead. - The Agents settings gain a Design reviewer seat, on Codex by default, a provider other than the Planner's. If it isn't available, reviewers run on the Planner's provider and the task says so.
- The host worker can now delete design reviewers' branches as well as Explorers'.
- Leads already running see design review through their standing rules and the skill, not their first brief.
Limits
- "Read only the plan" is a rule. The reviewers run where they could read the task's other comments.
- A contest's evidence isn't checked by the factory, only that a note is there.
- A fix that undoes an earlier one reaches you only if the Planner escalates it.
- Your answers are recorded by the Lead on your word, or by you on the page. bb can't tell a tap from an agent's call.
- A question written only in prose, without the "For the person:" line, isn't caught.
- Cost: each round starts 3 reviewer threads, or 5 at full depth.
- Tried on real tasks: on the sandbox, a five-lens review that passed in round 1, and a plan whose three Blockers were fixed and passed in round 2, both merged from the card. Not yet: an escalation from a finding, the Keep and Fix buttons, a question in the "For the person:" format, accepting after 5 rounds, and a reviewer that finishes without recording findings.
Full Changelog: v0.3.0...v0.4.0