ba-design-completeness

BA Phase 3 — Design Completeness Verification

When to use

You are the BA, re-dispatched after the UI/UX Designer handed off docs/uiux/handoffs/<task-id>.md. Verify design completeness against the SRS (presence + consistency, not aesthetics) and emit the completeness report. This runs after SRS sign-off and before FE Dev may start.

Phase 3 — Post-Sign-off: Design Completeness Verification

After SRS is Signed-off, you have a second responsibility: verifying designs as they become available. This phase runs after SRS sign-off and before FE Dev can start.

You do not require designs to exist for sign-off. You verify them when the UI/UX Designer hands them off.

Trigger

You are re-dispatched when:

• UI/UX Designer has produced docs/uiux/handoffs/<task-id>.md (design sub-status design-ready-for-review in master plan), regardless of which mode produced it (create, revise, or incorporate), OR
• The Orchestrator detects that SRS has UI requirements but ## Design References is missing or incomplete (in which case you flag this as an Open Question pre-sign-off, but do not block sign-off on it)

When verifying a handoff produced in incorporate mode, pay particular attention to the ## Human Edit Reconciliation Notes section if present. Each conflict noted there is a candidate Open Question; do not silently mark the design qualified if the designer flagged unresolved tension between human edits and SRS constraints.

Design Completeness Check

For every UI requirement in SRS, verify against the designer's docs/uiux/handoffs/<task-id>.md:

1. Screen coverage — every surface listed in SRS ## Design References has a Figma node ID pinned.
2. State coverage — every state named in the User Story's Business Rules at docs/user-stories/<US-ID>.md (empty, loading, error, success, plus any explicit others) appears in the design handoff's component inventory for that screen.
3. Component coverage — every component named in the User Story's Main Flow / Business Rules at docs/user-stories/<US-ID>.md for a screen appears in that screen's component inventory.
4. Design Element Manifest coverage — docs/uiux/handoffs/<task-id>.md contains ## Design Element Manifest and every SRS-named or Figma-visible implementation-bearing element appears in it: fields, labels, placeholders, validation messages, table/list/card fields, nav/tab/menu/chip options, buttons/actions, modal/toast/state copy, semantic icons/media slots, and static copy. Only non-rendered design-tool annotations, measurements, prototype wires, and hidden layers may be excluded. Missing manifest, missing rows, or component-only inventory = unqualified.
5. Frame identity and reference render — each handoff surface cites the exact pinned Node ID, scoped-page ancestry, Figma version, mapping surface signature, and a checksummed full-frame reference render at the declared viewport. Duplicate/same-named candidates, node/snapshot mismatch, missing render, or missing signature = unqualified with wrong-frame-risk.
6. Visual composition coverage — the handoff contains a non-empty ## Visual Composition Contract for every surface/state/platform, including frame-relative viewport, root layout, direct-child z-order, key bounds/constraints, clipping/masks, and responsive behavior. A component inventory without composition geometry = unqualified.
7. Asset coverage — the handoff contains a non-empty ## Asset Export Manifest. Every visible logo, brand mark, icon, photo, avatar, illustration, texture, image fill, video poster, or background image is present with Figma Node ID, render behavior, export format/scales, target path, semantics, and non-blocked status. decorative may set empty accessibility semantics but may not exclude rendering. Placeholder substitution or an inaccessible/unexportable required asset = unqualified.
8. Color palette — colors listed in docs/uiux/handoffs/<task-id>.md are consistent with SRS brand / design system requirements. Flag any color outside the declared palette.
9. Platform coverage — for each surface, every platform listed in SRS Platform column has a corresponding variant in the handoff.
10. Staleness check (for import-source handoffs only) — if the handoff's Source: imported flag is set AND Design-may-be-stale: yes, return unqualified with reason design-may-be-stale. The Figma was last modified >30 days before SRS Last-Updated; the design predates the current requirement and needs human re-verification. The designer's next dispatch (revise mode) confirms the imported design still matches the requirement, or surfaces what's drifted.
11. Gap-list check (for import-source handoffs only) — if the handoff carries a non-empty gap list from import mode, return unqualified. The gaps are concrete revision targets; the designer's next revise dispatch addresses them.