Skip to content

feat: add ce:ideate skill with issue-grounded ideation mode#282

Merged
tmchow merged 5 commits intomainfrom
feat/ce-ideate-workflow
Mar 17, 2026
Merged

feat: add ce:ideate skill with issue-grounded ideation mode#282
tmchow merged 5 commits intomainfrom
feat/ce-ideate-workflow

Conversation

@tmchow
Copy link
Collaborator

@tmchow tmchow commented Mar 17, 2026

The problem

When you ask an AI coding agent "what should I build next?" or "what would you improve?", you typically get generic, surface-level suggestions — things like "add more tests" or "improve documentation." The ideas aren't grounded in your actual codebase, they aren't critically filtered, and there's no structured way to capture them or act on them.

The compound-engineering plugin already has ce:brainstorm (define what a chosen idea means) and ce:plan (figure out how to build it). But there's a missing first step: figuring out which ideas are even worth exploring. Many times, you have a roadmap already but other times, it can be helpful to get an ideation thought partner.

What this PR adds

ce:ideate — a new skill for grounded idea generation

ce:ideate answers the question: "What are the strongest ideas worth exploring in this project?"

It works by:

  1. Scanning the actual codebase to understand project shape, patterns, pain points, and leverage points — so every idea is grounded in reality, not abstract advice
  2. Generating 30-40 raw ideas using parallel sub-agents (7-8 per agent), each approaching from a different creative frame (user friction, missing capabilities, automation opportunities, assumption-breaking, compounding leverage, edge cases)
  3. Adversarially filtering the full list — skeptic agents attack the candidates, and only ideas that survive explicit rejection criteria make it through. Every rejected idea gets a reason.
  4. Presenting 5-7 survivors with a scannable overview line, then detailed blocks with downsides and confidence scores
  5. Writing a durable artifact to docs/ideation/ so the work survives session interruptions and can be resumed later

The skill routes into ce:brainstorm (not straight to implementation), completing the workflow: ideatebrainstormplanwork.

Issue-grounded ideation mode

When a user's argument indicates they want issue-tracker data as input (e.g., /ce:ideate bugs, /ce:ideate github issues), ce:ideate activates a new issue intelligence agent alongside its existing codebase scan:

  • New issue-intelligence-analyst agent — fetches GitHub issues via gh CLI (with GitHub MCP as fallback), clusters them by root-cause themes (not individual symptoms), and returns structured analysis with trend direction, confidence scores, and source mix (human vs bot-generated)
  • Priority-aware fetching — scans for priority/severity labels and fetches high-priority issues first, so P0s aren't buried under recent P3s
  • Token-efficient — truncated bodies (500 chars) included in the initial bulk fetch via --jq, avoiding N+1 individual body reads
  • Hybrid frame strategy — issue clusters drive ideation frames, padded with default frames when fewer than 4 themes exist. This keeps ideas grounded in real user pain while maintaining creative diversity
  • Closed issues as recurrence signal — closed issues don't create themes on their own (that's a solved problem). They only strengthen themes that already have open issues — the recurrence of fixed-then-reopened patterns is the real smell that something systemic isn't resolved
  • Standalone capable — the agent works independently outside ce:ideate for general issue landscape analysis

Example: running /ce:ideate bugs on a repo with 25+ duplicate LIVE_DOC_UNAVAILABLE issues produces a "collaboration write path reliability" theme — not 25 separate bug-fix ideas.

Other improvements

  • Volume model tuning — reduced per-agent idea target from 10 to 7-8 based on real usage data showing the speculative tail rarely survived filtering
  • Rejection summary as numbered table — easier to scan than a flat bullet list, and makes filtering rigor tangible

Files changed

File Change
agents/research/issue-intelligence-analyst.md New agent
skills/ce-ideate/SKILL.md Issue-tracker intent detection, conditional agent dispatch, dynamic frame derivation, resume awareness, rejection table format
plugin.json Agent count 28 → 29
marketplace.json Description updated
README.md Research agents table updated
docs/brainstorms/ Requirements doc for the feature
docs/plans/ Implementation plan

