af-refinement-process

Transform product features into detailed specifications with approval gates and Git branching.

Updated Feb 8, 2026

Search Tags:#workflow #specification #requirements #qa #ux #mini-prd #behaviour

Ready to run

npx skills add https://github.com/GainInsightDev/websites --skill af-refinement-process

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: af-refinement-process
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-refinement-process
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-refinement-process

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill bridges the gap between product discovery and development by transforming high-level features into detailed, actionable specifications, ensuring clarity and alignment before implementation begins.

Core Features & Use Cases

Feature Specification: Creates comprehensive mini-PRDs, including technical details, behaviour scenarios, and visual design requirements.
Workflow Management: Guides teams through a structured refinement process with clear approval gates and Git workflow integration.
Use Case: A Product Manager has a new feature idea in Linear. They use this Skill to initiate the refinement process, involving PM, UX, and QA to define detailed acceptance criteria, user flows, and technical implementation plans, ensuring the feature is ready for development.

Quick Start

Use the af-refinement-process skill to start refining the Linear issue LIN-123.

Frequently Asked Questions about af-refinement-process

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

FAQPage Schema

How do I transform product features into detailed specifications for development?▼

Transform product features into detailed specifications by generating mini-PRDs, behaviour scenarios, and visual design requirements through a structured refinement workflow. This bridges product discovery and development by ensuring atomic feature definition and comprehensive documentation.

What is the best way to manage a refinement workflow with Linear and Git branching?▼

Manage a refinement workflow with Linear and Git by integrating structured approval gates and Git branching strategies directly into the feature definition process. This approach ensures development readiness by enforcing atomic feature definition and comprehensive documentation before implementation begins.

Can I use this workflow to create mini-PRDs and behaviour scenarios for UX and QA?▼

Yes, you can create mini-PRDs and behaviour scenarios involving PM, UX, and QA to define detailed acceptance criteria, user flows, and technical implementation plans. This structured refinement process ensures clarity and alignment across teams before implementation begins.

Does the specification process require specific approval gates before development starts?▼

Yes, the specification process requires clear approval gates within the structured refinement workflow to ensure development readiness. These gates validate that comprehensive documentation, including technical details and behaviour scenarios, meets alignment standards before implementation begins.

When do I need to initiate a structured refinement process for product features?▼

Initiate a structured refinement process when you need to bridge the gap between product discovery and development by transforming high-level features into detailed, actionable specifications. This ensures clarity and alignment across PM, UX, and QA teams before implementation begins.