Idea

SkillDev tools

Use when a quest needs concrete hypotheses, limitation analysis, candidate directions, or a selected idea relative to the active baseline.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Idea skill

What this skill tells your AI

The instructions your AI receives, as published by openlair/dr-claw in skills/ds-idea/SKILL.md and read by ahel’s review.

Use this skill to turn the current baseline and problem frame into concrete, literature-grounded, testable directions.

When startup_contract.need_research_paper = false and the quest already has a concrete optimization handle, idea may stop after selecting or seeding a direction and then hand off into optimize instead of insisting on the full paper-oriented ideation loop. In that algorithm-first case, idea should usually produce a small method-brief frontier and then defer candidate ranking, promotion, and bounded search to optimize. When doing that handoff, prefer the brief-shaping discipline later used by optimize: clarify the bottleneck and constraints, keep only a small differentiated 2-3 option slate, and hand off a recommended brief rather than a pile of loose intuitions.

Interaction discipline

  • Follow the shared interaction contract injected by the system prompt.
  • For ordinary active work, prefer a concise progress update once work has crossed roughly 6 tool calls with a human-meaningful delta, and do not drift beyond roughly 12 tool calls or about 8 minutes without a user-visible update.
  • Keep ordinary subtask completions concise. When the idea stage actually finishes a meaningful deliverable such as a selected idea package, a rejected-ideas summary, or a route-shaping ideation checkpoint, upgrade to a richer artifact.interact(kind='milestone', reply_mode='threaded', ...) report.
  • That richer idea-stage milestone report should normally cover: the final selected or rejected direction, why it won or lost, the main remaining risk, and the exact recommended next stage or experiment.
  • That richer milestone report is still normally non-blocking. If the next experiment or route is already clear from durable evidence, continue automatically after reporting instead of waiting.
  • If the runtime starts an auto-continue turn with no new user message, keep advancing from the active requirements and current durable state instead of re-answering the previous user turn.
  • Message templates are references only. Adapt to the actual context and vary wording so updates feel natural and non-robotic.
  • If a threaded user reply arrives, interpret it relative to the latest idea progress update before assuming the task changed completely.

Stage purpose

The idea stage should not generate vague inspiration. It should produce executable hypotheses tied to:

  • the active baseline
  • the current codebase
  • the accepted evaluation contract
  • the strongest relevant prior work

This stage is not just "brainstorming". It is the research-direction selection stage. It still needs a bounded creative-divergence phase before convergence. Do not collapse onto the first plausible route just because it sounds implementable. It should normally create a new candidate direction branch and node; it does not by itself decide the next optimization round. The output must survive three checks at once:

  • novelty or at least clear research value
  • feasibility in the current repo and resource budget
  • manuscript defensibility if the line later becomes a paper claim

When the route already looks likely to become a paper-facing line, seed one lightweight structured outline candidate during idea work. Use artifact.submit_paper_outline(mode='candidate', ...) for that seed instead of leaving the future paper structure only in prose. Use references/outline-seeding-example.md for the minimum acceptable shape. The idea-stage outline candidate is not the full paper line yet, but it should already name the likely research_questions, experimental_designs, and the first section-level evidence needs that later supplementary slices must satisfy. Keep that seed minimal and executable: a small section skeleton plus expected evidence items is better than a long narrative outline with no concrete evidence hooks. If the current research head, strongest measured branch, or active runtime refs are unclear after resume, call artifact.get_quest_state(detail='summary') and artifact.list_research_branches(...) before choosing a foundation. If the current brief / plan / status wording matters for direction choice, call artifact.read_quest_documents(...). If earlier user conversation materially changes the direction-selection target, call artifact.get_conversation_context(...) before locking the next idea.

Finishing one idea deliverable is not quest completion. After reporting a completed idea package, continue into the next justified stage unless a real blocking decision is still unresolved.

