blog-ideation-funnel

blog-ideation-funnel

A Claude Code plugin that turns messy braindump notes into scoped, well-argued blog posts.

Most note-taking dies in the pile: you dump twenty half-thoughts into a file and can't tell how many posts are buried in there, which are worth writing, or where one stops. This plugin runs a disciplined funnel over that pile — and keeps a human in the loop for the judgments that are actually yours.

What it does

braindump note(s) ──/funnel──▶ scoped winner + backlog seeds ──/draft──▶ post skeleton
                                     ▲
                                /backlog  (triage queued / research / parked seeds)

The funnel has five stages plus an adversarial pass:

1. Atomize — break the dump into tagged idea-units (claim / question / reference / link).
2. Cluster & name — group into candidate posts, with cohesion/coupling/bridge checks that make the hidden post-count visible.
3. Thesis test — each cluster becomes a thesis post, an explainer, or a research target.
4. 3.5 Red-team — four adversarial checks for soundness, not just novelty: falsifiability, taboo-the-jargon, conjunction count, and a motivated-reasoning discount.
5. Score — two anchored axes (strategic value, field contribution) plus an anticipation-depth gate: does the post beat what an informed reader already auto-generates on hearing the claim?
6. Scope brief — title, non-regenerable core, hook, framing, TL;DR, beats, out-of-scope, open questions.

Everything not written this round flows to a backlog (queued / research targets / parked) so nothing is lost. A separate drafting & publishing checklist carries a chosen post from blank page to publish.

Design principle: the model proposes, you decide

The funnel deliberately stops at the judgments only the author can make. It will never set your strategic value scores or pick the winning post for you — it presents the analysis and waits. It also never edits your raw notes, and never invents a citation.

Install

/plugin marketplace add kaustubhkislay/blog-ideation-funnel
/plugin install blog-ideation-funnel@kaustubh-blog-tools

Or manually: copy skills/ and commands/ into your ~/.claude/.

Usage

• /funnel <note title(s)> — run the funnel on one or more braindumps (pass several to fold cross-note clusters into one pass).
• /backlog — summarize and triage the seed queue; promote an item back into the funnel.
• /draft <winning title> — scaffold posts/YYYY-MM-DD-slug.md from a scope brief (skeleton only — the substance is yours).

You can also just ask in plain language ("run the ideation funnel on my eval-gaming note") — the skill triggers on intent.

The plugin works on any folder of markdown notes (built with Obsidian vaults in mind). On first use it asks which notes folder to work in and creates a Post backlog.md there.

Attribution

The drafting/publishing checklist distils publicly published writing advice (Marius Hobbhahn, Neel Nanda, gwern, Astral Codex Ten / Slate Star Codex, Ben Kuhn, and several LessWrong posts) — paraphrased, with links in skills/ideation-funnel/drafting-checklist.md. The Stage 3.5 red-team draws its checks from rationalist epistemics (falsificationism; Yudkowsky's Taboo and map/territory; the conjunction fallacy; motivated cognition).

License

MIT — see LICENSE.