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
.claude/commands/shadcn-ui-plan.mdWhat 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.mdCall it with /shadcn-ui-plan. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/shadcn-ui-plan.mdCall it with /prompts:shadcn-ui-plan. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/shadcn-ui-plan.prompt.mdManually: put the files in place
.gemini/commands/shadcn-ui-plan.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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.