When the quest disables research-paper delivery, keep manuscript defensibility secondary to:

  • algorithmic value
  • feasibility
  • clean experimental follow-through
  • durable recording of why this direction should be the next measured attempt

Before starting a genuinely new round, default to the current research head as the foundation. However, you may deliberately choose a different foundation when the durable evidence says it is better. When the best starting point is not obvious, inspect artifact.list_research_branches(...) first and compare:

  • current head
  • baseline foundation
  • strongest recent measured branch
  • older but cleaner branch

If you do not use the default current head, record the reason explicitly in the new idea submission. Treat a newly accepted branch as one durable research round. If the active branch already has a durable main-experiment result and you are starting a genuinely new optimization round, prefer creating a child branch from the chosen foundation rather than revising the old branch in place.

At the direction level, prefer elegant algorithmic or theoretical improvements over brute-force cost-for-performance tradeoffs whenever possible.

This stage should preserve the strongest old DeepScientist direction-selection logic:

  • understand the baseline and its failure modes
  • search related work broadly before claiming an idea is good
  • derive limitations
  • produce a compact set of candidate ideas from an explicit direction set
  • rank them with explicit tradeoffs
  • choose a direction with a clear evidence-based decision path
  • ensure the selected direction is manuscript-defensible rather than merely implementation-plausible

Use a compact search discipline during ideation:

  • first identify the current strongest line from existing results, literature, and branch history
  • treat that line as the current incumbent
  • keep only a small serious frontier, usually 2-3 serious alternatives and rarely more than 5 after one bounded widening pass
  • ensure the frontier is meaningfully differentiated rather than the same idea renamed
  • prefer selecting from existing evidence over expanding the candidate list indefinitely

Candidate sets should usually cover some mix of:

  • a strong local refinement of the incumbent
  • an orthogonal alternative that addresses the same bottleneck differently
  • a cleaner or more defensible route with lower conceptual complexity

Do not default to “run a small experiment and see” as the way to break ties. Break ties primarily through careful reasoning over:

  • existing experiment results
  • failure patterns
  • related-work overlap
  • code-path feasibility
  • claim defensibility

