req-brainstorm

Generate structured development requirements documents through proposal-based brainstorming.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/wakuwaku-inc/req-skill --skill req-brainstorm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: req-brainstorm
Source: https://github.com/wakuwaku-inc/req-skill/tree/main/skills/req-brainstorm
Command: npx skills add https://github.com/wakuwaku-inc/req-skill --skill req-brainstorm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams run an active-proposal brainstorming session to produce a structured development requirements document, reducing miscommunication and rework.

Core Features & Use Cases

  • Proposals-first workflow: generates 2–3 high-level proposal options with tradeoffs for the same requirements scenario.
  • Clarifying questions: prompts to resolve ambiguities in $ARGUMENTS and draft DoD-ready requirements.
  • Workspace-aware output: determines the final write path and prepares for templated documentation in the project's docs folder.
  • DoD separation: organizes acceptance criteria for both requester and engineer perspectives.

Quick Start

Initiate an active-proposal brainstorm to draft a requirements document under docs/[req-skill/]requirements/ and confirm the final path before writing.

Frequently Asked Questions about req-brainstorm

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

FAQPage Schema
How do I brainstorm new feature proposals before writing development requirements?

To brainstorm new feature proposals before writing development requirements, you generate 2–3 high-level options with tradeoffs to clarify ambiguities. This active-proposal approach captures use cases and assumptions early, producing a structured requirements document that reduces rework.

What is the best way to draft DoD criteria for product management workflows?

Drafting DoD criteria for product management workflows is best done by separating acceptance criteria into requester and engineer perspectives. This ensures both use cases and technical assumptions are resolved before committing to a templated requirements document.

How does an active-proposal brainstorming session structure a requirements document?

An active-proposal brainstorming session structures a requirements document by applying tradeoff analysis to multiple proposal options. It organizes use cases, assumptions, and Definition of Done criteria separately for requesters and engineers before writing to a project docs folder.

Can I generate multiple proposal options with tradeoff analysis for the same feature requirements?

Yes, you can generate multiple proposal options with tradeoff analysis for the same feature requirements. The workflow produces 2–3 high-level proposals, prompts clarifying questions to resolve ambiguities, and prepares a DoD-ready document for engineering teams.

Does requirements brainstorming support workspace-aware output paths for project documentation?

Requirements brainstorming supports workspace-aware output paths by determining the final write location within the project's docs folder. It prepares for templated documentation under a structured requirements directory and confirms the path before writing.

When do I need to separate acceptance criteria for requesters and engineers in a requirements document?

You need to separate acceptance criteria for requesters and engineers when drafting DoD-ready requirements to minimize miscommunication. This separation ensures both business use cases and technical assumptions are explicitly captured before committing to a template.