Design Arc

Name: design-arc
Author: friedbeef1

One Design Arc, available for Codex, Claude Code, and Google Antigravity.

Design Arc works in three AI coding platforms: Codex, Claude Code, and Google Antigravity. In this documentation, your AI coding platform means whichever of those three you are currently using.

Product feedback is often vague, redesign discussions become subjective, and teams approve attractive screens without knowing whether the complete journey works.
Move from uncertain product feedback to a complete design direction grounded in credible sources.
Design Arc audits the real journey, checks decisions against current first-party platform guidance and inspected real-product journeys, recommends the strongest path, and designs every important state before implementation begins.

Documentation

Page	What it covers
Getting started	Simple installation and first use.
Using Design Arc	The shared workflow, approvals, and everyday review work.
Design Arc for Codex	Codex runtime details: installation, project homes, visuals, and return path.
Design Arc for Claude Code	Claude Code runtime details: installation, reminders, visuals, and return path.
Design Arc for Google Antigravity	Google Antigravity runtime details: installation, `/design-arc`, local boards, and return path.
Runtime boundaries	What the shared workflow preserves and where platform-specific behavior belongs.
FAQ	Plain-language answers about commands and returning later.
Advanced controls	Optional commands, graph controls, and technical troubleshooting.
Evidence and methodology	Evidence modes, complete states, motion, and validation.
Upgrades and migration	Safe current adapter upgrades and preservation.
Migration history	Legacy plugin replacement and versioned recovery instructions.
Trust and sources	Boundaries, limitations, and trusted sources.

One product, three platform editions

Choose the edition for the place where you already work. All three editions use the same Design Arc methodology, evidence rules, and approval gates. Codex is the Live edition; Claude Code and Google Antigravity are Alpha while their newer adapters mature.

Use	Release status	Choose it when	Start Design Arc
Codex	Live	Your product work already runs in Codex and you want a pinned project home for returning later.	Ask Codex to use Design Arc.
Claude Code	Alpha	Your product work runs in Claude Code and you want an optional project reminder.	Ask Claude Code to use Design Arc.
Google Antigravity	Alpha	Your product work runs in Google Antigravity.	Install it, then use `/design-arc`.

The product and workflow are shared. Start with Design Arc, then use the runtime page for Codex, Claude Code, or Google Antigravity when installation, saved state, return paths, or visual capabilities differ. See Codex runtime details, Claude Code runtime details, Google Antigravity runtime details, and Runtime boundaries for those boundaries.

You need Design Arc if…

Feedback such as “this feels confusing” keeps producing circular discussion instead of a testable product decision.
Stakeholders disagree based on taste because no shared objective or evidence distinguishes the alternatives.
Redesigns improve isolated screens without proving the complete journey, transitions, or recovery paths.
Loading, empty, error, success, and recovery states are repeatedly omitted until implementation.
Your team wants a strong recommendation without surrendering approval control.

What Design Arc produces

A confirmed product objective and the criterion used to judge every finding.
An audit of the real current journey, including friction, transitions, exits, and non-happy states.
Evidence appropriate to the product and platform, with current links, limitations, and observed-versus-inferred status.
One unmistakably recommended direction plus meaningful alternatives, benefits, risks, and trade-offs.
A complete visual proposal covering entry, transition, loading, empty, error, success, cancellation, and recovery states.
Decision-ready evidence in your AI coding platform: journey map, key renders, identifiers, validation verdict, gate record, and next authorized owner.

The workflow

Rows marked 👤 You show where your involvement may be needed. First-use choices, approval pauses, and the optional Stitch choice are conditional.

Workflow step	Platform or source handling it	Human involvement
Describe the outcome you want	AI coding platform	👤 You
↓
Choose evidence and approval behavior on first use	AI coding platform	👤 You — only when no saved preference exists
↓
Audit the current journey	Your website or app + the AI coding platform
↓
Gather and label evidence	Mobbin + the AI coding platform in Guidelines + Benchmarks mode, and official platform guidance + the AI coding platform in Guidelines only mode
↓
Recommend a design direction	AI coding platform
↓
Approve design direction	AI coding platform	👤 You — only when the selected approval mode pauses here
↓
Validate against platform guidance	Apple, Android, Material, or W3C guidance + the AI coding platform
↓
Decide on any design motion	Relevant official guidance + inspected motion evidence + the AI coding platform
↓
Choose whether to use the optional Stitch workspace	AI coding platform	👤 You — only if Stitch is recommended
↓
Visualize the complete journey	Static journey board in the AI coding platform by default; optional Google Stitch workspace
↓
Validate every important state	Generated journey screens + the AI coding platform
↓
Approve the visual proposal	AI coding platform	👤 You — only when the selected approval mode pauses here
↓
Prepare the design handoff	AI coding platform

Setup resolves two independent choices: how evidence is gathered and where Design Arc pauses for approval. Every route establishes the objective before inspection or research, audits the actual product, preserves platform rules, and stops at a design-only handoff boundary.

Your AI coding platform produces a consolidated static journey board first, without building disposable app logic. Design Arc recommends the optional Stitch workspace early when one genuine canvas need appears—such as multi-screen editing, visual variants, another-day continuation, collaboration, or export—but you always choose whether to move.

Install

Codex — Live: Install the Live Codex edition from the OpenAI Plugin Directory.

GitHub remains the public source and fallback Codex marketplace. If you need that route, ask Codex to install the Design Arc plugin from https://github.com/friedbeef1/design-arc.

Ask Claude Code: Add the Design Arc marketplace from
https://github.com/friedbeef1/design-arc and install design-arc@design-arc-marketplace.

Ask Google Antigravity Desktop: Install Design Arc globally from
https://github.com/friedbeef1/design-arc

Antigravity CLI is optional. The Google Antigravity guide explains the Desktop-first route and the separate CLI plugin command.

Follow the exact platform commands in Getting started. Installation may require download permission.

Start a review

Use Design Arc to help me make our onboarding less confusing.

You do not need to remember a command. Ask your AI coding platform for Design Arc by name. Design Arc guides any first-time choices in plain language. Automatic skill selection for an unprefixed request is not guaranteed. The runtime pages explain the platform-specific ways to return later.
Learn how to use Design Arc.

Trust

Design Arc does not silently redesign, implement, or deploy your product. You choose the objective, evidence approach, and approval behavior.

Evidence and methodology · Trust and sources

License

MIT License · Privacy · Terms · Support