brainstorm-insights
Installation
SKILL.md
Brainstorm & Insights Generation
Two generators bundled under one workflow skill. Both transform diffuse upstream signal — conversation, project state, session facets — into a concrete artifact the user (or downstream skill) can act on.
| Operation | Input | Output Artifact |
|---|---|---|
| Brainstorm | Topic + project/git context | BRAINSTORM-<topic>-<date>.md or docs/specs/SPEC-<topic>-<date>.md |
| Insights | ~/.claude/usage-data/facets/*.json |
Terminal report, report.html, or JSON; includes claude_md_additions |
Boundary With Adjacent Skills
This skill is the generation end of an insights lifecycle. It does not mutate CLAUDE.md, settings, or specs.
| Skill | Role | Lifecycle Phase |
|---|---|---|
| brainstorm-insights (this) | Generates BRAINSTORM/SPEC and INSIGHTS report | Produce |
insights-apply |
Reads INSIGHTS report, writes suggestions into ~/.claude/CLAUDE.md via sync pipeline |
Consume / apply |
adhd-workflow |
Session boundary ops (done, recap, next, focus, stuck, spec-review, refine) | Operate on existing artifacts |
project-planner |
Project-scope planning, estimation, roadmaps | Plan after spec exists |