Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
dauquangthanh avatar

Requirements Gathering

  • 31 installs
  • 14 repo stars
  • Updated January 23, 2026
  • dauquangthanh/hanoi-rainbow

Requirements Gathering is an agent skill that guides stakeholder elicitation and requirements documentation so software teams can capture prioritized needs as user stories, use cases, and acceptance criteria.

About

Requirements Gathering is a Hanoi Rainbow skill that walks through stakeholder analysis, elicitation sessions, and documentation of functional and non-functional needs as user stories or formal specs. Use it when a software initiative needs captured, prioritized, and traceable requirements before Rainbow specify, design, or implement commands.

  • Interviews, workshops, surveys, and prototyping techniques
  • Agile user stories and traditional BRD patterns
  • MoSCoW prioritization and traceability guidance
  • Stakeholder mapping and engagement planning

Requirements Gathering by the numbers

  • 31 all-time installs (skills.sh)
  • Ranked #1,840 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Jul 29, 2026 (Skillselion catalog sync)
npx skills add https://github.com/dauquangthanh/hanoi-rainbow --skill requirements-gathering

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs31
repo stars14
Last updatedJanuary 23, 2026
Repositorydauquangthanh/hanoi-rainbow

How do you systematically capture stakeholder needs, constraints, and priorities before writing technical designs?

Run stakeholder elicitation, user stories, use cases, MoSCoW prioritization, and traceable requirements documents for software projects.

Who is it for?

Engineers and analysts starting or refreshing a requirements baseline for an agile or traditional software project.

Skip if: Teams that only need a quality audit of an existing requirements document without new elicitation.

When should I use this skill?

You mention requirements analysis, user stories, use cases, stakeholder interviews, or requirements documentation.

What you get

You produce stakeholder maps, elicitation plans, user stories or BRD sections, acceptance criteria, and prioritized requirement sets.

Files

SKILL.mdMarkdownGitHub ↗

Requirements Gathering

Overview

This skill guides you through systematic requirements gathering and documentation for software projects, from initial stakeholder analysis to detailed specifications and acceptance criteria.

Requirements Gathering Workflow

1. Planning & Stakeholder Analysis

Identify Stakeholders:

  • Map stakeholder categories: executives, users, developers, operations
  • Assess influence, interest, and availability
  • Plan engagement strategy for each stakeholder group

Select Elicitation Techniques:

  • Interviews: One-on-one discussions for deep insights (see elicitation-techniques.md)
  • Workshops: Collaborative sessions for alignment
  • Document Analysis: Review existing systems and documentation
  • Observation: Job shadowing to understand workflows
  • Surveys: Gather input from large user groups
  • Prototyping: Validate requirements with mockups

2. Requirements Elicitation

Conduct Stakeholder Sessions:

  • Prepare structured interview questions
  • Focus on current pain points and desired outcomes
  • Document business context, goals, and constraints
  • Capture exact quotes for later reference
  • Follow up with clarifications as needed

Key Questions to Ask:

  • What problems are you trying to solve?
  • What does success look like?
  • Who will use this system and how?
  • What are your constraints (budget, timeline, technical)?
  • What are must-have vs nice-to-have features?

3. Requirements Analysis & Documentation

Document Requirements:

Choose format based on project methodology:

For Agile Projects - Use user stories (see agile-requirements.md):

As a [role]
I want [capability]
So that [business value]

Acceptance Criteria:
- Given [context]
- When [action]
- Then [outcome]

For Traditional Projects - Use structured specifications:

  • Business Requirements Document (BRD): High-level business needs
  • Functional Requirements: What system must do
  • Non-Functional Requirements: Performance, security, usability
  • Use Cases: Detailed user-system interactions

Classify Requirements:

  • Functional vs Non-Functional
  • Business vs Technical vs User
  • Must-Have vs Should-Have vs Could-Have vs Won't-Have (MoSCoW)

4. Requirements Prioritization

Apply Prioritization Framework (see prioritization-frameworks.md):

  • MoSCoW: Must/Should/Could/Won't have (good for stakeholder alignment)
  • Value vs Effort: Plot on 2×2 matrix (quick wins vs long-term investments)
  • RICE: Reach × Impact × Confidence / Effort (data-driven scoring)
  • Kano Model: Basic/Performance/Delight features (user satisfaction focus)

5. Validation & Refinement

Review Requirements Quality:

  • [ ] Clear: Unambiguous, easy to understand
  • [ ] Complete: All necessary information included
  • [ ] Consistent: No contradictions
  • [ ] Testable: Can verify when implemented
  • [ ] Feasible: Technically and economically viable
  • [ ] Traceable: Linked to business goals

Get Stakeholder Sign-Off:

  • Review with each stakeholder group
  • Address conflicts and gaps
  • Document approvals and changes
  • Maintain requirements traceability matrix

Key Deliverables

Depending on project needs, produce:

  • Stakeholder Analysis: Categories, needs, engagement plan
  • Interview Summaries: Key findings and quotes
  • User Stories/Use Cases: Detailed functionality descriptions
  • Requirements Document: BRD, SRS, or PRD
  • Requirements Traceability Matrix: Links requirements to business goals, design, tests
  • Product Roadmap: Prioritized feature timeline

Reference Files

Load these on demand based on specific needs:

Process Guidance

  • [elicitation-techniques.md](references/elicitation-techniques.md) - Detailed interview techniques, workshop facilitation, and observation methods
  • [agile-requirements.md](references/agile-requirements.md) - User story writing, backlog management, sprint planning, and acceptance criteria
  • [prioritization-frameworks.md](references/prioritization-frameworks.md) - MoSCoW, RICE, Kano, Value/Effort frameworks with examples
  • [requirements-gathering-process.md](references/requirements-gathering-process.md) - End-to-end process from initiation to sign-off
  • [best-practices.md](references/best-practices.md) - Quality standards, common pitfalls, and validation checklists

Documentation Templates

  • [requirements-traceability-matrix.md](references/requirements-traceability-matrix.md) - Template and examples for tracking requirements
  • [use-case-overview.md](references/use-case-overview.md) - Use case structure and examples

Best Practices Summary

Avoid Common Pitfalls:

  • ❌ Solution-focused: "Use React framework" → ✅ "Provide responsive web interface"
  • ❌ Vague language: "System should be fast" → ✅ "System responds within 2 seconds for 95% of requests"
  • ❌ Gold plating: Focus on business value, not nice-to-haves
  • ❌ Assuming knowledge: Document all assumptions and define terms
  • ❌ Skipping validation: Always review and get stakeholder sign-off

Requirements Quality: Every requirement must be clear, complete, consistent, testable, feasible, necessary, prioritized, and traceable.

Related skills

FAQ

Does it support both agile and waterfall formats?

Yes—it documents agile user stories with Given/When/Then criteria and traditional BRD, functional, and non-functional specifications.

What elicitation methods does it include?

Interviews, workshops, document analysis, observation, surveys, and prototyping, with references to deeper technique guides in the repo.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.