Home/Catalog/Design
Design — is it beautiful?
Brief 104

Mobile & Responsive Audit

The product on a phone — whether layouts, touch targets, and performance hold up on small screens and real devices, or quietly assume a desktop.

MOBILE.md4 phases7 lenses~2.6k chars

Free & open · no signup · read-only — it ends by asking · nothing leaves your machine

What it does

You are working inside this repo. Mission: judge the product on a phone — narrow screens, thumbs, and a slow network — and find where a desktop-first design breaks down for the users who arrive on mobile.

Read-only pass. Drive the UI at mobile widths, read the responsive styles; change nothing but the report file.

What it looks for

7 lenses it looks through

Phase 2 sweeps the codebase through every one of these, citing file and line for each finding.

1

Breakpoints & layout

reflow at small widths; horizontal scroll, clipped content, broken grids

2

Touch targets

tap sizes and spacing; controls too small or too close for a thumb

3

Input & interaction

right input types; hover-only interactions with no touch equivalent

4

Readable type & density

font sizes, line length, and spacing that work handheld

5

Viewport & safe areas

notches, safe-area insets, orientation changes, the viewport meta

6

Mobile performance

weight and jank on a mid-tier phone and a slow connection

7

Native feel

momentum, sticky headers, and gestures that feel broken versus expected

The deliverable

What lands in your repo

One structured report at the repo root — or in reports/, if you keep one — the same shape every time, ready for a teammate — or the optional Studio — to act on.

MOBILE.md
1
Flow walk
each core flow on a phone, where it breaks, and how badly
2
Findings
each: lens · breakpoint/screen · what a phone user hits · the fix
3
Blocking issues
the ones that stop the task on mobile, first
4
Polish
the touch, type, and native-feel refinements after the blockers
One file. Evidence-backed. It ends by asking before touching anything.
How it works

What it makes the agent do

Every Goal Prompt follows the same four steps, so results are consistent and repeatable — no matter which one you run.

1
Phase 1

Walk it on a phone

Open the core flows at a phone width and interact with a thumb, not a mouse.

2
Phase 2

Audit through 7 lenses

Cite the breakpoint and screen for every finding.

3
Phase 3

Curate

Rank by how completely each blocks a phone user on a core flow.

4
Phase 4

Report

Create MOBILE.md at repo root.

Get started

Three ways to run this Goal Prompt

01 · COPY

Paste it in

Copy it and paste it into your agent inside the repo you want checked.

02 · INSTALL

As a slash command

Install the goal plugin once — two commands — then just type /goal:mobile-responsive.

1/plugin marketplace add GhostlyGawd/goal-prompts
2/plugin install goal@goal-prompts

Or install only this Goal Prompt as /goal-mobile-responsive:

curl -fsSL https://goal-prompts.vercel.app/install | BRIEF=104 sh
03 · AGENT

From an agent (MCP)

Let an agent fetch it mid-conversation, or pull the raw Goal Prompt by URL.

https://goal-prompts.vercel.app/raw/104.md
Transparency

The exact prompt

Nothing hidden — this is the whole Goal Prompt, verbatim. Read it in a minute, edit it, or copy it as-is.

Read the full brief (2,573 characters)
# Goal: Mobile & Responsive Audit

You are working inside this repo. Mission: judge the product on a phone — narrow screens, thumbs, and a slow network — and find where a desktop-first design breaks down for the users who arrive on mobile.

Read-only pass. Drive the UI at mobile widths, read the responsive styles; change nothing but the report file.

## Phase 1 — Walk it on a phone
- Open the core flows at a phone width and interact with a thumb, not a mouse.
- Note where layouts break, controls are hard to hit, or the page fights the device.
- Check a mid-tier phone profile and a throttled network if you can.

## Phase 2 — Audit through 7 lenses
Cite the breakpoint and screen for every finding.
1. **Breakpoints & layout** — reflow at small widths; horizontal scroll, clipped content, broken grids
2. **Touch targets** — tap sizes and spacing; controls too small or too close for a thumb
3. **Input & interaction** — right input types; hover-only interactions with no touch equivalent
4. **Readable type & density** — font sizes, line length, and spacing that work handheld
5. **Viewport & safe areas** — notches, safe-area insets, orientation changes, the viewport meta
6. **Mobile performance** — weight and jank on a mid-tier phone and a slow connection
7. **Native feel** — momentum, sticky headers, and gestures that feel broken versus expected

## Phase 3 — Curate
- Rank by how completely each blocks a phone user on a core flow.
- For each, name the fix and the breakpoint it applies to.
- Separate "broken on mobile" from "not optimized"; fix broken first.

## Phase 4 — Report
Create `MOBILE.md` at repo root:
1. **Flow walk** — each core flow on a phone, where it breaks, and how badly
2. **Findings** — each: lens · breakpoint/screen · what a phone user hits · the fix
3. **Blocking issues** — the ones that stop the task on mobile, first
4. **Polish** — the touch, type, and native-feel refinements after the blockers

Start the report with today's date. If `MOBILE.md` already exists from a previous run, read it first and lead with what changed since.

## Rules
- Test with a thumb on a narrow screen, not a resized desktop window
- A tap target too small to hit is a broken feature, not a nitpick
- No user interface in this repo? Say so in a one-paragraph null report and stop — a null result is a valid finding.
- If a `reports/` directory exists at the repo root, write the report there instead of the root.
- Before asking, present the top findings as a ranked list in plain words
- Report only — end by asking which mobile issues to fix first

House rules for this Goal Prompt

  • Test with a thumb on a narrow screen, not a resized desktop window
  • A tap target too small to hit is a broken feature, not a nitpick
  • No user interface in this repo? Say so in a one-paragraph null report and stop — a null result is a valid finding.
  • If a reports/ directory exists at the repo root, write the report there instead of the root.
  • Before asking, present the top findings as a ranked list in plain words
  • Report only — end by asking which mobile issues to fix first
Keep exploring

More Design briefs

Runs inside these playbooks — curated sequences you can launch with one paste: