Wireframe collaboration
Skill jpoindexter/wireframe-skills/skills/wireframe-collaboration
The complete wireframing discipline as agent skills — /wireframe dispatcher + 7 reference skills distilled from Wireframing for Everyone (A Book Apart)
npx -y skills add jpoindexter/wireframe-skills --skill wireframe-collaborationAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when running a team wireframing session or design-studio workshop, breaking design-by-committee gridlock, involving engineers and PMs in design (or reining in a hijack), unblocking a solo-designer bottleneck, deciding who owns which wireframing decision, structuring PM→designer→engineer handoffs, resolving cross-role design disagreements, or adapting collaborative wireframing for remote and async teams.
SKILL.md
13.7 KB, as published. Nobody here has run it
Wireframing as a Team
Overview
Wireframes have no customer value — nobody ships a wireframe. Their value is the collaboration they force: a shared, low-skill-barrier surface where PMs, engineers, and designers design together instead of throwing artifacts over silo walls. Teams fail at handoffs, not at sprints; treat the handoff as part of every role's job.
When to Use
- Kicking off a feature where PM, design, and engineering must align on structure before code
- Any org with a "design gap" — no dedicated designer, or a designer used as a pixel service. The term is Dan Olsen's (The Lean Product Playbook), who maps five levels of design maturity and observes that levels 1–4 all carry a design gap that product and engineering roles end up filling. That gap is precisely who this skill family is for.
- A solo designer is the bottleneck and other roles are idle waiting on mocks
- Deciding who drafts, who decides, and who consults on a design question
- Remote/distributed teams that need async design collaboration to work
- NOT for: running the critique itself once wireframes exist — that's wireframe-feedback
- NOT for: developer-facing spec/annotation packaging at the end — that's wireframe-handoff
Why Team Wireframing
What non-designers contribute:
- PMs — problem framing, user stories made visual, workflow-level wireflows, the "no" on scope
- Engineers — cheap-vs-expensive signals before design hardens, stress cases and edge-case flows, alternative solutions that are 90% of the UX at 30% of the cost, technical diagrams (a query flow is a wireframe too)
- Support, content, marketing, analysts — real user vocabulary, failure modes, and questions no one in the triad thought to ask
What it de-risks:
- Designs that never ship because engineering first sees them as a finished handoff
- Solutions to unvalidated problems (wireframes force the problem to be articulated first)
- Structural rework — workflow and layout are near-impossible to change post-code; fonts and colors aren't
- Single-point-of-failure design: one person's taste becomes the product's ceiling
Name the goal of every wireframe you share. The five purposes: articulation (visualize the problem), generation (many rough ideas, fast), iteration (cut to MVP), communication (align stakeholders / guide developers), validation (user tests and technical review before code). A wireframe shared without its purpose invites the wrong feedback.
Session Structure
Run collaborative sessions as a design studio: diverge alone, converge together. 5–7 participants; more than 8 splits into parallel sessions.
- Prep (before the session). Facilitator circulates a one-line problem statement, the target user, known constraints, and 2–3 reference screens 24h ahead. No solutions in the packet.
- Frame (5 min). Restate the problem aloud. Write it where everyone can see it — every dispute later gets tested against this sentence.
- Silent individual sketching (8 min). Everyone sketches — PM, engineers, everyone. Quantity over quality: aim for 6–8 thumbnail variations each (Crazy 8s pacing). Silence is the point: it blocks anchoring on the loudest voice.
- Round-robin share (3 min per person, timeboxed hard). Each person presents; others hold comments. Presenter states what problem each sketch attacks.
- Silent critique + dot vote (5 min). Written comments and 3 dots each on specific elements, not whole sketches — before any discussion, so votes aren't social.
- Converge (10–15 min). Discuss the top-voted elements only. One person (usually the designer) is named to consolidate into a single wireframe set after the session — the group generates; one hand synthesizes.
- Close with owners. Name who consolidates, who reviews, and the date of round two. A session without a named next round is theater.
Iterate in rounds — minimum three: round 1 after clarifying requirements with the PM, round 2 after PM feedback, round 3 after the engineer has reviewed. The engineer must see the wireframes before they're "done" — their estimates and constraints legitimately change what the PM decides to pursue.
Keep fidelity low in sessions. Basic shapes + annotations. Detail signals "finished" and kills contribution; polish is the enemy of participation.
Annotate what the UI can't say. Four cases that earn an annotation: error/edge cases, off-screen or background behavior, design rationale, and decision history. Describe secondary states in words ("same as X screen") rather than drawing every state.
Roles & Ownership
Too much ownership by one role creates silos; too little creates apathy. Default split — adjust explicitly, in writing, if your team differs:
| Decision | Drafts | Decides | Consulted |
|---|---|---|---|
| Problem statement & requirements | PM | PM | Design, Eng, Support |
| Scope / MVP cuts | PM | PM | Design, Eng |
| Screen structure, flow, layout | Designer | Designer | PM, Eng |
| Interaction & UI patterns | Designer | Designer | Eng (feasibility) |
| Feasibility, effort, build-vs-cut tradeoffs | Eng | Eng | Designer, PM |
| Technical flows (queries, sync, background jobs) | Eng | Eng | Designer |
| Annotations & rationale | Author of the wireframe | — | Everyone downstream |
| Visual polish (type, color, spacing) | Designer | Designer | Deferred — not a wireframe concern |
Handoff rules (each is a working agreement, not a vibe):
- Document the current handoff chain once: every artifact, who receives it, when. The gaps become visible immediately.
- Each role states, on record, what they need to do their job and in what form. People are never asked; assumptions fill the silence.
- A role's work is not done until the next role confirms they have what they need. Put the transition step in the process itself.
- Solo operator wearing multiple hats? Run the handoff anyway — each phase has distinct goals and deliverables even when it's one person.
- Notification granularity: active collaborators get per-change notifications; upstream/downstream roles subscribe to digests. Nobody should mute the project to survive it.
Handling Challenges
- Dominant voices / groupthink — structure beats willpower: silent sketching before any talk, hard round-robin timeboxes, written critique before spoken, votes cast before discussion.
- HiPPO (highest-paid person's opinion) — their sketch enters the pool like everyone else's; dots are cast silently and counted before they speak. If they pre-empt, the facilitator restates the problem sentence and asks which sketch best answers it.
- Feature creep mid-session — ask "what problem are we solving?" out loud, pointing at the framed statement. Saying yes to every request is how products get too complex to want.
- Skepticism of design / "know-it-all designer" residue — every design decision ships with its rationale; when contested, offer to settle it with a quick usability test instead of debate. Decisions backed by observed users end arguments that taste cannot.
- Cross-role disagreement — assume misunderstanding before malice. Ask each side what's most important about their position; usually the constraint and the ideal are compatible once separated. A slightly-worse-for-users solution that is dramatically faster/safer to build can be the right call — make that tradeoff explicitly, never silently.
- Remote adaptation — same studio structure over a real-time co-editing canvas; cameras optional, timeboxes mandatory; sketch on paper and photograph if tooling is friction.
- Async adaptation — replace steps 3–5 with a 48h window: each contributor posts sketches to a shared board by deadline, comments via numbered callouts, votes by emoji/dots by a second deadline; the consolidator synthesizes and posts round two. Digest subscriptions keep non-active roles informed without drowning them.
- Trust deficit — collaboration quality is capped by relationship quality. Ask colleagues for help (people invest in what they've helped), learn one thing about the constraint-world of each adjacent role, and fix communication on your side first: if the next person downstream is unhappy, change what you're sending.
Required Context
- Who is in the room and what each owns — product, design, development have different calls.
- Whether a design gap exists — no dedicated designer changes who drives.
- The decision the session must produce. A session without one is a meeting.
- Remote, in-person, or async, and the tool everyone can actually operate.
- The known friction — a dominant voice, a stalled debate, design-by-committee.
Evaluation Procedure
- Name the decision the session exists to reach, and who owns it.
- Confirm the tool lets everyone draw, not just the designer.
- Time-box divergence and convergence separately; don't let one eat the other.
- Check participation: did the quiet roles contribute artifacts, not just comments?
- Route each open question to the role that owns it rather than deciding by volume.
- Close with the decision, the owner, and the next artifact — in writing.
- Confirm nobody left believing a different outcome than what was recorded.
Output Format
Session goal: <the decision to reach> · Owner: <role>
Participants and their calls: <role → what they decide>
Format: <in-person | remote | async> · Tool: <one everyone can edit>
Diverged: <n concepts, by whom> → Converged on: <what, and why>
Open, routed: <question → owning role>
Recorded decision: <one sentence everyone would agree to>
Quick Reference
| Situation | Pattern |
|---|---|
| Kicking off a feature with the triad | Design studio: frame 5' → silent sketch 8' → share 3'/person → vote → converge |
| Session size | 5–7 people; >8 → split into parallel studios |
| Who sketches | Everyone — no spectators, no skill prerequisite |
| Preventing anchoring | Individual silent sketching before any sharing |
| Preventing social voting | Written critique + dots before discussion |
| Loud voice / HiPPO | Timeboxed round-robin; votes counted before seniors speak |
| Rounds of wireframes | Minimum three: post-requirements, post-PM-feedback, post-eng-review |
| Fidelity in team sessions | Low — boxes and annotations; polish kills participation |
| What to annotate | Edge cases, off-screen behavior, rationale, decision history |
| PM's wireframes | Problem and workflow visualization — never a prescribed solution |
| Designer's output | Many deliberately-incomplete options for critique, not one design for approval |
| Engineer's review | Cheap-vs-expensive flags + alternative solutions, before design hardens |
| Ownership dispute | Drafts/Decides/Consulted table, agreed in writing |
| Handoff definition | Done = next role confirms they have what they need |
| Feature creep in session | Point at the framed problem statement |
| Design decision contested | Rationale first; quick usability test as tiebreaker |
| Async/remote team | Same studio in two 48h windows: post-by-deadline, vote-by-deadline, consolidate |
| Post-handoff awareness | Per-change notifications for active roles; digests for everyone else |
Anti-Patterns
| Mistake | Fix |
|---|---|
| Pixel-perfect designs emailed to engineering as "done" | Engineers review low-fi wireframes in round 3, before anything is final |
| PM spec prescribes the solution | PM wireframes the problem and workflow; solutions emerge in the studio |
| Designer presents one polished design for approval | Multiple rough concepts presented for critique |
| One round of wireframes, then build | Three rounds minimum, engineer in the loop before round 3 |
| Group brainstorming from minute zero | Silent individual sketching first, then share |
| Discussion before voting | Silent written critique + dots first — votes precede talk |
| Silence in the session read as agreement | Round-robin: every person shares, timeboxed |
| Only "the designer" sketches | Everyone sketches; wireframes need no prerequisite skill |
| Wireframes shared with no stated purpose | Name the goal (articulate/generate/iterate/communicate/validate) with every share |
| Drawing every state and animation frame | One state drawn; the rest described in annotations ("same as X") |
| Rationale kept in the designer's head | Every contested decision ships with its why, on the wireframe |
| Nobody owns the handoff | Handoff written into each role's definition of done |
| Saying yes to every feature request in-session | Re-ask "what problem are we solving?" against the framed statement |
| Engineer feasibility feedback arrives after build starts | Feasibility flags are a named session input, round 3 at the latest |
| Blaming the downstream role for bad output | Audit what you're sending them first; most conflict is misunderstanding |
Companion Skills
| Situation | Co-fire |
|---|---|
| Running critique on the session's output | wireframe-feedback |
| Problem isn't validated before sketching | dec-discovery-validation |
| Scope fights, MVP cuts, backlog ranking | dec-prioritization-frameworks |
| Team converged suspiciously fast | blind-red-team |
| Two roles deadlocked on an approach | blind-steelman |
| Choosing which flow patterns to sketch | userflow |
Distilled from Wireframing for Everyone (Michael Angeles, Leon Barnard, Billy Carlson — A Book Apart, 2023), extended with production practice.