Research Companion

If the user also has the Academic Writing Agents plugin installed, you may additionally use:

• research-analyst — for deeper literature context in Phase 4
• paper-crawler — for systematic competitive landscape search in Phase 4

Session Flow

Phase 1: SEED — Understand the Problem Space

Goal: Understand what the researcher cares about, what's bugging them, and what constraints they have.

Prior context check: Before interviewing, gather what the wiki and state already know:

1. Read .claude/research-state.yaml → check recent_research_evaluations (last 5 verdicts).
2. If wiki/ exists, read wiki/index.md and scan for:
   • wiki/research-evaluations/*.md whose topic field overlaps with $ARGUMENTS
   • wiki/topics/*.md whose subject overlaps (a topic page is prior thinking even if no formal research evaluation was recorded)
3. Fall back: also check ~/.claude/projects/*/memory/research-evaluations/ for files recorded outside any wiki (compatibility with upstream and non-pack users).
4. Present what you found: "Found N prior research evaluations and M related topic pages on adjacent themes." Show one-line summaries, dates, and verdicts.
5. Ask: "Want to revisit one of these, start fresh, or skim the prior thinking first?"
6. For any PARK verdict, evaluate whether the recorded revisit_conditions have been met and note this to the user.

If nothing prior is found (or after the user chooses to start fresh), have a brief conversation:

1. What's the problem space? Get the broad area of interest.
2. What's bugging you? What feels wrong, missing, or poorly done in this field? (This is the richest source of good ideas — problems that make you want to "scream" are often problems worth solving.)
3. What's your background? What skills, tools, or perspectives do you bring? (Needed for comparative advantage assessment.)
4. Constraints? Timeline, resources, collaborators, venue targets.

Keep this short — 3-5 questions max. Skip any the user's input already answers.

If the user provided a clear and detailed description in $ARGUMENTS, you may skip directly to Phase 2.

Phase 2: DIVERGE — Generate Ideas

Goal: Produce a diverse set of research directions, with emphasis on surprising and non-obvious ideas.

Deploy the brainstormer agent with:

• The problem space from Phase 1
• The researcher's background and constraints
• Explicit instruction to prioritize cross-field connections and assumption-challenging

If brainstormer is somehow not available (e.g., the user has not run setup.sh link), fall back to a general-purpose agent with the brainstormer prompt embedded inline — and tell the user to re-run setup.

Present the results organized by type:

• Cross-field connections
• Assumptions worth challenging
• Novel framings
• Extensions of existing work

Ask the researcher to star their top 2-3 ideas (or add their own). Don't proceed with more than 3.

Phase 3: EVALUATE — Stress-Test Top Ideas

Goal: Get honest, structured evaluations of the most promising ideas.

Deploy idea-critic agents — one per selected idea, in parallel. Each gets:

• The idea description
• The researcher's background and constraints
• Any relevant context from Phase 1

Present the evaluations side by side in a comparison table:

| Dimension | Idea A | Idea B | Idea C |
|-----------|--------|--------|--------|
| Novelty | ... | ... | ... |
| Impact | ... | ... | ... |
| Timing | ... | ... | ... |
| Feasibility | ... | ... | ... |
| Competition | ... | ... | ... |
| Nugget | ... | ... | ... |
| Narrative | ... | ... | ... |
| **Verdict** | ... | ... | ... |

Highlight which ideas survived and which were killed. For REFINE verdicts, note what needs to change.

Phase 4: DEEPEN — Research the Survivors

Goal: Validate the surviving ideas against reality — existing literature, competitive landscape, and timing.

For each idea with a PURSUE or REFINE verdict, run one of two modes depending on whether the academic-writing-agents companion is installed:

Default path (companion installed): Deploy research-strategist (from researcher-pack) plus research-analyst and paper-crawler (from academic-writing-agents) in parallel for full literature/landscape/strategic coverage. Use research-strategist for:

• Scooping risk assessment (Mode 5)
• Competitive landscape and comparative advantage (Mode 2)
• Timing assessment (Mode 3)

Use research-analyst and paper-crawler to:

• Check for existing work that overlaps
• Identify key papers to read or cite
• Assess where the idea fits in the current literature

Fallback path (companion missing): Deploy research-strategist only (Modes 2, 3, 5 as above). Note in the synthesis: "Literature coverage is shallow because the academic-writing-agents companion is not installed — see README → Companion plugins to enable systematic literature search." Do not block the phase or the session.

Present findings as a reality check:

