gtapps/capability-brainstorm

Capability Brainstorm

Kill criteria (read before running)

After ≥8 invocations, compute two rates over state/proposal-metrics.jsonl:

• Triage-survival rate — grep '"type":"triage-verdict".*"evidence_source":"capability-brainstorm"' state/proposal-metrics.jsonl to find all triage-verdict events from this skill. Rate = CREATE count ÷ total. Kill if < 25%.
• PROP-acceptance rate — grep '"type":"created".*"tags":.*"capability-brainstorm"' state/proposal-metrics.jsonl to find created events tagged capability-brainstorm. Cross-reference their proposal_id against responded events with "action":"accept". Rate = accepted ÷ created. Kill if < 30%.

If either rate is below threshold, cut this skill rather than tune it — the signal-to-noise ratio isn't there.

1. Gather inputs

Read all four sources in parallel — they are independent.

Memory Read MEMORY.md (the index). For each entry whose title or description keyword-matches the current project domain or recent session topics, read that topic file. Aim for 3–5 relevant files; don't read the full corpus.

Capabilities (issue these three reads simultaneously)

• Skills: use the harness available-skills list loaded in your context — that is authoritative. Sibling-scan ${CLAUDE_PLUGIN_ROOT}/../*/.claude-plugin/plugin.json for plugin presence and version metadata only (not skill lists).
• MCPs: call ListMcpResourcesTool to enumerate currently online MCP tools.
• Channels: read config.json → channels keys.

Compiled artifacts Glob .claude-code-hermit/compiled/*.md. For files modified within the last 30 days, read the first 15 lines only (covers frontmatter + opening paragraph). Skip files older than 30 days.

Codebase shape Read repo README.md, CLAUDE.md, and ls of the repo root (one level deep, no recursion).

2. Generate ideas (max 2)

Think across all four inputs simultaneously. For each candidate idea, apply both constraints before including it:

1. Concrete friction — state the operator pain in one sentence: what happens today that this would fix or prevent. If you cannot name a specific pain (not "combines A and B usefully"), discard the idea.
2. ≥2 named grounding items — cite at least two specific items by name (e.g., memory:user_dev_workflow.md, mcp:Hassio.executar_bom_dia, skill:weekly-review, plugin:claude-code-fitness-hermit). These are supporting evidence, not a checklist — the friction is the bar.

Cap at 2 ideas that pass both constraints. Emit-zero if none do. Record discarded ideas (one line each) for the artifact.

3. Create proposals (single-pass via /proposal-create)

For each generated idea, invoke /proposal-create once with:

Title: <short idea title>
Evidence Source: capability-brainstorm
Evidence: <one-paragraph summary: friction + grounding items>

Set the PROP frontmatter:

• source: auto-detected
• category: capability
• tags: [capability-brainstorm, ideation]

/proposal-create invokes proposal-triage internally. Parse its outcome:

• CREATE — PROP file written, note the assigned PROP-NNN.
• SUPPRESS — <code> — record the suppression code. Don't retry.
• DUPLICATE:<PROP-ID> — record the existing PROP-ID. Don't create.

Do NOT invoke proposal-triage directly in this skill — /proposal-create already does it.

4. Emit batch message

Send one message following the Operator Notification protocol in CLAUDE.md (empty channels → optional PushNotification + conversation; configured channel → resolve + reply, with PushNotification last-resort and channel-send-unavailable dedup on miss):

🧠 Capability brainstorm (<N> idea(s))

1. **<short title>** — <one-line description>
   _Grounding: <item 1>, <item 2>_
   _Friction: <one-sentence pain>_
   _Estimated effort: <hours|days>_
   PROP-NNN created  ·  (or: suppressed — <code>  ·  or: duplicate of PROP-NNN)

2. **<short title>** — ...

If zero ideas were generated or all were suppressed/duplicated, the message is:

🧠 Capability brainstorm — 0 ideas emitted (<reason: thin context | all suppressed | all duplicates>)

5. Write compiled artifact (non-empty runs only)

If ≥1 PROP was created (not suppressed/duplicate), write:

.claude-code-hermit/compiled/capability-brainstorm-YYYY-MM-DD-HHMM.md

Frontmatter:

---
title: Capability brainstorm — <ISO timestamp>
type: capability-brainstorm
created: <ISO timestamp with timezone>
tags: [capability-brainstorm, ideation]
source: interactive
proposals_created: [PROP-NNN, ...]
---

Body (150-line cap):

• Ideas that passed generation and triage — one paragraph each.
• Discarded ideas — one line each (no grounding, no concrete friction).
• Triage verdicts for each emitted idea (CREATE / SUPPRESS — code / DUPLICATE:ID).
• Inputs scanned — titles/paths only, no content.

Do not tag foundational — this is a time-bounded ideation snapshot.

Zero-emit runs: skip the artifact entirely. Log one line to SHELL.md Findings: capability-brainstorm: 0 ideas emitted (<reason>)