brainstorm-with-file

Runs interactive multi-perspective brainstorming sessions with documented thought evolution in markdown files.

2.1k|165|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/catlog22/Claude-Code-Workflow --skill brainstorm-with-file
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brainstorm-with-file
Source: https://github.com/catlog22/Claude-Code-Workflow/tree/main/.codex/skills/brainstorm-with-file
Command: npx skills add https://github.com/catlog22/Claude-Code-Workflow --skill brainstorm-with-file

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unstructured brainstorming loses ideas, decisions, and reasoning over time. This Skill guides an idea from seed to synthesis through a documented workflow that records every round, perspective, and decision in a persistent brainstorm.md file.

Core Features & Use Cases

  • Documented Thought Evolution: Maintains a brainstorm.md timeline capturing ideas, user feedback, challenged assumptions, and decision records across up to 6 refinement rounds.
  • Multi-Perspective Analysis: Runs creative, pragmatic, and systematic perspectives serially and inline, with optional professional roles like system-architect or product-manager.
  • Codebase and Web Context: Detects the project type, searches relevant code patterns, and optionally pulls external research via web search to ground ideas.
  • Structured Handoff: Ends with a terminal gate offering task execution handoff, issue creation, or clean completion, plus a synthesis.json of ranked ideas.
  • Use Case: A developer wants to explore a new caching strategy. The Skill creates a session folder, analyzes the codebase, generates ideas from three perspectives, refines them through interactive rounds, and produces a ranked synthesis with next steps.

Quick Start

Ask the AI to brainstorm a topic such as "How to improve developer onboarding experience" using the brainstorm-with-file workflow with default perspectives.

Frequently Asked Questions about brainstorm-with-file

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

FAQPage Schema
How do I run a structured brainstorming session with an AI coding assistant?

Invoke the workflow with a topic argument, for example TOPIC="New caching strategy". The Skill creates a session folder, runs multi-perspective analysis inline, and iterates with you through refinement rounds before producing a final synthesis.

What perspectives does this brainstorming workflow use?

It defaults to creative, pragmatic, and systematic perspectives run serially and inline. You can override them with --perspectives or select professional roles like system-architect, product-manager, or ux-expert based on topic keywords.

Can I continue a previous brainstorming session?

Yes. Pass --continue or reuse the same topic; the Skill auto-detects an existing session folder with brainstorm.md and resumes from the last recorded round with all prior context intact.

Does the brainstorming workflow use external research?

Yes, optionally. It can run web searches for industry patterns, best practices, and competitive solutions, storing findings in research.json and merging them into the perspective synthesis.

What output files does a brainstorming session produce?

It produces brainstorm.md with the full thought evolution timeline, perspectives.json with aggregated findings, per-idea deep-dive files in an ideas folder, and a final synthesis.json with ranked ideas and recommendations.

When should I not use this brainstorming workflow?

Avoid it for quick single-answer questions or tasks needing parallel multi-agent delegation, since it executes serially and inline by design. It is best suited for open-ended exploration that benefits from documented iteration.