derive-tests — Claude Code command: what it does, how to install
The derive-tests command maps documented app behavior to existing test coverage. The maintained version lives in the ai-shipping plugin.
MIT ★ 28,211 updated 2026-10-16
/plugin marketplace add phuryn/pm-skills
/plugin install pm-ai-shipping@pm-skillsWhat derive-tests does
derive-tests compares what the application is documented to do with the tests present in a repository. It can work from a specific check and a repository path or area, or inspect the whole repository when no path is supplied.
The maintained version moved to the ai-shipping plugin in phuryn/product-engineering. The copy in pm-skills points users to that version and shows how to install it. That distinction matters when both copies could be loaded, since the older command should not sit beside the maintained one.
What it helps with
- map documented behavior to existing tests
- spot repository areas with missing coverage
- review test coverage across the whole repository
- check coverage for one repository area
Example prompts for the agent
- Run
/ai-shipping:derive-teststo map test coverage for the whole repository from its documentation. - Use
/ai-shipping:derive-testsforsrc/billingand identify documented scenarios without tests. - Run
/ai-shipping:derive-testswith thecheckoutcheck against repository..
How to install derive-tests
1Plugin marketplace
/plugin marketplace add phuryn/pm-skills/plugin install pm-ai-shipping@pm-skills2Manually: put the files in place
.claude/commands/derive-tests.mdCall it with /derive-tests. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/derive-tests.mdCall it with /prompts:derive-tests. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/derive-tests.prompt.mdManually: put the files in place
.gemini/commands/derive-tests.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about derive-tests
How do I install derive-tests in Claude Code?
Add the marketplace with /plugin marketplace add phuryn/pm-skills, then install the plugin with /plugin install pm-ai-shipping@pm-skills.
What does derive-tests do?
It maps documented application behavior to the repository’s test coverage and helps surface gaps in that coverage.
Where is the maintained version of derive-tests?
It is maintained in the ai-shipping plugin in phuryn/product-engineering. The copy in pm-skills points to that move.
Source text
derive-tests.md · MIT
--- description: Moved to phuryn/product-engineering, where it is maintained in the ai-shipping plugin; this copy says where it went and how to install it. Use when asked to map test coverage from what the docs say the app does. argument-hint: "[check] <repo path or area; defaults to the whole repository>" --- # /derive-tests has moved `derive-tests` is maintained in [phuryn/product-engineering](https://github.com/phuryn/product-engineering/tree/main/ai-shipping/skills/derive-tests), in its `ai-shipping` plugin, with the rest of the AI Shipping Kit. This command, now a skill there, stays in pm-skills only so an agent that loads it knows where it went. - **`ai-shipping:derive-tests` is installed:** use it, not this copy. - **It isn't:** tell the user that `derive-tests` moved and how to install it, then help with the task as you would without it: ```bash claude plugin marketplace add phuryn/product-engineering claude plugin install ai-shipping@product-engineering ``` Other agents: [the repository's README](https://github.com/phuryn/product-engineering#install). Once it's installed, turn off `pm-ai-shipping` here, so this copy no longer loads beside it.
© Paweł Huryn · MIT · phuryn/pm-skills