Skip to content

feat: Add /workflows:brainstorm command and skill#101

Merged
kieranklaassen merged 2 commits intoEveryInc:mainfrom
tmchow:feat/brainstorm-command
Jan 21, 2026
Merged

feat: Add /workflows:brainstorm command and skill#101
kieranklaassen merged 2 commits intoEveryInc:mainfrom
tmchow:feat/brainstorm-command

Conversation

@tmchow
Copy link
Contributor

@tmchow tmchow commented Jan 21, 2026

Summary

  • Add /workflows:brainstorm command for exploring requirements and approaches before planning
  • Add brainstorming skill with process knowledge (question techniques, approach exploration, YAGNI principles)
  • Update /workflows:plan to detect brainstorm output in docs/brainstorms/ and skip idea refinement

Note: This builds off #100

Workflow

/workflows:brainstorm → docs/brainstorms/YYYY-MM-DD-<topic>.md → /workflows:plan (auto-detects)

Brainstorm answers WHAT to build:

  • Requirements and acceptance criteria
  • Chosen approach and rationale
  • Key decisions and trade-offs

Plan answers HOW to build it:

  • Implementation steps and file changes
  • Technical details and code patterns

Examples

  • /workflows:brainstorm I want users to know when important things happen in their account - maybe email, maybe push notifications, not sure what makes sense
  • /workflows:plan @docs/brainstorms/2026-01-21-user-notifications.md

Previously, /workflows:plan always ran all 3 research agents (repo-research,
best-practices, framework-docs) regardless of task complexity. This wasted
tokens and time for simple tasks like UI tweaks or bug fixes with clear causes.

Now the workflow:
- Always runs repo research first (fast, local)
- Makes an informed decision about external research based on:
  - Signals gathered during idea refinement (familiarity, intent, risk)
  - Repo research findings (existing patterns, CLAUDE.md guidance)
- High-risk topics (security, payments, external APIs) always trigger research
- Strong local context allows skipping external research
- Announces the decision and proceeds, user can redirect if needed

This makes the planning workflow smarter about when web research adds value.
Add brainstorming workflow to explore requirements and approaches
before planning implementation:

- New `/workflows:brainstorm` command for collaborative dialogue
- New `brainstorming` skill with process knowledge and techniques
- Update `/workflows:plan` to detect brainstorm output and skip
  idea refinement when relevant brainstorm exists
- Add brainstorm to README workflow commands table

The brainstorm → plan flow enables:
- Phase 0: Assess requirement clarity
- Phase 1: Understand the idea via repo research + dialogue
- Phase 2: Explore 2-3 approaches with trade-offs
- Phase 3: Capture design to docs/brainstorms/
- Phase 4: Handoff to /workflows:plan
@kieranklaassen
Copy link
Collaborator

love this yeah. I do this myself all the time. Thinking about making a new plugin for this even but Ithink this is cool to start with and experiment. TY

@kieranklaassen kieranklaassen merged commit cc905c7 into EveryInc:main Jan 21, 2026
criztiano pushed a commit to criztiano/coen that referenced this pull request Jan 23, 2026
* feat(workflows:plan): Add smart research decision logic

Previously, /workflows:plan always ran all 3 research agents (repo-research,
best-practices, framework-docs) regardless of task complexity. This wasted
tokens and time for simple tasks like UI tweaks or bug fixes with clear causes.

Now the workflow:
- Always runs repo research first (fast, local)
- Makes an informed decision about external research based on:
  - Signals gathered during idea refinement (familiarity, intent, risk)
  - Repo research findings (existing patterns, CLAUDE.md guidance)
- High-risk topics (security, payments, external APIs) always trigger research
- Strong local context allows skipping external research
- Announces the decision and proceeds, user can redirect if needed

This makes the planning workflow smarter about when web research adds value.

* feat: Add /workflows:brainstorm command and skill

Add brainstorming workflow to explore requirements and approaches
before planning implementation:

- New `/workflows:brainstorm` command for collaborative dialogue
- New `brainstorming` skill with process knowledge and techniques
- Update `/workflows:plan` to detect brainstorm output and skip
  idea refinement when relevant brainstorm exists
- Add brainstorm to README workflow commands table

The brainstorm → plan flow enables:
- Phase 0: Assess requirement clarity
- Phase 1: Understand the idea via repo research + dialogue
- Phase 2: Explore 2-3 approaches with trade-offs
- Phase 3: Capture design to docs/brainstorms/
- Phase 4: Handoff to /workflows:plan
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants