refine-scope

Refine Discovery artefacts by addressing ambiguity and missing acceptance criteria.

157|28|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/Fr-e-d/GAAI-framework --skill refine-scope-fr-e-d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-scope
Source: https://github.com/Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/discovery/refine-scope
Command: npx skills add https://github.com/Fr-e-d/GAAI-framework --skill refine-scope-fr-e-d

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses ambiguity, incompleteness, and uncertainty in existing Discovery artefacts (plans, epics, stories) by iteratively refining them based on feedback or detected gaps.

Core Features & Use Cases

  • Iterative Refinement: Modifies artefacts based on specific feedback items or identified missing criteria.
  • Gap Identification: Pinpoints unclear or missing acceptance criteria and scope boundaries.
  • Use Case: After an initial draft of a user story, human feedback highlights that the acceptance criteria are not testable. This Skill would be activated to revise the story's acceptance criteria to be clear, specific, and verifiable.

Quick Start

Use the refine-scope skill to improve the clarity of the current epic and its associated stories based on the provided feedback.

Frequently Asked Questions about refine-scope

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

FAQPage Schema
How do I refine user stories to address ambiguous acceptance criteria?

To refine epics and stories, you process human feedback to identify unclear or missing acceptance criteria. This gap analysis adjusts the scope and structure of your discovery artefacts, producing updated files with specific, verifiable criteria.

What is the best way to fix incomplete discovery plans and epics based on team feedback?

Fixing incomplete discovery plans requires iteratively refining them by addressing specific feedback items and detected gaps. The skill operates directly on existing artefact files to adjust scope boundaries, ensuring the updated plan is complete and unambiguous.

Can I use this to revise untestable acceptance criteria in existing story artefacts?

Yes, you can revise untestable acceptance criteria in existing story artefacts. By processing human feedback, the skill identifies missing or unclear criteria and restructures the story to ensure all acceptance criteria are clear, specific, and verifiable.

Does refining scope artefacts require any specific file format or dependencies?

No external dependencies are required to refine scope artefacts. The skill operates directly on existing artefact files and memory contexts, processing the internal structure of plans, epics, and stories to output updated discovery artefacts without format restrictions.

When should I not use an iterative scope refinement approach for discovery artefacts?

Iterative scope refinement is not suitable when discovery artefacts lack existing structural foundations or when human feedback is entirely absent. The process relies on identifying gaps within current plans, epics, or stories, so it cannot refine non-existent or undefined initial drafts.