feature-discovery

Decomposes plain-language requirements into right-sized features with user-confirmed Gherkin scenarios.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/keefhub/travel-expense --skill feature-discovery-keefhub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-discovery
Source: https://github.com/keefhub/travel-expense/tree/main/.claude/skills/feature-discovery
Command: npx skills add https://github.com/keefhub/travel-expense --skill feature-discovery-keefhub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Plain-language feature requests arrive without impact analysis, proper sizing, or agreed edge cases, leading to mis-sized specs and guessed acceptance criteria. This Skill turns a layman requirement into a verified impact analysis, a decomposition into right-sized feature slices, and Gherkin feature files whose scenarios were confirmed by the user rather than inferred. ## Core Features & Use Cases - Mode A — Decompose: Runs a six-phase gated pipeline (intake, impact analysis, vertical-slice split, sizing, numbering, approval) that writes a requirements document to doc/requirements/ and stops. - Mode B — Author: Brainstorms one feature per invocation using a ten-category edge-case taxonomy (empty state, boundaries, invalid input, duplicates, lifecycle, persistence failure, navigation, offline/time, presentation, multi-actor), then writes features/NNN.{slug}.md and updates all index files. - Use Case: A stakeholder says "users should be able to split a bill with friends." Mode A analyzes the codebase impact and splits it into slices like "record who a bill is split with" and "see what each person owes"; separate Mode B runs then produce user-confirmed Gherkin feature files for each slice. ## Quick Start Ask the AI to run feature discovery on the requirement "users should be able to split a bill with friends" to produce an impact analysis and feature breakdown.

Frequently Asked Questions about feature-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a plain-language feature request into a Gherkin spec?

Run the skill in Mode A with the prose requirement to get an impact analysis and a decomposition into right-sized slices, then run Mode B once per slice to brainstorm edge cases and write a confirmed Gherkin feature file. The scenario list must be approved by the user before anything is written.

How do I split a large feature request into smaller features?

Mode A splits by user goal rather than by technical layer, then applies four sizing tests: one primary user goal, roughly seven or fewer scenarios, independent demonstrability in the running app, and at most one new storage key or module boundary. Slices failing any test are re-split or merged.

What edge cases should a feature specification cover?

The skill sweeps ten categories: empty and zero state, boundaries and precision, invalid input, duplicates, state and lifecycle conflicts, persistence failure, navigation and interruption, offline and time, presentation and scale, and multi-actor concerns. Every category is closed with scenarios or an explicit N/A reason.

When should I not use feature discovery?

Do not use it to analyze a feature file that already exists; that is the job of the downstream feature-spec stage. It also never writes application code, and Mode A never writes feature files while Mode B never handles more than one feature per run.

Can Gherkin scenarios mention storage keys or component names?

No. Scenarios must use business language only, asserting what the user sees or what survives a refresh. File paths, React components, hooks, CSS classes, and storage keys are forbidden in scenario steps because they belong to later planning stages, not acceptance criteria.