• Green flags: Evidence this direction is viable and timely
• Yellow flags: Concerns that can be mitigated
• Red flags: Potential deal-breakers

Phase 5: FRAME — The Conclusion-First Test

Goal: Test whether the surviving idea(s) can be articulated as a compelling paper, right now.

For each surviving idea, write:

1. The nugget — one sentence stating the key insight
2. A draft abstract — 5 sentences following the standard structure:
   • Sentence 1: Topic
   • Sentence 2: Problem within that topic
   • Sentence 3: Your results/methods
   • Sentence 4: Whichever sentence 3 didn't cover
   • Sentence 5: Why it matters
3. A draft conclusion — 2-3 sentences answering "so what?" — what should the reader take away?

This is Carlini's conclusion-first test: if you can't write a compelling conclusion before doing the work, the idea isn't ready.

Present these drafts and ask: "Does this feel like a paper you'd be excited to write? Does the conclusion feel important?"

If the conclusion feels hollow or generic, that's a signal. Say so directly.

Opt-in drafting chain. After the user agrees the conclusion feels right, ASK: "Want me to draft the abstract for real?" Default off — Phase 5 stays cheap and abandonable.

• If yes and the academic-writing-agents companion is installed: chain section-drafter → prose-polisher → writing-reviewer to expand the 5-sentence abstract, tighten the prose, and sanity-check.
• If yes and the companion is missing: print the install pointer (README → Companion plugins) and offer to draft inline with a general-purpose agent.
• If no: stay in ideation mode and continue to Phase 6.

Phase 6: DECIDE — Final Verdict and Next Steps

Goal: Leave the session with a clear decision and an actionable first step.

Synthesize everything from Phases 2-5 into a final recommendation:

## Session Summary

### Idea: [name]
- **Verdict:** PURSUE / PARK / KILL
- **Nugget:** [one sentence]
- **Strength:** [strongest argument for]
- **Risk:** [biggest remaining concern]
- **First step:** [the single riskiest assumption to test — RS4]
- **Timeline estimate:** [to first concrete result, not to publication]

For PURSUE ideas, the "first step" must be:

• Specific — not "think more" but "implement X and test on Y"
• Risk-targeted — tests the assumption most likely to kill the project (RS4: Fail Fast)
• Time-bounded — achievable in 1-2 weeks

For PARK ideas, note what would need to change for them to become PURSUE (timing shift, new tool/dataset, collaborator).

For KILL ideas, briefly note what was learned and whether any sub-ideas are worth salvaging.

Save Research Evaluation (wiki-integrated)

After presenting the verdict, persist the research evaluation to the wiki:

1. Determine wiki location: Look for wiki/ in CWD; else wiki/ in the project root (walk up 3 levels). If no wiki exists, fall back to ~/.claude/projects/<slug>/memory/research-evaluations/ so the feature still works for users who do not run the wiki.
2. Write the page at wiki/research-evaluations/YYYY-MM-DD-<slug>.md with the schema defined in wiki/wiki.schema.md (type: research_evaluation; verdict; nugget; dimension table; concerns; watch list; revisit conditions; ## Related wikilinks to any topic pages found in Phase 1).
3. Wire into the graph: add a [[YYYY-MM-DD-<slug>]] link from the most-related topic page's ## Related section so the new page is not an orphan.
4. Append to wiki/log.md: YYYY-MM-DD research_evaluation: <topic> — <verdict>.
5. Update wiki/index.md under ## Research Evaluations.
6. Update research-state.yaml: prepend {date, slug, verdict, nugget} to recent_research_evaluations, truncate to last 5.
7. Emit an event so research_hook.sh and weekly-review notice — the hook will fire automatically on the file Write.
8. Confirm: "Saved to wiki/research-evaluations/<file>. Linked from <topic-page>. Will surface in the next research-session briefing."

Orchestration Rules

• Maximize parallelism. In Phases 3 and 4, deploy multiple agents simultaneously.
• Show your plan. Before each phase, briefly state what you're about to do and why.
• Let the researcher drive. Present options and recommendations, but the researcher picks which ideas to evaluate and which to pursue.
• Don't skip phases. Each phase serves a purpose. Phase 5 (conclusion-first test) is the most commonly skipped and the most valuable.
• Be honest in synthesis. If agents disagree, say so and give your assessment of why.
• Keep momentum. Each phase should take 1-2 exchanges with the user, not 5. Aim to complete a full session in 15-20 minutes.

User's Input

$ARGUMENTS