brainstorming-clarifying

Clarify item requirements one at a time with iterative summaries and design-document updates.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/ben-mad-jlp/claude-mermaid-collab --skill brainstorming-clarifying
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorming-clarifying
Source: https://github.com/ben-mad-jlp/claude-mermaid-collab/tree/main/skills/brainstorming-clarifying
Command: npx skills add https://github.com/ben-mad-jlp/claude-mermaid-collab --skill brainstorming-clarifying

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The CLARIFYING phase discusses each item one at a time to fully understand requirements before designing.

Core Features & Use Cases

  • Single-item focus: Ensure each item's requirements are explored individually.
  • Iterative questioning: Ask targeted questions, summarize understanding, and update the design docs incrementally.
  • Auto-decomposition readiness: When an item is large, propose decomposition into smaller work items and guide subsequent steps.

Quick Start

Start a CLARIFYING session for the first item in your collab session and begin asking clarifying questions one item at a time.

Frequently Asked Questions about brainstorming-clarifying

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

FAQPage Schema
How do I clarify item requirements one at a time during a collaboration session?

To clarify item requirements one at a time, use targeted iterative questioning within a collaboration session. This approach enforces single-item focus, sequentially progressing through design phases while incrementally updating the design document to fully capture understanding before moving forward.

What is the best way to decompose large work items during requirements gathering?

The best way to decompose large work items during requirements gathering is to use auto-decomposition prompts. When an item is large, this approach proposes splitting it into smaller work items and guides subsequent sequential questioning to refine those specific requirements.

How do I update a design document incrementally while conceptualizing requirements?

To update a design document incrementally during conceptualization, use MCP-based design doc updates. After exploring each item's requirements through targeted questioning, summarize your understanding and apply it directly to the structured design document.

Can I focus on multiple design items simultaneously during a clarification phase?

You cannot focus on multiple design items simultaneously. The clarification phase enforces a single-item focus to ensure each item's requirements are explored individually, preventing context loss and ensuring sequential progression through design phases.

When should I use incremental design questioning for requirement gathering?

You should use incremental design questioning for requirement gathering when you need to fully understand item requirements before designing. It is applicable to structured design workflows, ensuring each item is clarified sequentially through targeted questions and iterative summaries.