Skip to content

BOB-073 phase 2: mockups, data-model and architecture stages in the define pipeline - #15

Open
ccevans wants to merge 11 commits into
integrate/app-studiofrom
feature/bob-073-define-pipeline-phase-2
Open

ccevans wants to merge 11 commits into
integrate/app-studiofrom
feature/bob-073-define-pipeline-phase-2

Conversation

@ccevans

@ccevans ccevans commented Aug 23, 2026

Copy link
Copy Markdown
Owner

Epic BOB-073 phase 2 — stacked on integrate/app-studio (merge #14 first).

  • BOB-075 — mockups stage: bobby-define-mockups wired in as a define stage consuming personas/journeys as brief inputs; skippable via new omitStage helper + --no-mockups.
  • BOB-076 — data-model + forward-architecture stages (DATA-MODEL.md, ARCHITECTURE.md; ADRs via existing bobby decision add) between journeys and features; define chain now 8 steps; same omitStage skip syntax.
  • BOB-074 (dogfood with CC at the gates) is planned as a human runbook and deliberately blocked — it needs an interactive session.

Both tickets TDD-built and independently review-approved; invariant/target-matrix suites pass with zero edits; full suite 1440 passed / 0 failed, lint 0 errors, verified three times during the run.

🤖 Generated with Claude Code

ccevans and others added 11 commits August 23, 2026 13:34
… entry, omitStage + --no-mockups

The define workflow gains define-mockups between define-features and
define-blueprint. One entry each in BUILT_IN_WORKFLOWS.define, STAGE_MAP,
STAGES, TRANSITIONS (plural alias — mockup stays design-mockup), stageColor,
STAGE_ORDER (neighbours renumbered), DEFINE_STAGES, AGENT_REGISTRY
(cowork, brief derived from personas.md/journeys.md, no re-asking, skip at
the gate). Skip mechanism: exported omitStage(workflow, stage) + commander
negation --no-mockups filtering the resolved chain, so define-features hands
straight to define-blueprint with no other change.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ptions at a gate that accepts skip

New agent template + shipped copy: derives audience from the PRIMARY
persona, the page's job from the headline journey's Success line, the
screens from the Must rows — and never re-asks what the artifacts answer
(structure/references/fidelity only, budget 3-5). Craft by reference to the
design skill's 1b/2/2d/3 and slop_checklist.md; outputs under .bobby/design/
so bobby run design can resume from them; mockups.md written only on a pick.
init.js agentFiles ships it to every target — target-matrix suite green
with zero edits, per the epic AC.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… copies, name-first step references

The define SKILL gains 'Step 5: Mockups — the v1 screens, from YOUR
artifacts (optional)' between the feature map and the blueprint (renumbered
to Step 6): derived brief, the [Structure] [References] [Fidelity] budget,
.bobby/design/ outputs + mockups.md on a pick, the verbatim gate with skip,
and both skip mechanisms. The blueprint agent now references its step
name-first ('the Blueprint step (Step 6)') so BOB-076's insertion only
touches headings, and its walkthrough covers the design-direction line when
mockups.md exists. Command + CLAUDE templates gain the optional step in
their chain wording. (This repo's root CLAUDE.md regenerates on upgrade —
deliberately not hand-edited.)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…othing

buildBlueprint parses .bobby/product/mockups.md when present (chosen
direction + Locked/Status) into a model.mockups field that is null when the
file is absent; the HTML masthead renders one Design-direction line only
when the model carries it. This is what makes skip a real path: a skipped
mockups stage changes nothing downstream. Also folds the init scaffolding
test's loop gaining bobby-define-mockups (five define agents now checked).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…angelog for the mockups stage

The getFeatureTickets sort's unknown-stage fallback was the literal 16 —
backlog's OLD rank — so renumbering STAGE_ORDER for define-mockups silently
made unknown stages sort ahead of backlog (caught by the existing sort
test). Deriving the fallback from STAGE_ORDER.backlog restores the intended
tie and cannot drift on the next renumber. Plus the CHANGELOG entry for the
stage, the --no-mockups flag, and the skip-at-gate behaviour.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…he Feature view untouched

The pro app's Feature view draws one node per /api/workflows step; this
pins that describeWorkflows now serves define-mockups in position, so the
longer route needs zero pro-repo changes (length costs height only).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ing, aliases, registry entries, --no-data-model/--no-architecture via omitStage

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ed copies, journeys hands to data-model

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…skill — renumbered name-first, features cuts against the model, plan reads both when present

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ADRs via bobby decision add

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Review findings 1-4: blueprint agent said Step 6 (now 8), the define
learnings pointed the Never-row rule at Step 4 (now 6), the features
agent called itself the fourth job (now sixth), and the router/new/stages
chain strings still described the five-stage pipeline.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant