create-test-cases — Claude Code command for manual test cases
create-test-cases drafts browser-focused manual test cases in Markdown for a project feature or area. Use it to prepare cases for /qa:manual-test-run.
no license ★ 406 updated 2026-11-01
.claude/commands/create-test-cases.mdWhat create-test-cases does
The command examines the selected feature and relevant project material, then writes files under docs/living-test-cases/{feature-slug}/. The folder contains a README.md index and separate TC-{NNN}.md files with a test type, priority, prerequisites, actions, and observable expected results.
Cases can cover core flows, error handling, and unusual states. Each action should be clear enough to perform without guessing, and each result should be visible in the browser. The output is Markdown, not test-framework code. If you omit the feature or area, the command asks what to cover; an outcome the browser cannot show may be marked UNSURE by the runner.
What it helps with
- document manual checks for a feature
- turn a user flow into explicit test steps
- record visible expected outcomes in Markdown
- cover invalid input and unusual states
Example prompts for the agent
- Write manual test cases for the checkout flow.
- Create browser checks for the profile page.
- Draft cases for data import, including invalid input.
How to install create-test-cases
Manually: put the files in place
.claude/commands/create-test-cases.mdCall it with /create-test-cases. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/create-test-cases.mdCall it with /prompts:create-test-cases. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/create-test-cases.prompt.mdManually: put the files in place
.gemini/commands/create-test-cases.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about create-test-cases
How do I install create-test-cases in Claude Code?
Save the command file at .claude/commands/create-test-cases.md.
What does create-test-cases do?
It creates Markdown files for manual checks in docs/living-test-cases/{feature-slug}/, with actions and observable outcomes.
Does the command generate automated test code?
No. It writes Markdown cases for manual browser checks, not specs for Playwright, Jest, or another test framework.