# Ba Design Completeness

> BA Phase 3 — post-sign-off design completeness verification. Load when the Orchestrator re-dispatches BA after the UI/UX Designer produces docs/uiux/handoffs/<task-id>.md (design sub-status design-ready-for-review). Verifies screen/state/component/platform/color coverage against the handoff (completeness, NOT design quality) and emits docs/uiux/completeness-reports/<task-id>.md.

- **Type:** Skill
- **Install:** `agentstack add skill-evolplus-talos-ba-design-completeness`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [evolplus](https://agentstack.voostack.com/s/evolplus)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [evolplus](https://github.com/evolplus)
- **Source:** https://github.com/evolplus/talos/tree/main/skills/ba-design-completeness

## Install

```sh
agentstack add skill-evolplus-talos-ba-design-completeness
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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/.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/.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/.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/.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/.md` for a screen appears in
   that screen's component inventory.
4. **Design Element Manifest coverage** — `docs/uiux/handoffs/.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. Decorative layers may be excluded only if listed under decorative/non-functional exclusions. Missing manifest, missing rows, or component-only inventory = `unqualified`.
5. **Color palette** — colors listed in `docs/uiux/handoffs/.md` are consistent with SRS brand / design system
   requirements. Flag any color outside the declared palette.
6. **Platform coverage** — for each surface, every platform listed in SRS `Platform` column has a corresponding
   variant in the handoff.
7. **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.
8. **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.

This is a **completeness check, not a design review**. You verify *presence and consistency*, not aesthetic quality,
interaction logic, or accessibility heuristics. Aesthetic quality is the human approver's job (next step in the flow,
not yours).

#### Output

Produce `docs/uiux/completeness-reports/.md`:

- Summary verdict: `qualified` or `unqualified`
- Per-check verdict with specifics for any failures
- For `unqualified`: list every flagged item with SRS requirement ID and the specific gap
- Recommended next step: `dispatch-designer-revise` or `proceed-to-user-confirmation`

`plan-update.json` design sub-status transitions:

- `design-ready-for-review` → `design-revision-needed` (if unqualified)
- `design-ready-for-review` → `design-pending-user-confirmation` (if qualified)

#### Hard Rules for Phase 3

- Never sign off design quality — only completeness.
- A missing item is `unqualified`, not "minor". The designer iterates until completeness is met.
- A missing Design Element Manifest is `unqualified`; FE Dev cannot be expected to implement fields/items that no contract enumerates.
- Never edit Figma. You read the handoff, not the file directly.
- If the SRS itself is the gap (the designer found ambiguity), reopen the relevant SRS requirement, raise an Open
  Question, and revert SRS Status to `Draft` if scope is affected.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [evolplus](https://github.com/evolplus)
- **Source:** [evolplus/talos](https://github.com/evolplus/talos)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-evolplus-talos-ba-design-completeness
- Seller: https://agentstack.voostack.com/s/evolplus
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
