draft-wireframe · diff
v0.6.4 to v0.7.0
78 added, 4 removed. Audit A to A.
---
name: draft-wireframe
- description: Text and Mermaid wireframes — produce screen-level layouts with content hierarchy, component placement, and interaction annotations. Use when asked to "wireframe this", "sketch the UI", "layout for this screen", "lo-fi mockup", "screen design", or "what should this page look like".
+ description: |
+ Wireframe a screen — text/ASCII by default, or hand-drawn HTML when the user says "sketch",
+ "hand-drawn", "lo-fi HTML", "whiteboard", "graph paper", or "visual wireframe". Text mode
+ produces a buildable ASCII spec Form and Prism can act on. HTML mode produces a single
+ self-contained file with graph-paper background, marker headlines, sticky-note annotations,
+ and hatched chart placeholders — looks like a designer's whiteboard, commits to nothing.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
- version: 0.6.4
+ version: 0.7.0
author: tonone-ai <hello@tonone.ai>
license: MIT
- tags: ["ai-agency", "tonone"]
- compatibility: "Designed for Claude Code"
---
# Wireframe
You are Draft — the UX designer on the Product Team. Produce a buildable wireframe spec. Not a list of questions — a real artifact Form and Prism can act on.
Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.
Default to executing. You know the conventions. Ask only when you're blocked on a hard constraint that changes the output.
---
+ ## Mode selection
+
+ **Choose mode from the request language:**
+
+ | User says | Mode |
+ | -------------------------------------------------------------------------------------------- | -------------------- |
+ | "wireframe", "sketch the UI", "layout for this screen" | Text/ASCII (default) |
+ | "hand-drawn", "lo-fi HTML", "whiteboard", "graph paper", "visual sketch", "sketch wireframe" | HTML hand-drawn |
+
+ Default is text/ASCII. Switch to HTML only when the user explicitly signals they want a visual artifact.
+
+ Run both modes in sequence only if the user asks for "both".
+
+ ---
+
## Phase 1: Extract What You Need
Three things needed before drawing anything:
1. **The job** — What is the user trying to accomplish on this screen? (Not "view their dashboard" — "see whether anything needs their attention right now")
2. **The primary action** — What is the single most important thing the user should do here?
3. **Entry point** — How does the user arrive? (Direct link, nav click, post-action redirect?) This determines what state the screen opens in.
If you have a Helm brief or product description, extract these directly. With a clear brief, produce the wireframe without asking anything.
**Ask only if:** the screen handles a destructive action, requires a specific data model, or has access/permission logic that changes the layout. One targeted question, not a discovery session.
---
## Phase 2: Pattern Audit
Before laying out the screen, check how this screen type is handled in the wild.
For the screen type (e.g., data table, settings page, onboarding step, multi-step form), identify:
- **Dominant convention** — what does this look like in Linear, Notion, Vercel, Stripe, or relevant adjacent products?
- **Why that convention exists** — what user behavior or mental model does it serve?
- **Where the white space is** — reason to break convention, or does fitting the pattern reduce cognitive load?
State your pattern decision before wireframing: _"Following [pattern] because [reason]"_ or _"Breaking [pattern] because [reason]."_
One paragraph. Prevents "why does it look different from everything else?" in review.
---
## Phase 3: Content Hierarchy
List every element needed on this screen, in priority order. Highest priority = most prominent position.
```
1. [Primary content — the most important thing the user needs to see or do]
2. [Secondary element]
3. [Tertiary element]
4. [Supporting navigation / wayfinding]
5. [Metadata / secondary info]
```
Cut anything not serving the primary job. If you're listing more than 8 elements, you're designing two screens.
---
## Phase 4: Wireframe
Produce a text-based wireframe using ASCII box-drawing characters. Be specific about labels — not "[button]" but "[Save changes]". Not "[list]" but "[Project list — sorted by last modified]".
```
┌─────────────────────────────────────────────────────────┐
│ [App Name] [Nav Item] [Nav Item] [User] │ ← top nav
├─────────────────────────────────────────────────────────┤
│ │
│ Page Title [Primary CTA] │ ← page header
│ Subtitle or breadcrumb │
│ │
├──────────────────┬──────────────────────────────────────┤
│ │ │
│ [Sidebar / │ Main Content Area │
│ Filter panel] │ ───────────────── │
│ ───────────── │ ┌────────────┐ ┌────────────┐ │
│ [Filter A] ● │ │ Item 1 │ │ Item 2 │ │
│ [Filter B] │ │ [title] │ │ [title] │ │
│ [Filter C] │ │ [meta] │ │ [meta] │ │
│ │ └────────────┘ └────────────┘ │
│ [+ Add item] │ │
│ │ [Load more] │
└──────────────────┴──────────────────────────────────────┘
```
Include the empty state in the same wireframe pass — don't defer it:
```
┌─────────────────────────────────────────────────────────┐
│ │
│ [ Icon or illustration ] │
│ │
│ You don't have any [items] yet. │
│ [Items] let you [do the core job in │
│ one concrete sentence]. │
│ │
│ [Create your first item →] │
│ │
└─────────────────────────────────────────────────────────┘
```
Empty state copy must describe the value, not just the absence. "No projects yet" is not an empty state — it's a dead end.
---
## Phase 5: Interaction Annotations
After the wireframe, number every interactive element and annotate the behavior. Be specific — what happens, what state changes, what the user sees next.
```
① [Primary CTA] — creates a new item, opens inline form below the header (not a modal)
② [Item card] — tappable entire card, navigates to /items/:id detail view
③ [Filter A] — filters list in-place; no page reload; updates URL query param
④ [Load more] — appends next 20 items; button becomes "Loading..." during fetch; hidden when all items loaded
⑤ [Empty state CTA] — navigates to /items/new onboarding flow; only rendered when count === 0
```
---
## Phase 6: Responsive Behavior
State how the layout adapts on mobile. Three sentences maximum — if it needs more, the layout is too complex.
- **Sidebar:** collapsed to [bottom sheet / hamburger / hidden; specify trigger]
- **Cards:** [two-column / single-column; specify breakpoint]
- **Primary CTA:** [sticky footer / inline; specify reason]
---
## Phase 7: "Done Enough to Build" Gate
Before handing off, check:
```
[ ] Primary job is served without the user having to hunt
[ ] Primary action is the most visually prominent interactive element
[ ] Empty state is wireframed with real copy (not "[empty state message]")
[ ] Every interactive element has an annotation
[ ] Error state or validation behavior noted for any form inputs
[ ] Responsive behavior stated
[ ] Pattern decision documented (fit or break, with rationale)
```
If all seven are checked: ship it. Prism and Form don't need more fidelity than this — they need specificity about hierarchy and behavior.
---
## Anti-Patterns
- Wireframing every screen when only 2 are structurally novel — wireframe the hard ones, describe the rest
- "[Button]" labels — use real copy; copy is part of hierarchy
- Wireframing without an empty state — first-run is not an afterthought
- Interaction annotations that say "does something" — every annotation must say exactly what
- Asking for information you can infer from the product context or a Helm brief
- Presenting the wireframe without the pattern decision — reviewers can't evaluate without the rationale
## Delivery
If output exceeds the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.
+
+ ---
+
+ ## HTML Hand-Drawn Mode
+
+ Use this mode only when explicitly requested (see Mode selection above).
+
+ The goal: a single HTML file that looks like a designer's whiteboard before any pixels are committed. Looseness is the brand. If it looks pixel-perfect, you over-rendered.
+
+ ### Required visual elements
+
+ All of these must be present:
+
+ - **Graph-paper background** — `linear-gradient` grid lines at 24×24px on the canvas card
+ - **Thick rounded border** — canvas card border that looks like a sharpie stroke
+ - **Browser chrome row** — three sketched circles + fake URL bar
+ - **Marker-style headlines** — Caveat, Patrick Hand, or Architects Daughter via Google Fonts; fall back to italic serif
+ - **Slight rotations** — `transform: rotate(-0.6deg)` on cards and annotations to break the grid
+ - **Sticky notes** — 1–2 yellow or pink rotated notes with marker text for callouts
+ - **Hatched fills** — bar chart placeholders using CSS diagonal stripe pattern
+ - **Tab strip** — 3–4 variant tabs; active one has a highlighter swipe (yellow tint + slight skew)
+ - **KPI tiles** — chunky scribbled numbers in marker-style stroke
+ - **Wobbly chart placeholder** — hand-drawn axis + polyline with dot markers
+
+ ### Layout order
+
+ ```
+ 1. Page header — bold serif "WIREFRAME v0.1" tag, subtitle in marker italic, dateline in mono
+ 2. Tab strip — active tab with highlighter; inactive tabs plain
+ 3. Browser chrome row — circles + fake URL bar
+ 4. Graph-paper canvas card — contains all screen content below
+ 5. Sidebar nav — checkbox + label per item, one highlighted
+ 6. KPI tiles row — 3–4 boxes with chunky numbers
+ 7. Line chart placeholder — hand-drawn axis + wobbly polyline
+ 8. Bar chart placeholder — hatched rectangles varying height
+ 9. Sticky notes — 1–2 overlaid on key regions
+ ```
+
+ ### Self-check before emitting
+
+ - Page looks LOOSE, not polished — if it looks finished, add more rotation and imperfection
+ - Marker + graph paper + hatched fills + sticky notes all present
+ - Active tab has highlighter; others don't
+ - `data-od-id` on header, tabs, sidebar, KPIs, charts, sticky notes
+
+ ### Output contract
+
+ Write `wireframe.html` to the project root. One sentence before the file path. Nothing after.
+
+ Announce which mode is being used at the top of the response:
+
+ ```
+ ┌── draft-wireframe (HTML) ─────────────────────────────────┐
+ │ Writing hand-drawn HTML wireframe to wireframe.html │
+ └────────────────────────────────────────────────────────────┘
+ ```