Skip to main content
command CX Codex

shadcn-ui-plan — Claude Code command: what it does, how to install

shadcn-ui-plan turns a product requirements doc, API plan and planning session notes into a UI architecture saved to .ai/ui-plan.md.

AGPL-3.0 ★ 267 updated 2026-02-20

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/shadcn-ui-plan.md
Open on GitHub

What shadcn-ui-plan does

The command reads through the product requirements document, the API plan and notes from a planning session, then pulls out the core requirements and the relevant API endpoints. From there it lists every screen the product needs, with its purpose, the main data shown, its components, and notes on UX, accessibility and security.

It also maps how a user moves between screens for the main use case, lays out the navigation structure, and names shared components reused across several views. Error states and edge cases get a mention too, so the plan isn't just the happy path.

Running it requires two files already in place, @prd.md and @api-plan.md, since the whole analysis is built on them. The output lands in .ai/ui-plan.md, written in Polish regardless of the project's own language.

What it helps with

  • turn a PRD and API plan into a screen-by-screen UI architecture
  • define the purpose and key components of each view
  • map navigation and the user journey across screens
  • spot shared components reused across multiple views
  • account for edge cases and error states in a UI design

Example prompts for the agent

  • Run /shadcn-ui-plan against @prd.md and @api-plan.md, plus notes from today's planning session
  • Build the UI architecture with /shadcn-ui-plan and save it to .ai/ui-plan.md
  • Run /shadcn-ui-plan and check every user story from the PRD against the resulting screens

How to install shadcn-ui-plan

Manually: put the files in place

.claude/commands/shadcn-ui-plan.md

Call it with /shadcn-ui-plan. For all projects use ~/.claude/commands/

Questions about shadcn-ui-plan

How to install shadcn-ui-plan in Claude Code?

Place the command file at .claude/commands/shadcn-ui-plan.md.

What does shadcn-ui-plan do?

It reads a product requirements doc, an API plan and planning notes, then produces a UI architecture covering screens, navigation and the user journey, saved to .ai/ui-plan.md.

What files does shadcn-ui-plan need to run?

It expects @prd.md for product requirements and @api-plan.md for the API plan, both referenced directly in the prompt.

Similar slash commands

All slash commands for Frontend and UI →

From the same set24

The whole set →
project-prd The project-prd command turns project plans into a structured PRD and saves it as a Markdown file. Use it to draft requirements, user stories, and acceptance criteria. CX Codex +1 ★ 267repo stars 10x-implement 10x-implement — a command to implement approved technical plans step-by-step in Claude Code. Reads the plan, tracks progress, and verifies each phase before moving on. CX Codex +1 ★ 267repo stars shadcn-plan-session shadcn-plan-session runs an interactive UI planning session for an MVP using product specs, tech stack notes, and API endpoints. CX Codex +1 ★ 267repo stars shadcn-view-implement The shadcn-view-implement command guides Claude Code through building a shadcn/ui view from an implementation plan. It pauses after a small batch of work so you can review the result. CX Codex +1 ★ 267repo stars mermaid-diagram-ui mermaid-diagram-ui guides the agent to analyze requirements and generate Mermaid UI architecture diagrams for Astro and React auth modules. CX Codex +1 ★ 267repo stars mermaid-diagram-auth The mermaid-diagram-auth rule guides Claude Code through project auth requirements and asks it to create a Mermaid sequence diagram. Use it to map sign-up, login, sessions, and token handling. CX Codex +1 ★ 267repo stars shadcn-view-plan shadcn-view-plan — a Claude Code command that produces a structured implementation plan for a single frontend view and writes it to .ai/{view}-view-implementation-plan.md. CX Codex +1 ★ 267repo stars mermaid-diagram-journey mermaid-diagram-journey guides Claude Code to build a Mermaid state diagram for login and onboarding flows straight from project requirements. CX Codex +1 ★ 267repo stars

Project sponsors

Companies that keep this analytics open