Non-negotiable rules

  • Do not claim novelty without a written related-work comparison.
  • Do not select an idea before checking whether close prior work already did it.
  • Do not confuse "I can implement this" with "this is a publishable or useful research direction".
  • Do not treat a weak literature search as sufficient because the idea sounds elegant.
  • Do not write, promote, or submit a final idea until the durable survey covers at least 5 and usually 5-10 task-modeling-related, mechanism-relevant, or otherwise directly usable papers.
  • Treat that literature floor as a hard gate, not a suggestion. If the direct task-modeling neighborhood truly contains fewer than 5 usable papers, record that evidence explicitly and fill the remaining slots with the closest adjacent papers whose mechanism can be translated into the current task and codebase.
  • Algorithm-first exception:
    • when startup_contract.need_research_paper = false and a concrete optimization handle already exists, you may stop after a memory sweep plus a small targeted paper check instead of satisfying the full 5-10 paper floor
    • use that exception only when the immediate goal is method-brief selection for optimize, not paper-level novelty claims
    • if you use the exception, say explicitly that the output is an optimization brief frontier rather than a paper-ready idea package
    • still shape that frontier deliberately: clarify the bottleneck and comparability boundary first, keep a differentiated 2-3 candidate slate, and explain why one brief is recommended now
  • Every fresh idea build or idea-refinement pass must begin with:
    • a memory sweep, and
    • an external literature sweep.
  • Every fresh or resumed idea pass must update artifacts/idea/literature_survey.md or an equivalent durable survey report before a direction is promoted.
  • Every survey update must explicitly separate:
    • reused prior survey coverage
    • newly added papers or comparisons from this pass
    • still-missing or unresolved overlaps
  • When a web/search tool is available, actively use it. Prefer web search for paper discovery, usually targeting arXiv first, then expand with citation and open-web search for neighborhood coverage.
  • When a concrete arXiv paper needs to be read, compared, or summarized, use artifact.arxiv(paper_id=..., full_text=False). Keep search in web discovery; use artifact.arxiv(...) for reading shortlisted papers, and set full_text=True only when needed.
  • Before opening a broad new search, check quest and global memory with memory.search(...) and reuse existing paper notes, idea notes, and knowledge cards.
  • Search for genuinely missing, newly relevant, or more recent papers whenever possible. Do not rerun the same broad search without stating what gap the new search is meant to close.
  • Do not introduce a new dataset or a new evaluation regime unless the quest scope explicitly changed.
  • Do not rely on human evaluation or subjective assessment for idea validation; the eventual experiment must remain automatable with code and accepted metrics.
  • Treat ideation as read-heavy and write-light: inspect code and papers, but avoid substantial implementation during this stage.
  • Do not propose directions that require new datasets.
  • Do not default to brute-force engineering escalation when a cleaner first-principles direction is available.
  • Do not keep generating more ideas once a small, clearly ranked frontier already exists.
  • Do not treat superficial variation as a new idea if the expected mechanism and evidence burden are effectively unchanged.
  • Separate generation from evaluation during ideation: generate first, judge second.
  • Start each fresh ideation pass by classifying the current framing as problem-first or solution-first.
  • Unless strong durable evidence already narrows the route to one obvious serious option, run one bounded divergent pass that produces a small but meaningfully varied slate, usually 6-12 raw ideas before collapsing to a serious frontier that is usually 2-3 and at most 5.
  • If all surviving candidates belong to the same mechanism family, widen once with at least two new ideation lenses before converging.
  • Keep structurally coherent rejected ideas in a parking-lot or rejected-candidate section so they can be recombined later if needed.
  • In algorithm-first work, idea should usually produce direction families, not a large within-family variant swarm.
  • Treat within-family micro-variants as optimize brief work unless the mechanism family itself is still unresolved.
  • Every serious candidate must answer why now? or what changed?, not just what is the mechanism?
  • Every selected idea must survive a two-sentence pitch and strongest-objection check before promotion.
  • Do not promote a direction unless you can explain:
    • what limitation it targets
    • why prior methods do not already solve it
    • what evidence would later be needed to defend the claim
  • When the likely next route is a paper-facing main experiment plus analysis package, do not stop at prose-only idea notes; seed the likely research_questions, experimental_designs, and per-section evidence needs in the outline candidate.
  • If the likely route already has a clear paper-facing structure, seed the future paper line early:
    • identify the likely main-text sections
    • identify which sections will need supplementary evidence rather than only the main run
    • identify the concrete evidence items that must later be maintained in the paper line's outline folder or compiled outline contract
  • If the idea is not novel but still worth doing, state that honestly as:
    • replication value
    • transfer-to-new-setting value
    • stronger evidence on an unresolved question
    • negative-result value
    • infrastructure/platform value

Use when

  • the baseline is ready
  • the task and metric contract are already clear
  • the quest needs a concrete research direction
  • the current idea line failed and a new direction is needed

Do not use when

  • the baseline gate is unresolved
  • the quest still lacks basic problem framing
  • the next step is obviously a write-up or finalization rather than ideation

Preconditions and gate

Before ideation, confirm:

  • there is an active or accepted baseline
  • the dataset and metric contract are explicit
  • the relevant code path and papers are available
  • the strongest obvious related-work cluster can be searched from available references and tools

If these are still unclear, route back to baseline or scout.

Companion skill rule

idea is the anchor skill for direction selection. However, when the quest still needs literature grounding or novelty checking, actively open scout as a companion skill before final idea selection.

In practice:

  • use scout to expand the paper set, search adjacent methods, and clarify the baseline landscape
  • use idea to convert that landscape into limitations, candidate directions, and a selected idea

Do not skip the scout pass just because the quest is already in the idea stage.

Direction-shaping protocol