@tmchow tmchow changed the base branch from main to feat/ce-plan-rewrite-brainstorm March 17, 2026 03:43
@tmchow tmchow changed the base branch from feat/ce-plan-rewrite-brainstorm to main March 17, 2026 03:43
@tmchow tmchow changed the title feat: add ce:ideate skill and rewrite ce:plan feat: add ce:ideate skill with issue-grounded ideation mode Mar 17, 2026
@tmchow tmchow force-pushed the feat/ce-ideate-workflow branch 3 times, most recently from aa637a5 to 6000598 Compare March 17, 2026 05:33
@tmchow tmchow marked this pull request as ready for review March 17, 2026 05:34
@tmchow tmchow force-pushed the feat/ce-ideate-workflow branch from 6000598 to 243e02b Compare March 17, 2026 06:09
@tmchow tmchow changed the base branch from main to feat/ce-plan-rewrite-brainstorm March 17, 2026 06:11
@tmchow tmchow changed the base branch from feat/ce-plan-rewrite-brainstorm to main March 17, 2026 06:11
tmchow added 5 commits March 16, 2026 23:18
Requirements for a new open-ended ideation skill that does
divergent-then-convergent idea generation for project improvements.
Standalone from ce:brainstorm, covers codebase scanning, volume-based
idea generation, self-critique filtering, and durable artifact output.
Standard-depth plan with 3 implementation units:
1. Create SKILL.md with 7-phase workflow (resume, scan, generate,
   critique, write artifact, present, handoff)
2. Update plugin metadata (README, plugin.json, marketplace.json counts)
3. Rebuild documentation site

Resolves all 5 deferred planning questions from the requirements doc.
…tting synthesis

- Clarify sub-agent volume: each agent targets ~10 ideas (40-60 raw, ~30-50 after dedupe)
- Reframe ideation lenses as starting biases, not constraints, to encourage cross-cutting ideas
- Add orchestrator synthesis step between merge/dedupe and critique
- Improve skill description with specific trigger phrases for better auto-discovery
- Update argument-hint to be user-facing ("feature, focus area, or constraint")
- Position ideate as optional entry point in workflow diagram, not part of core loop
- Update plugin metadata and README with new skill counts and descriptions
Reduce per-agent idea target from 10 to 7-8 based on real usage data
showing ideas 8-11 were speculative tail that rarely survived filtering.
This keeps the unique candidate pool manageable (~20-30 after dedup)
while preserving frame diversity across 4-6 agents. Also add scannable
overview line before detail blocks in Phase 4, and clarify foreground
dispatch and native tool usage in Phase 1.
New issue-intelligence-analyst agent that fetches GitHub issues via
gh CLI, clusters by root-cause themes, and returns structured analysis
with trend direction, confidence scores, and source mix. Designed for
both ce:ideate integration and standalone use.

Agent design:
- Priority-aware fetching with label scanning for focus targeting
- Truncated bodies (500 chars) in initial fetch to avoid N+1 calls
- Single gh call per fetch, no pipes or scripts (avoids permission spam)
- Built-in --jq for all field extraction and filtering
- Mandatory structured output with self-check checklist
- Accurate counts from actual data, not assumptions
- Closed issues as recurrence signal only, not standalone evidence

ce:ideate gains:
- Issue-tracker intent detection in Phase 0.2
- Conditional agent dispatch in Phase 1 (parallel with existing scans)
- Dynamic frame derivation from issue clusters in Phase 2
- Hybrid strategy: cluster-derived frames + default padding when < 4
- Resume awareness distinguishing issue vs non-issue ideation
- Numbered table format for rejection summary in ideation artifacts
@tmchow tmchow force-pushed the feat/ce-ideate-workflow branch from 243e02b to 0fc6717 Compare March 17, 2026 06:20
@tmchow tmchow changed the base branch from main to feat/ce-plan-rewrite-brainstorm March 17, 2026 06:20
@tmchow tmchow changed the base branch from feat/ce-plan-rewrite-brainstorm to main March 17, 2026 06:20
@tmchow tmchow changed the base branch from main to feat/ce-plan-rewrite-brainstorm March 17, 2026 06:28
@tmchow tmchow force-pushed the feat/ce-plan-rewrite-brainstorm branch 2 times, most recently from dd21e47 to dca2f79 Compare March 17, 2026 07:33
@tmchow tmchow changed the base branch from feat/ce-plan-rewrite-brainstorm to main March 17, 2026 07:36
@kieranklaassen
Copy link
Collaborator

idea: I love this one. Could we make the compoundEngineeringConfig also define what the sources are you want to use normally in the ideation? For example, I can link posthog, AppSignal, maybe Postgres database, stuff like that. So you can customize what the sources for ideation are normally.

@kieranklaassen
Copy link
Collaborator

but please merge and then i can also add these things

@tmchow tmchow merged commit aa71dbc into main Mar 17, 2026
1 check passed
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