scope

Document stakeholder requirements and convert them into Gherkin specifications.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/nullhack/pytest-beehave --skill scope-nullhack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scope
Source: https://github.com/nullhack/pytest-beehave/tree/main/.opencode/skills/scope
Command: npx skills add https://github.com/nullhack/pytest-beehave --skill scope-nullhack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides the PO through Step 1 of the feature lifecycle: interviewing the stakeholder, discovering requirements, and writing Gherkin specifications precise enough for a developer to write tests without asking questions.

Core Features & Use Cases

  • Discovery workflow: guides the PO through two stages (Discovery and Specification), producing docs/discovery_journal.md, docs/discovery.md, and initial .feature descriptions.
  • Structured interviewing techniques: includes active listening protocols and gap-finding techniques to surface requirements and constraints.
  • Stage 2 readiness: supports transforming discovery into Rule: blocks and Example: blocks with @id tags, ready for baselining.
  • Governance templates: provides templates and process guidance for maintaining and iterating feature scope with stakeholders.

Quick Start

Run a discovery session with the stakeholder and generate the discovery journal and synthesis templates, then draft initial feature descriptions.

Frequently Asked Questions about scope

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

FAQPage Schema
How do I convert stakeholder interview notes into Gherkin specifications?

To convert stakeholder interview notes into Gherkin specifications, use a structured discovery workflow that synthesizes stakeholder requirements and transforms them into precise Rule and Example blocks with @id tags, producing ready-to-edit .feature files.

What is the best way to document feature requirements during stakeholder discovery?

Documenting feature requirements during stakeholder discovery works best by maintaining a discovery journal and synthesis templates, capturing raw inputs and active listening results to produce a structured discovery.md file for stakeholder alignment.

How do I write Gherkin feature files precise enough for developers to avoid follow-up questions?

Writing Gherkin feature files precise enough for developers requires applying gap-finding techniques during stakeholder interviews to surface hidden constraints, then mapping those exact criteria into structured Rule and Example blocks within the feature descriptions.

Can I use structured interviewing techniques for refining existing feature scope?

Yes, you can use structured interviewing techniques for refining existing feature scope, as the discovery and specification workflow supports both new features and refined features by iterating on governance templates and updating the discovery documentation.

What templates are needed to guide stakeholder requirements discovery and synthesis?

Templates needed to guide stakeholder requirements discovery include a discovery journal for raw interview capture, a synthesis document for structured analysis, and governance templates to maintain and iterate feature scope with stakeholders throughout the lifecycle.