discover

Extracts business requirements through Socratic questioning into a structured requirements document.

1|Updated May 1, 2026
One-click install
npx skills add https://github.com/FerEscobarDev/Specture --skill discover-ferescobardev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: discover
Source: https://github.com/FerEscobarDev/Specture/tree/main/skills/discover
Command: npx skills add https://github.com/FerEscobarDev/Specture --skill discover-ferescobardev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a software project without clear requirements leads to scope creep, contradictory rules, and rework. This Skill guides a structured discovery conversation that captures the business problem completely before any technology decisions are made. ## Core Features & Use Cases - Socratic Requirements Elicitation: Asks 3-5 focused questions per round across eight ordered topics (purpose, actors, user stories, business rules, edge cases, constraints, brand identity, out-of-scope), forbidding assumptions and tech-stack discussion. - Structured Deliverable: Generates docs/01-requirements/business_requirements.md with stable IDs (RN-nnn, CL-nnn, FA-nnn), user stories tagged with exposure (UI / API-externa / Interna), and a boundary-capabilities list that feeds the API contract phase. - Brand-Only Mode: Runs a five-question brand identity interview (--marca) to add an Identidad de Marca section to existing requirements without re-opening the full questionnaire. - Use Case: A founder describes a marketplace idea; the Skill interviews them topic by topic, hunts edge cases, and produces a validated requirements document ready for the architecture phase. ## Quick Start Ask the assistant to start the discovery phase and lift the business requirements for your new project idea.

Frequently Asked Questions about discover

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

FAQPage Schema
How do I gather business requirements before starting a software project?▼

Run a structured discovery interview covering purpose, actors, user stories, business rules, edge cases, and constraints. This Skill asks 3-5 questions per round, forbids assumptions, and writes the answers into a requirements document with stable IDs.

What should a business requirements document contain?▼

It should list actors (including non-human consumers), prioritized user stories with exposure tags, explicit business rules with stable RN IDs, edge cases with CL IDs, non-functional business constraints, brand identity if there is a UI, and explicit out-of-scope items.

Can I add brand identity to existing requirements without redoing discovery?▼

Yes. Brand-only mode runs only the five brand questions and writes an Identidad de Marca section into the existing document, leaving all other sections untouched. It is triggered with the --marca flag or by the doctor migration check.

Does requirements discovery decide the tech stack or architecture?▼

No. The Skill enforces a hard gate against discussing frameworks, databases, or code during discovery. Technology decisions are deferred to the architecture phase so the business problem is captured without bias.

What happens if the project idea is too large for one discovery?▼

The Skill stops and proposes decomposing the idea into independent sub-projects. It recommends lifting requirements completely for one sub-project first and deferring the rest, avoiding an unmanageable monolithic specification.