# shadcn-plan-session

shadcn-plan-session runs an interactive UI planning session for an MVP using product specs, tech stack notes, and API endpoints.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 267 repo stars
- Author: przeprogramowani
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.claude/commands/shadcn-plan-session.md
- Updated: 2026-02-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/shadcn-plan-session

## What it does

The command directs the model to plan the interface structure for an MVP. It reviews project context directly from three local files: `prd.md`, `tech-stack.md`, and `api-plan.md`. This connects planned screens directly to backend capabilities.

Output arrives strictly structured under `<ui_architecture_planning_output>` tags, split into numbered questions and recommendations. The review touches navigation paths, responsive behavior, accessibility, error states, and UI auth rules. The session stays active across follow-up turns until you explicitly request a summary.

Without `@prd.md`, `@tech-stack.md`, and `@api-plan.md` present in the workspace, the model lacks the data needed to evaluate endpoints or screen flows.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/shadcn-plan-session.md` — Call it with /shadcn-plan-session. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/shadcn-plan-session.md` — Call it with /prompts:shadcn-plan-session. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/shadcn-plan-session.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/shadcn-plan-session.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.claude/commands/shadcn-plan-session.md

## When to use it
- map UI screens and navigation flows directly to API endpoints
- uncover ambiguities in interface requirements before writing code
- plan component accessibility and mobile adaptation for an MVP
- align UI error handling and state synchronization with backend routes

## Example prompts
- /shadcn-plan-session
- Run /shadcn-plan-session and focus on navigation across key views
- /shadcn-plan-session: prioritize error states and authentication flows

## Similar
- [shadcn](https://affpapa.org/en/nevibecode/skills/shadcn-ui-shadcn.md) — skill · 150100 installs
- [shadcn-svelte](https://affpapa.org/en/nevibecode/skills/shadcn-svelte.md) — skill · 7600 installs
- [shadcn-ui](https://affpapa.org/en/nevibecode/skills/nexu-io-shadcn-ui.md) — skill · 3100 installs
- [shadcn-component-review](https://affpapa.org/en/nevibecode/skills/shadcn-component-review.md) — skill · 676 installs
- [w-shadcn](https://affpapa.org/en/nevibecode/skills/w-shadcn.md) — skill · 647 installs
- [shadcn-component-discovery](https://affpapa.org/en/nevibecode/skills/shadcn-component-discovery.md) — skill · 773 installs

From the same set: [przeprogramowani/ai-rules-builder](https://affpapa.org/en/nevibecode/by/przeprogramowani/ai-rules-builder.md) — 24 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
