brainstorming
$
npx mdskill add microsoft/FluidFramework/brainstormingTransform rough ideas into fully-formed designs through structured questioning and alternative exploration.
SKILL.md
.github/skills/brainstormingView on GitHub ↗
--- name: brainstorming description: IMMEDIATELY USE THIS SKILL when creating or develop anything and before writing code or implementation plans - refines rough ideas into fully-formed designs through structured Socratic questioning, alternative exploration, and incremental validation --- # Brainstorming Ideas Into Designs ## Overview Transform rough ideas into fully-formed designs through structured questioning and alternative exploration. **Core principle:** Ask questions to understand, explore alternatives, present design incrementally for validation. **Announce at start:** "I'm using the Nori Brainstorming skill to refine your idea into a design." ## The Process ### Phase 1: Understanding - Check current project state in working directory - Ask ONE question at a time to refine the idea - Prefer multiple choice when possible - Gather: Purpose, constraints, success criteria ### Phase 2: Exploration - Propose 2-3 different approaches - For each: Core architecture, trade-offs, complexity assessment - Ask your human partner which approach resonates ### Phase 3: Design Presentation - Present in 200-300 word sections - Cover: Architecture, components, data flow, error handling, testing - Ask after each section: "Does this look right so far?" ### Phase 4: Worktree Setup (for implementation) When design is approved and implementation will follow: - Announce: "I'm using the Using Git Worktrees skill to set up an isolated workspace." - Switch to .claude/skills/using-git-worktrees - Follow that skill's process for directory selection, safety verification, and setup - Return here when worktree ready ### Phase 5: Planning Handoff Ask: "Ready to create the implementation plan?" When your human partner confirms (any affirmative response): - Announce: "I'm using the Writing Plans skill to create the implementation plan." - Switch to .claude/skills/writing-plans skill - Create detailed plan in the worktree ## When to Revisit Earlier Phases **You can and should go backward when:** - Partner reveals new constraint during Phase 2 or 3 → Return to Phase 1 to understand it - Validation shows fundamental gap in requirements → Return to Phase 1 - Partner questions approach during Phase 3 → Return to Phase 2 to explore alternatives - Something doesn't make sense → Go back and clarify **Don't force forward linearly** when going backward would give better results. ## Remember - One question per message during Phase 1 - Apply YAGNI ruthlessly - Explore 2-3 alternatives before settling - Present incrementally, validate as you go - Go backward when needed - flexibility > rigid progression - Announce skill usage at start
More from microsoft/FluidFramework
- api-changesUse when customer-facing API changes were made — i.e., API report .md files differ from main. Guides through release tag assignment, API Council review requirements, breaking change classification, deprecation process, and changeset guidance. Triggered automatically by ci-readiness-check when api-report diffs are detected.
- building-ui-uxUse when implementing user interfaces or user experiences - guides through exploration of design variations, frontend setup, iteration, and proper integration
- ci-readiness-checkUse when the user explicitly asks for a CI check or to push their branch — e.g. "ci readiness", "check ci", "pre-push check", "ready for CI", "ci check", "ready to push", "push my changes", "push the branch", "let's push". Catches common CI failures before pushing — formatting, stale API reports, missing changesets, policy violations.
- creating-debug-tests-and-iteratingUse this skill when faced with a difficult debugging task where you need to replicate some bug or behavior in order to see what is going wrong.
- creating-skillsUse when you need to create a new custom skill for a profile - guides through gathering requirements, creating directory structure, writing SKILL.md, and optionally adding bundled scripts
- ff-oce-dashboardGenerate the OCE shift status dashboard. Triggers on: 'generate shift dashboard', 'show dashboard', 'shift status', 'status dashboard', 'what's going on', or any request for a NON-SPECIFIC overview of current OCE status (incidents, pipelines, errors).
- ff-oce-kustoUse this skill for any Kusto query or telemetry investigation specifically related to Fluid Framework or its partners. Triggers include: writing or running a Kusto query against the Office Fluid database, investigating Fluid Framework telemetry or error rates, querying Office_Fluid_FluidRuntime_* tables, looking up a Fluid session by Session_Id or docId, investigating a Fluid-related error in Loop or Whiteboard telemetry, monitoring an FF bump or partner ring deployment, checking Fluid render reliability or Scriptor errors, or when the user mentions Fluid-specific tables (Office_Fluid_FluidRuntime_*, OwhLoads, HostTracker, Scriptor) or Fluid-specific error types (dataCorruptionError, dataProcessingError, DeltaConnectionFailureToConnect, ICE, ACE). Do NOT trigger for general Kusto questions that are not related to Fluid Framework.
- finishing-a-development-branchUse this when you have completed some feature implementation and have written passing tests, and you are ready to create a PR.
- fluid-prUse when creating a pull request in the Fluid Framework repo. Composes a PR title and body following Fluid Framework conventions, proposes them to the user, then pushes the branch and creates the PR on GitHub. Triggers on "create a PR", "make a PR", "open a PR", "submit a PR", or "push and create a PR".
- fluid-pr-guideUse when composing, writing, drafting, or reviewing a PR title, PR description, or PR body in Fluid Framework — provides title style, body template, and section guidance.