Agent skill

discovery-high-level-plan

Transform vague or high-level human intent into a governed Discovery action plan. Activate when intent is unclear, broad, or when multiple discovery steps are required before any artefact is created.

Stars 123
Forks 27

Install this agent skill to your Project

npx add-skill https://github.com/Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/discovery/discovery-high-level-plan

Metadata

Additional technical details for this skill

id
SKILL-DISCOVERY-HIGH-LEVEL-PLAN-001
track
discovery
author
gaai-framework
status
stable
version
1.0
category
discovery
updated at
1772064000

SKILL.md

Discovery High-Level Planning

Purpose / When to Activate

Activate this skill when:

  • Intent is unclear or broad
  • Multiple discovery steps are required
  • You don't know which skills to run first
  • Refinement is needed before committing to artefacts

Typical triggers: "I have an idea for a feature", "Users are dropping during onboarding", "We should rethink pricing", "There's a bug where X happens but we don't know why"

This skill plans — it does not produce artefacts.


Process

  1. Understand the real problem or opportunity
  2. Determine Discovery scope: new initiative / feature addition / iteration / removal / clarification / bug triage (complex bug with unclear root cause)
  3. Identify required artefacts
  4. Select necessary skills in logical order
  5. Insert validation and refinement gates
  6. Output a minimal, governed plan

Outputs

Discovery Action Plan

Goal:
<what clarity must be achieved>

Steps:
1. <skill name> — purpose
2. <skill name> — purpose
3. <skill name> — purpose

Validation Gates:
- artefact completeness
- acceptance criteria present
- uncertainties flagged

Ready For Delivery:
yes / no

Blocking Reasons (if any):
- ...

Quality Checks

  • Plan is minimal and focused
  • All necessary artefacts will be produced
  • Skill sequence is logical
  • Governance is respected
  • Human can approve or adjust easily

Non-Goals

This skill must NOT:

  • Generate epics, stories, or PRDs
  • Make product decisions
  • Execute other skills
  • Write artefact content

If the next step isn't obvious — plan first. Planning prevents waste more than speed increases output.

Expand your agent's capabilities with these related and highly-rated skills.

Fr-e-d/GAAI-framework

ci-watch-and-fix

Watch GitHub Actions CI after PR creation, detect failures, extract logs, apply minimal fixes, and re-push — keeping the delivery session alive until CI resolves or escalating after 3 cycles. Activate immediately after gh pr create and before marking the story done.

123 27
Explore
Fr-e-d/GAAI-framework

qa-review

Validate that implemented code fully satisfies Story acceptance criteria, respects rules, and introduces no regressions. This is the hard quality gate — no pass means no delivery. Activate after implementation is complete.

123 27
Explore
Fr-e-d/GAAI-framework

compose-team

Assemble the context bundles for each sub-agent based on evaluate-story output. Produces spawn-ready packages for Planning, Implementation, QA, or MicroDelivery sub-agents. Activate after evaluate-story, before spawning any sub-agent.

123 27
Explore
Fr-e-d/GAAI-framework

coordinate-handoffs

Validate sub-agent handoff artefacts, sequence phase transitions, and manage retry and escalation logic. Activate after each sub-agent terminates to determine next action.

123 27
Explore
Fr-e-d/GAAI-framework

implement

Generate correct, minimal, maintainable code that satisfies a validated Story's acceptance criteria against an execution plan. Activate when a Story is validated, a plan exists, and all prerequisites are unambiguous.

123 27
Explore
Fr-e-d/GAAI-framework

delivery-high-level-plan

Transform validated Stories into a clear, minimal, governed execution plan. Used by the Planning Sub-Agent as the first planning pass before prepare-execution-plan for Tier 2/3, or as the sole planning output for simple Stories.

123 27
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results