af-discovery-process

Gather project context via a 4-question interview and generate documentation artifacts.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/GainInsightDev/websites --skill af-discovery-process
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: af-discovery-process
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-discovery-process
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-discovery-process

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of transforming nascent product ideas into well-defined project plans, ensuring all critical aspects from business drivers to technical constraints are thoroughly understood and documented.

Core Features & Use Cases

  • Structured Context Gathering: Utilizes a 4-question framework to elicit essential project information.
  • Deliverable Generation: Creates comprehensive documentation including Project Overviews, User Analyses, Entity Models, ADRs, and Tech Stack Agreements.
  • Use Case: When tasked with building a new SaaS platform, this Skill guides you through gathering requirements, defining user personas, and documenting architectural decisions before development begins.

Quick Start

Initiate a discovery session for a new project by running 'start-specs mynewproject'.

Frequently Asked Questions about af-discovery-process

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

FAQPage Schema
How do I gather requirements for a new SaaS platform before development begins?

Product discovery requires structured requirements gathering to map ideas to actionable plans. You can use a 4-question interview framework to elicit essential project information, define user personas, and document architectural decisions before development begins.

What is the best way to document architectural decisions and tech stack agreements during project planning?

Documenting architectural decisions during project planning involves generating specific artifacts like ADRs and Tech Stack Agreements. A structured discovery process creates these comprehensive documentation outputs alongside project overviews and user analyses to ensure technical constraints are understood.

Can I integrate discovery documentation with work management tools like Linear for feature tracking?

Yes, structured product discovery supports integration with work management tools like Linear. After gathering requirements and generating project documentation, you can use this integration directly for feature creation and tracking within your development workflow.

How do I start a discovery session to map product ideas to actionable plans?

To start a discovery session for mapping product ideas to actionable plans, initiate the process by running the 'start-specs' command with your project name. This triggers the structured 4-question interview framework to begin gathering essential context.

What documentation artifacts should I expect from a structured product discovery process?

A structured product discovery process generates comprehensive documentation artifacts including project overviews, user analyses, entity models, Architecture Decision Records (ADRs), and tech stack agreements to thoroughly document business drivers and technical constraints.