# visual

The visual command turns a discussion into a self-contained HTML document with diagrams, wireframes and matrices the agent implements from in plan mode.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/plan/visual.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/syahiidkamil-visual

## What it does

The command asks questions to clarify scope, approach and edge cases, then writes the result into `plan.html` — a single file that opens in a browser and is read by the agent. Inside: Mermaid diagrams for flows and data schemas, wireframes for UI, state and permission matrices, short prose where visuals fall short.

Run it with a description or without an argument — it will ask what to plan. If the codebase needs exploration first, it delegates to the built-in Explore subagent. The plan lands in `docs/plans/{number}-{slug}/plan.html` inside the project; if there is one project, it does not ask. Diagrams render via Mermaid CDN, no other dependencies.

## Install

### Claude Code (native platform)

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/visual.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/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/plan/visual.md

## When to use it
- capture an architectural decision as a visual artifact
- gather questions on unclear edges before writing code
- document a UI flow with loading and error states for plan mode
- record a migration or refactor as a diagram with notes

## Example prompts
- run `visual` and plan the auth module refactor
- \`visual` — make a plan for adding PDF export
- do `visual` for the REST to GraphQL migration

## Similar
- [plannotator-visual-explainer](https://affpapa.org/en/nevibecode/skills/plannotator-visual-explainer.md) — skill · 15100 installs
- [visual-explainer](https://affpapa.org/en/nevibecode/skills/visual-explainer.md) — skill · 885 installs
- [show-me](https://affpapa.org/en/nevibecode/skills/show-me.md) — skill · 38300 installs
- [diagram-generator](https://affpapa.org/en/nevibecode/skills/oimiragieo-diagram-generator.md) — skill · 146 installs
- [diagram-design](https://affpapa.org/en/nevibecode/skills/diagram-design.md) — skill · 30900 installs
- [explain](https://affpapa.org/en/nevibecode/skills/sammcj-explain.md) — skill · ★ 173 repo stars

## Other versions with the same name
- [visual · gmickel](https://affpapa.org/en/nevibecode/commands/visual.md) — ★ 730 repo stars

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 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