Use references/idea-thinking-flow.md when the main need is better reasoning hygiene. Use references/idea-generation-playbook.md when the main need is to create a new idea slate and select one clear next research object.

Default creation flow for a fresh idea pass:

  1. frame one concrete limitation
  2. separate symptom / mechanism hypothesis / consequence
  3. keep one main hypothesis plus 2-3 competing hypotheses
  4. name the primary lever bucket
  5. generate a bounded candidate slate from that framing
  6. record selected / deferred / rejected outcomes explicitly

Set the frontier width with a validation-cost estimate before widening:

  • fast-check: the first objective validation loop is likely under about 20 minutes
  • slow-check: the first objective validation loop is likely over about 20 minutes or otherwise expensive in compute, queue time, or human delay

For fast-check idea work:

  • allow a slightly wider serious slate when the candidates are meaningfully different
  • prefer candidates with cheap, orthogonal falsification paths
  • keep more alternatives alive into optimize because validation is cheaper than overthinking

For slow-check idea work:

  • keep the serious slate tighter, usually 1-3
  • demand a clearer bottleneck story and stronger evidence before adding another family
  • prefer the route with the best expected evidence-per-run, not the route with the most speculative upside
  • do not hand off a broad speculative slate just because it sounds interesting

Do not start by shopping for modules to add. Do not let one attractive mechanism become the de facto framing before the limitation is pinned down. Do not let direction-family ideation collapse into within-family variant generation too early.

In normal idea work, stop at the direction-family level:

  • select which mechanism families deserve serious consideration
  • identify the strongest one to carry forward
  • hand off within-family brief shaping to optimize when the quest is algorithm-first

If the task still requires choosing among mechanism families, stay in idea. If the family is already chosen and the next need is branchless method-brief shaping, hand off to optimize.

Truth sources

Use:

  • baseline artifacts and verification notes
  • baseline paper and source repo
  • current codebase and recent diffs
  • scout notes and paper memory cards
  • prior failed runs and decisions
  • current task constraints
  • quest and global memory cards returned by memory.list_recent(...) and memory.search(...)
  • prior literature survey reports and related-work artifacts
  • web-search discovery results for arXiv and related sources
  • paper-reading notes produced after using artifact.arxiv(...)
  • citation trails and open-web search results for nearby work
  • citation trails from the baseline paper and strongest nearby papers
  • recent papers that share the same task, metric, dataset, mechanism, or bottleneck

Do not rank ideas on style alone. Rank them on evidence, feasibility, and testability.

Related-work and novelty mandate

Before you choose a direction, perform a broad but bounded literature sweep.

The sweep must be grounded in actual retrieval, not recall alone. If durable quest memory already contains a recent and explicit survey, reuse it first and search externally only for the missing buckets, newer papers, or unresolved overlaps. For a normal selected-idea decision, the durable sweep must end with at least 5 and usually 5-10 papers that are close enough to the task-modeling problem, failure mode, mechanism, or codebase translation question to inform the actual design. This floor exists to prevent thin novelty claims and under-motivated ideas, not to reward quota chasing.

When tools allow it, combine:

  • memory.search(...) and recent memory reads
  • web search for arXiv and adjacent sources
  • artifact.arxiv(paper_id=..., full_text=False) for actually reading shortlisted papers
  • citation expansion or open-web search for follow-up papers, code, and comparisons

The sweep should cover at least these search angles:

  • direct same-task / same-dataset / same-metric competitors
  • methods using the same mechanism or main lever you are considering
  • papers targeting the same failure mode or bottleneck
  • strong recent papers that may have closed the gap already

When the direct neighborhood looks saturated or too incremental, extend the sweep to adjacent conceptual neighborhoods:

  • optimization methods targeting the same instability or objective mismatch
  • representation-learning methods targeting the same information bottleneck
  • signal-processing, geometry, probabilistic, or control-inspired methods addressing an analogous failure mode
  • methods from neighboring tasks that solve the same structural problem under a different surface form

