requirements-engineering

Transforms stakeholder needs into testable user stories with Given/When/Then acceptance criteria.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/JaviMontano/claude-plugins --skill requirements-engineering-javimontano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirements-engineering
Source: https://github.com/JaviMontano/claude-plugins/tree/main/plugins/claude-native-toolkit/skills/requirements-engineering
Command: npx skills add https://github.com/JaviMontano/claude-plugins --skill requirements-engineering-javimontano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Vague stakeholder requests and ambiguous feature ideas often lead to rework and misaligned implementations. This Skill converts informal needs into precise, testable requirements using structured user stories, Gherkin acceptance criteria, and traceability matrices. ## Core Features & Use Cases - User Story Authoring: Writes INVEST-compliant stories in the "As a / I want / So that" format with atomic, deterministic acceptance criteria. - Gherkin Acceptance Criteria: Defines Given/When/Then scenarios covering positive, negative, and error paths for every business rule. - Traceability & Validation: Builds traceability matrices linking requirements to business objectives and flags conflicting requirements explicitly. - Use Case: Given a stakeholder request like "customers need an easier refund flow", produce formalized user stories with testable acceptance criteria ready for development and QA review. ## Quick Start Ask the assistant to turn the stakeholder request about an easier refund flow into testable user stories and acceptance criteria.

Frequently Asked Questions about requirements-engineering

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

FAQPage Schema
How do I write testable acceptance criteria for user stories?▼

Write acceptance criteria in Given/When/Then (Gherkin) format so each criterion is atomic, deterministic, and automatable. Include concrete examples, cover negative and error scenarios, and avoid vague phrases like "works well" that cannot be verified.

How to turn vague stakeholder requests into user stories?▼

Decompose the request into INVEST-compliant stories using the "As a [role], I want [goal], so that [benefit]" format. Identify implicit requirements, edge cases, and non-functional needs, then link each story to a business objective in a traceability matrix.

What is the INVEST criteria for user stories?▼

INVEST stands for Independent, Negotiable, Valuable, Estimable, Small, and Testable. Stories meeting these six properties are appropriately sized for a sprint, clearly scoped, and verifiable through acceptance criteria.

How do I handle conflicting requirements from stakeholders?▼

Flag conflicts explicitly rather than silently choosing one side, document each stakeholder's position, and propose a resolution path. Final decisions require stakeholder validation since requirements tools do not replace domain expert judgment.

When should I not use requirements engineering workflows?▼

Skip requirements elicitation when implementing from an already approved specification, since expanding approved requirements with unstated features is gold plating. This workflow is for capturing and formalizing needs, not for code implementation.