refine-scope

Identify gaps and ambiguities in discovery artefacts and produce a refined scope plan.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill refine-scope-petrsimonidesxart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-scope
Source: https://github.com/petrSimonidesXart/xPmGateway/tree/main/.gaai/core/skills/discovery/refine-scope
Command: npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill refine-scope-petrsimonidesxart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iteratively refine Discovery artefacts (plans, epics, stories) when feedback, ambiguity, or uncertainty is detected, ensuring completeness and alignment with stakeholder intent.

Core Features & Use Cases

  • Identify gaps, contradictions, or missing acceptance criteria in artefacts.
  • Apply feedback to targeted fields, updating artefacts while preserving context.
  • Produce a refined discovery plan or artefacts for review and handoff.

Quick Start

Provide your current discovery artefacts and the latest feedback to the agent and run refine-scope to generate a refined plan.

Frequently Asked Questions about refine-scope

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

FAQPage Schema
How do I refine discovery artefacts when stakeholder feedback introduces ambiguity?

Refining discovery artefacts involves identifying gaps and ambiguities in current plans and epics, then applying a structured refinement loop to update artefacts in place while logging rationale for governance compliance.

What is the best way to update epics and stories with missing acceptance criteria?

Updating epics and stories requires identifying missing acceptance criteria within your discovery artefacts and applying targeted feedback to specific fields, preserving context while producing a refined scope plan for review.

Can I use this approach to realign discovery plans when new feedback is received?

Yes, you can realign discovery plans by feeding current artefacts and new feedback into a structured refinement loop that updates epics and stories in place and logs the rationale for all changes to maintain traceability.

How do I identify gaps and contradictions in discovery artefacts before handoff?

Identifying gaps and contradictions in discovery artefacts requires iteratively reviewing plans, epics, and stories for missing clarity or conflicting information, then generating a refined plan that ensures completeness and alignment with stakeholder intent.

Does refining scope artefacts preserve the original context and traceability?

Refining scope artefacts preserves context by applying feedback to targeted fields without losing surrounding information, and maintains traceability by logging the rationale for every change to ensure governance compliance.

When should I not use an automated discovery artefact refinement loop?

You should avoid using an automated refinement loop when discovery artefacts lack initial structure or when feedback is too vague to map to targeted fields, as the process relies on existing plans, epics, and stories to update in place.