Trent MitchellNYC --:--:--
CodeTogether

UX Review Process

Design here doesn't start in Figma. It starts with a recorded conversation nobody has cleaned up yet. This is an agent-run pipeline that turns that raw meeting into a spec where every element traces to a quote, every number traces to captured data, and every unknown is bracketed instead of guessed. Messy meeting in. A built design out.

  • 5-step pipeline
  • 7 review personas
  • 7 real streams + 1 demo
01

The five steps

Each step runs in its own fresh session with no memory of the one before. That isolation is the load-bearing trick: material can be deliberately withheld until the stage that should see it. Process state isn't tracked in a tool; it's tracked by which numbered files exist in the folder.

  1. 01

    Objectives01-Objectives.md

    Read the transcript and pull only the high-level goals and process decisions, resisting the detail, because specifics are a later stage's job. Classify the project, pick the format, and name exactly one primary user. A deliverable without a single named primary audience is not done.

  2. 02

    Data relevance02-Data-Relevance.md

    Check every intended number against the shared platform data inventory: measured, partial, or can't-do. The inventory is shared ground truth across every stream, so impossible asks get formally declined here instead of quietly dropped later.

  3. 03

    Narrative wireframe03-Narrative-Wireframe.html

    Build the story spine first (the questions the primary user asks, in the order they ask them), then hang a first visual on it. The transcript is deliberately withheld, and for redesigns so is the old design: the first visual grows from narrative, not from the existing layout.

  4. 04

    Spec + detail layeringSpec-Wireframe.html

    The full transcript enters for the first time, plus the old design for updates. Complete feedback coverage gets layered in as tags, the review layer, data-basis lines, and open calls: the ideal pulled toward the achievable.

  5. 05

    Persona reviewPersona-Review-Audit.md

    A panel of context-free reviewer personas audits the spec in parallel. Findings get triaged through a hard gate (implement, escalate, or dismiss with reason), and nothing moves to build until the audit comes back clean.

After step five, the reviewed spec seeds the build in the design system: a fast handoff, because the build starts from documented intent instead of a blank canvas.

02

The non-negotiables

  • Name the audience first

    Every surface has exactly one primary user, and the whole artifact is judged on their behalf.

  • Token cost control wins ties

    The narrative thread is controlling AI token costs; priorities resolve toward it.

  • Trust and data basis

    Every chart states its basis, adjacent figures must reconcile, and every metric traces to the data inventory.

  • Don't fabricate

    No invented metrics, quotes, or savings figures. A number that doesn't exist becomes a red bracket pointing at a numbered open decision.

03

The persona panel

Every spec faces a panel of written reviewer characters before it can become UI. Each persona is spawned as its own parallel, context-free agent: it gets its persona file, a conventions card, and the file path. No project history, no transcript, no other reviews. It can't know our excuses, and it can't be polite.

  • UX DesignerThe first 10 seconds: does visual weight match narrative priority?
  • CEOCan I get the whole story from headlines in 60 seconds?
  • CFOCross-foots every figure; two numbers that disagree end all trust.
  • CTOCould I recite this metric's definition under pressure?
  • Dev ManagerWhat do I do on Monday: is this a lever or a scoreboard?
  • Dev LeadDoes this match how work actually happens, and is it gameable?
  • DeveloperThe panel's conscience: is this fair, and what does it expose about me?

Every finding then passes a triage gate and becomes exactly one of three things: implement (a numbered TR decision with rationale), escalate (a red bracket and a numbered open call, never an invented answer), or dismiss with reason (recorded, so even the dismissals are auditable).

Implement, escalate, or dismiss with reason. Never invent the answer.
04

The annotation system

Every claim in a wireframe wears a colored tag pill; hover it and the verbatim sentence from the meeting appears. Design decisions get their own pills, so the design is the decision log. A fixed "Show review layer"toggle makes one file serve two audiences: it opens clean for stakeholders, and one click restores tags, legend, coverage table, and rationale. Takeaway strips sit under every chart, written in the audience's own voice; weak ones get flagged with a why-weak-and-fix note. Red brackets mark data that genuinely doesn't exist yet, each pointing at a numbered item in the Open Calls box, where undecided things stay red, named, and dated until somebody resolves them.

Honest unknowns beat confident fictions.
05

A worked example, fully synthetic

Everything in this walkthrough is fictional by design: a made-up feature ("Stale Work Radar"), a made-up kickoff, made-up quotes. That means the process can be shown end-to-end with nothing to redact. The pipeline ran exactly as it does for real streams.

What goes in:a 47-minute recorded kickoff. A dev lead has watched two branches sit untouched for nine days and get caught at standup right before a release cut. He wants a ranked list: "the list is the product." Leadership wants a dollar figure next to every dying branch. Nothing is decided cleanly: "stale" has no definition, one ask is flatly impossible, and nobody settles whether individual names show. This mess is the normal starting condition.

Steps 1–4distill five objectives and one audience, declare leadership's "cost avoided" number non-capturable by policy, catch two parts of the data documentation contradicting each other, build the ideal with the transcript withheld, then layer back ninety-plus tag pills, seventeen coverage-checked source asks, and twenty-eight numbered decisions.

Step 5is where it gets uncomfortable. Five context-free reviewers land twelve consensus findings. All four technical personas independently hit the same flaw: a precise, trended headline count of "12 stale candidates" sitting on a definition of "stale" the page itself admits is undecided. And the Developer persona finds what nobody in the meeting raised: the surface shows a lead your local, never-pushed commits, and never tells you what it says about you. Triage: 14 implemented, 15 escalated, 2 dismissed with reason.

A count cannot be more resolved than its own definition.
  • 96

    Tag pills

  • 17

    Source asks traced

  • 28

    Numbered decisions

  • 10

    Open calls kept open

The demo spec wireframe. Toggle the review layer (top right) to see the annotation system.Full view
06

The streams