devflow-area-ideation

Skill: devflow-area-ideation

Wiki-grounded ideation. When the user clicks "Copy prompt" on the IdeasPage and pastes the result into Claude, this skill drives the response. The prompt has the Wiki-context pre-loaded — don't ignore it, use it.

When to use

• The user pasted a prompt that starts with # Idea-Hunt: <area> for this project.
• The prompt contains a ## Context section with ADRs / patterns / runbooks already listed.
• Tasks ask for "3 concrete next-step ideas" or "3 market-opportunity ideas".

Process

1. Read the prompt's Context section completely

The IdeasPage already pulled the relevant wiki snapshot. Don't re-fetch the same data — extend it:

• wiki_get_briefing({ flowId }) — only if you have an active flow context (rare for ideation).
• wiki_search({ q: <area-name> }) — to surface entries the prompt didn't pre-load.
• wiki_get_index({ projectId }) — to see if the area has more entries grouped by lifecycle.
• pending_work({ projectId, tags: [<area>] }) — what's already in flight.

2. For each candidate idea — verify wiki-grounding

For every idea you generate, ask: which existing ADR / pattern / runbook does this build on? If you can't name one, the idea is too thin — discard or refine.

If the area is market (signal: prompt says "market-opportunity ideas"), allow looser grounding — but still name ONE wiki entry per idea ("extends [[ADR-X]]" or "fills the gap left by [[pattern:Y]]").

3. Output exactly 3 ideas as JSON

[
  {
    "summary": "Concise ticket-style summary (≤80 chars)",
    "description": "2-3 sentences: what + why, grounded in wiki",
    "wikiEvidence": ["ADR-014", "pattern:rate-limit"],
    "kindOfWork": "feature" | "refactor" | "research" | "runbook" | "adr"
  }
]

After the JSON, add a 2-line verdict explaining if the area looks healthy (rich context → easy ideation) or thin (worth investing in wiki harvesting first).

4. Optional: emit discipline-token

devflow_token_emit({
  flowId: <currentFlowId or null>,
  skillName: 'devflow-area-ideation',
  evidence: {
    area: '<area-name>',
    ideas: [{ summary, kindOfWork, wikiEvidence }],
    verdict: 'healthy' | 'thin',
    completedAt: new Date().toISOString()
  }
})