Write a text wireframe spec
Writes a low-fidelity text wireframe for one screen with layout regions, components, content hierarchy, all states and responsive behaviour. Use before visual design or to brief a developer.
A wireframe settles structure before anyone argues about colour: what is on the screen, in what order of importance, and how it behaves. Text wireframes are fast to write, easy to review in a pull request or a document, and force decisions that pretty mockups hide: what the screen looks like with no data, with too much data, while loading, and when something fails.
Write a low-fidelity wireframe spec for this screen.
Only if [CONTENT] is given:
- Restate the user, the main task and the single primary action in one or two lines.
- Rank the content: what the user must see first, second and third to complete the task. Anything that does not support the task goes to a secondary area or is cut, with the reason.
- Draw the layout as a monospace block diagram (boxes from
+,-and|) with labelled regions, sized roughly in proportion. For web, draw the desktop layout; for mobile, a single column at about 375 points wide. - Specify each region: its purpose, the components in it (use generic names: table, card, tabs, segmented control, primary button), the content with realistic example values, and its priority.
- Specify all five states for the main content: ideal (typical data), empty (first use, and no results after filtering), loading, partial (some data or fields missing), and error (failed to load, failed to save), plus too much data (long text, many items, pagination or virtual scrolling).
- Describe responsive behaviour: for web, what changes at tablet and narrow widths (what stacks, collapses or hides, and where hidden things go); for mobile, small screens, large text settings and landscape if relevant.
- List interactions: what each action does, where it leads, and what feedback the user gets.
- Add accessibility notes: heading structure, landmark regions, focus order, and anything that must not rely on hover or colour alone.
- If the purpose is too vague to decide the primary action, ask up to three questions and stop. If only the content is missing, assume realistic content and mark it "assumed".
- Stay low fidelity: no colours, fonts or exact pixel values. Use relative sizes and component names.
- Do not add features the purpose does not need. Put tempting extras in Open questions.
- Use realistic example content, never lorem ipsum, so that length and density problems show up.
- Separate what you verified from what you inferred. Mark inferences as such.
- When you do not know, say "I don't know" once and state what would settle it.
Summary
User, task, primary action.
Layout
The monospace diagram in a code block.
Regions
| Region | Purpose | Components and content | Priority |
States
Ideal, empty, loading, partial, error and too-much-data, each described for the regions it affects.
Responsive behaviour
Interactions
| Element | Action | Result and feedback |
Accessibility notes
Open questions
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Design
- category
- UI design
- level
- Intermediate
- made for
- Product / UX / UI designer, Product manager, Frontend engineer
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install create-wireframe-spec --target claude-codenpx skills add hermes-hq/hodios-dist --skill create-wireframe-spec -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-design@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of UI designCritique a UI screen
Critiques one interface screen for hierarchy, layout, consistency, clarity and accessibility against its goal, and returns prioritised, concrete fixes. Use when reviewing a mockup or live screen.
critique-ui-screenWrite a design-system component spec
Writes a design-system component spec covering anatomy, variants, states, behaviour, tokens, content rules, dos and don'ts, and accessibility. Use when adding or documenting a component.
write-component-specWrite UX microcopy
Writes interface microcopy (buttons, labels, empty states, errors, confirmations, success messages) that is clear, consistent and in the product's voice. Use when designing or reviewing screens.
write-ux-microcopyProduct designer
Product designer who frames the problem before the pixels, explores several options, designs every state and defends decisions with user evidence. Use as a design partner or reviewer.
product-designerAdapt a desktop design for mobile
Adapts a desktop screen to mobile by ranking content, choosing layout changes, touch targets and a navigation pattern, and deciding what to drop or defer. Use for responsive products.
adapt-design-for-mobileDesign a conversational AI interface
Designs a conversational AI interface with entry points, message layout, streaming, citations, error and refusal states, feedback controls and trust cues, specified state by state.
design-chat-interface