The point is principled translation, not superficial import. Borrow the core mechanism or mathematical idea only if you can explain why it should survive translation into the current codebase and metric contract.

For each promising idea, you must be able to answer:

  • which papers are the closest prior art?
  • what exactly is the overlap with your proposed mechanism?
  • what is still missing, weak, or untested in those papers?
  • if they already did most of it, why is this still worth pursuing?

The goal is not to cite everything on Earth. The goal is to avoid fake novelty and to identify a direction that has credible research value. However, do not stop the sweep early once the first plausible argument appears. Keep going until the strongest obvious overlaps are mapped and the 5-10 usable-paper floor is durably satisfied.

Recommended search outputs:

  • a compact related-work map
  • a closest-prior-work table
  • a novelty / value verdict for each serious candidate
  • a paper bucket split:
    • core papers
    • closest competitors
    • adjacent inspirations
    • watchlist / uncertain relevance

For a more detailed search and triage method, read references/related-work-playbook.md.

If the search is still too thin to support a novelty or value judgment, the idea stage is not ready to end.

Required durable outputs

The idea stage should usually leave behind:

  • a limitations analysis
  • a literature survey report
  • a survey-delta section that marks:
    • reused findings
    • newly retrieved papers this pass
    • unresolved gaps or watchlist items
  • a related-work map
  • a novelty and research-value audit
  • 2-5 candidate ideas, with the final serious frontier usually narrowed to 2-3
  • a selected idea or explicit rejection of the current line
  • a durable Markdown idea draft that is finalized before the accepted idea is submitted
  • one or more memory cards for reusable rationale
  • one or more quest papers cards for the strongest papers or search clusters
  • an idea artifact and a decision artifact

Recommended durable intermediate outputs:

  • an outline-style direction note with:
    • executive summary
    • current baseline results and metric direction
    • codebase analysis
    • dataset analysis
    • mathematical problem formulation
    • baseline methods as special cases
    • five actionable research directions
    • evaluation metrics and success criteria
    • infrastructure and constraint notes
    • claim boundary

When producing a fuller research-outline style note, prefer a direct-agent-like structure:

  • Executive Summary
  • Codebase Analysis
  • Limitations / Bottlenecks
  • KPIs
  • Research Directions
  • Risks & Mitigations

Do not force this structure for every tiny ideation turn, but use it when the quest needs a serious research-plan artifact.

Recommended durable files:

  • artifacts/idea/literature_survey.md
  • artifacts/idea/related_work.md
  • artifacts/idea/limitations.md
  • artifacts/idea/candidates.md
  • artifacts/idea/selected_idea.md
  • artifacts/idea/research_outline.md

When producing the literature survey report, prefer the structure in references/literature-survey-template.md.

When producing a full research-outline style note, prefer the detailed structure in references/research-outline-template.md.

When the runtime supports durable knowledge cards, also preserve:

  • incident or failure-pattern lookups relevant to the mechanism
  • a reusable knowledge card for the selected idea hypothesis

Thinking protocol

Use the old PI discipline here too. Your analysis should be:

  • hypothesis-driven: viewpoint first, evidence second
  • pyramid-shaped: conclusion first, then reasons, then action
  • MECE where possible:
    • data
    • model
    • objective
    • optimization or training dynamics
    • inference
    • evaluation protocol
    • infrastructure
  • SCQA-compatible:
    • situation
    • complication
    • research question
    • answer hypothesis plus 2-3 competing hypotheses

Do not dump disconnected observations. Turn them into a direction argument.

For a more explicit end-to-end reasoning sequence, read references/idea-thinking-flow.md.

Creative-divergence protocol

Use deliberate ideation lenses before convergence when the route is not already obvious from durable evidence. The point is not uncontrolled brainstorming. The point is to widen the search just enough to avoid premature convergence onto the first implementable idea.

Shortened here. Read the whole file on GitHub.

Signals

GitHub stars
1k
Forks
119
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
ds-idea
Source
github.com/openlair/dr-claw