idea

Imported from Rycen7822/Kvasir-agent (kvasir_agent/runtime/resources/repo/src/skills/idea/SKILL.md). Install upstream with npx skills add Rycen7822/Kvasir-agent --skill idea. Copyright stays with the author.

Idea

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 ka_artifact_record payload={'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 Kvasir-agent 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 research-history review 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 research-history review, 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, inspect existing paper notes, idea notes and research records.
• 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 notes
• prior failed runs and decisions
• current task constraints
• existing paper notes, idea notes and research records
• 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 project research records 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:

• existing research records and recent experiment history
• 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 research notes for the idea 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.

This divergence protocol does not replace the main workflow below. It sits inside the main workflow after minimum grounding already exists from research-history review, initial literature sweep, baseline reconstruction, and limitation analysis. If strong durable evidence already narrows the route to one obvious serious option, you may abbreviate the full widening pass, but you must record why a broader divergence pass was unnecessary.

First classify the current entry frame:

• problem-first:
  • start from a concrete failure, bottleneck, or unmet need
  • confirm who suffers, how much it matters, and why the problem is still open
• solution-first:
  • start from a new capability, mechanism, or transfer idea
  • confirm at least two genuine problems it could solve and why this is not just a hammer looking for a nail

Then choose at least 2-4 ideation lenses that are actually relevant to the current bottleneck. Good default lenses include:

• abstraction ladder:
  • move up to a broader principle
  • move down to an extreme constrained case
  • move sideways to an adjacent task with the same structure
• tension or contradiction hunting:
  • identify tradeoffs such as performance vs efficiency, safety vs capability, or generality vs specialization
• why now / what changed:
  • ask whether new compute, tooling, open models, benchmarks, failures, or regulations make an old direction newly viable
• analogy transfer:
  • borrow a structural mechanism from a nearby or distant field only when the mapping is causal, not metaphorical
• constraint manipulation:
  • list hard, soft, and hidden constraints, then relax, tighten, or replace the soft or hidden ones
• negation or inversion:
  • negate a widely assumed design rule and check whether the resulting system is coherent
• composition / decomposition:
  • combine two complementary components or separate a monolithic method into the real bottleneck pieces
• adjacent possible:
  • focus on directions that became feasible only because recent enablers now exist
• stakeholder rotation:
  • inspect the route from the end-user, developer, theorist, operator, regulator, or adversary perspective
• simplicity test:
  • ask whether the key contribution survives a simpler and cleaner mechanism

During this divergent phase:

• generate a compact but varied raw slate, usually 6-12 ideas
• do not score them too early
• force the slate to contain some diversity, usually:
  • one conservative route
  • one higher-upside route
  • one elegance-first or low-complexity route
• keep a parking-lot list for coherent rejects and odd-but-possible ideas

For each raw idea, capture at least:

• one-sentence hypothesis
• target limitation
• why now / what changed
• likely closest prior overlap or novelty risk
• whether it is conservative, higher-upside, or elegance-first

Only after this bounded widening step should you collapse into the shortlist that will be scored seriously.

Framework selection guide

Do not use every ideation lens on every quest. Pick the smallest set that breaks the current local optimum.

Recommended defaults:

• if the area is important but the concrete route is still vague:
  • start with tension hunting plus why now / what changed
• if you have a vague bottleneck but only incremental ideas:
  • start with abstraction ladder plus failure or boundary probing
• if you have a cool mechanism but no strong reason to care:
  • start with the problem-first check plus stakeholder rotation
• if every candidate feels like a small benchmark tweak:
  • start with constraint manipulation plus negation or inversion
• if every candidate is a near-clone of the incumbent:
  • start with analogy transfer plus adjacent possible
• if you are stuck between two paradigms that seem opposed:
  • start with contradiction hunting and look for synthesis instead of compromise
• if the route looks elegant but suspiciously complex:
  • start with the simplicity test and force the minimum viable mechanism
• if timing is the main uncertainty:
  • start with the why now audit and adjacent-possible check

The goal is not to sound creative. The goal is to produce candidate mechanisms that are genuinely different in logic, evidence burden, or timing rationale.

Integrated ideation workflow

Use this end-to-end pattern when the route is not already forced by durable evidence. Treat it as a subroutine inside the main workflow, not as a replacement for the main workflow order.

Phase A. Diverge

Goal:

• create a compact but meaningfully varied slate before judging winners

Precondition:

• minimum grounding already exists from project research records, an initial literature sweep, baseline reconstruction, and a current limitations map

Recommended sequence:

1. classify the current entry as problem-first or solution-first
2. list the top bottlenecks, tensions, and what changed recently
3. probe one or two failure boundaries of the incumbent
4. apply 2-4 ideation lenses
5. generate 6-12 raw ideas and keep a parking-lot list for coherent rejects

During divergence:

• do not rank too early
• do not kill an idea only because it is unusual
• do kill ideas that are incoherent, outside scope, or impossible in the current repo

Phase B. Converge

Goal:

• reduce the raw slate to a serious frontier that is usually 2-3 candidates and at most 5

Apply these filters:

• explain-it test:
  • can the idea be stated clearly in two sentences?
• problem-value test:
  • does the problem matter to a real reader, user, or evaluator?
• why now test:
  • is there a concrete reason this route is timely now rather than three years ago?
• simplicity test:
  • is the mechanism doing real work, or is it ornamental complexity?
• feasibility test:
  • can the current repo and resource budget test this honestly?
• novelty or value test:
  • even if not novel, is the line still worth doing for transfer, negative-result, or infrastructure value?

If the shortlist is still homogeneous after convergence, return to Phase A with different lenses once.

Phase C. Refine

Goal:

• turn the winning candidate into a stable handoff contract for experiment

Before promotion, force the winner to answer:

• what exact limitation it targets
• why current methods still fail here
• what changed or why this is timely now
• what the smallest credible implementation is
• what the cheapest falsification path is
• what the strongest likely objection is
• what the two-sentence pitch is

Only then move into the normal selection gate and artifact.submit_idea(...) flow.

Common ideation failure modes and recovery moves

Watch for these predictable failures:

• premature convergence:
  • symptom: the first plausible route becomes the winner before a real alternative set exists
  • recovery: reopen divergence with at least two different lenses
• novelty without value:
  • symptom: "nobody has tried this" is doing all the work
  • recovery: run the problem-value test and stakeholder rotation
• value without differentiation:
  • symptom: the route matters, but close prior work already did most of it
  • recovery: tighten the related-work map or route back to scout
• complexity worship:
  • symptom: the candidate has many moving parts but weak causal justification
  • recovery: run the simplicity test and reduce to the smallest mechanism that could still work
• analogy by metaphor:
  • symptom: a cross-domain import sounds clever but the mechanism does not really map
  • recovery: rewrite the analogy in causal language and reject it if the structure does not survive
• stale assumptions:
  • symptom: the team dismisses a route only because it failed under old constraints
  • recovery: run the what changed audit explicitly
• false binary:
  • symptom: discussion gets stuck on choosing A or B
  • recovery: ask whether the conflict is fundamental or an artifact of current formulations
• adjacent-but-impossible:
  • symptom: the route is interesting but needs assets or capabilities the current system does not have
  • recovery: redesign around current constraints or reject honestly instead of hand-waving feasibility

Use these recovery moves early. Do not wait until the selection gate to discover the whole ideation pass was trapped in the wrong mode.

Workflow

1. Lock the success target and contribution frame

Before generating ideas, state:

• the primary metric and whether higher or lower is better
• the strongest baseline number with source path
• the expected contribution type:
  • Insight
  • Performance
  • Capability
• the problem importance in one sentence
• the main challenge or bottleneck in one sentence
• whether the direction is emerging, stable, or late relative to the current literature wave
• the risk that the direction is valuable but may still be under-recognized
• one sentence for the intended increment over the strongest baseline
• what new knowledge the reader would gain if this line works

If the metric, baseline value, or contribution frame is unclear, stop and clarify before ideation.

1.1 Plan the ideation investigation

Before deep searching, write a compact plan for:

• which limitation or bottleneck you are investigating first
• which literature buckets you will search
• which evidence would validate or refute your current hypothesis
• which prior ideas, findings, or failed attempts must not be duplicated blindly
• whether the current framing is problem-first or solution-first, and why that framing is justified
• a short first-principles memo explaining what you currently believe before you let the literature reshape that belief

The plan does not need to be long. It does need to make the search strategy explicit.

2. Run the related-work sweep

Search broadly enough to cover the strongest obvious competitors and neighboring methods.

Use the runner's search tooling actively. When available, use web search for discovery, often targeting arXiv first, then use citation or broader web search to expand the closest-neighbor cluster.

At minimum, inspect:

• the baseline paper references
• papers cited by the closest prior methods
• papers that cite the baseline or core method, when available
• recent papers on the same task, dataset, metric, or failure mode
• implementation repositories for the strongest nearby methods, when relevant

Keep a compact search ledger while you work. For each meaningful search query or paper cluster, record:

• query text
• source, such as research records, arXiv, or open web
• why you issued the query
• which papers were newly added
• which previously known papers were re-confirmed
• which gaps remain after this pass

Do not treat the search ledger as optional prose. It is the durable reason why the next idea pass should search only the remaining gaps instead of restarting broad discovery from zero.

For the shortlist of closest papers, record:

• paper identifier and year
• core mechanism
• task / dataset / metric overlap
• what claim it already supports
• what gap, weakness, or open edge remains
• whether it reduces the novelty of your candidate

Search guidance:

• prefer recent work when the area is moving quickly, especially 2023-2027
• do not ignore older seminal papers if they are the real origin of the idea
• use purpose-driven search rather than quota-chasing
• repeat the search multiple times with refined queries when novelty or motivation remains uncertain
• when resuming idea work, start from the latest survey report and search only for the still-missing neighborhood or newer papers

At the start of the sweep, classify the challenge type in one sentence, for example:

• information bottleneck
• optimization instability
• weak inductive bias
• noisy supervision
• poor calibration
• brittle inference procedure

Then use that abstraction to widen the search. This prevents the stage from staying trapped in only same-keyword literature when the deeper mechanism may have better inspirations elsewhere.

Cross-domain exploration is allowed and encouraged when it sharpens the idea. Map the failure type to 2-3 adjacent domains when useful, such as:

• optimization
• information theory
• signal processing
• statistical learning
• systems or inference engineering

Look for principles that can be translated into the current codebase, not copied blindly.

Do not stop at one or two papers if the area is active. Keep going until the strongest obvious overlaps are mapped.

Also compare against prior quest ideas and findings when they exist:

• avoid rediscovering an already rejected line without new evidence
• explain how the current candidate differs from prior attempts
• explicitly note if the new direction is a refinement, branch, or replacement

3. Reconstruct the baseline line

State clearly:

• what the baseline does
• what assumptions it depends on
• where it appears to fail
• which metrics matter most
• what resource or repository constraints matter

Also identify concrete code touchpoints:

• train or eval entrypoints
• dataset loaders and preprocessing
• model, loss, and metric code
• where a future method difference would actually land

For each serious baseline method, also rate improvement potential as:

• HIGH
• MEDIUM
• LOW

and justify the rating from:

• algorithmic flexibility
• implementation complexity
• coupling or maintainability constraints
• room for principled extension

4. Produce a limitations map

List the most decision-relevant limitations, such as:

• obvious architectural bottleneck
• error concentration on a known case type
• mismatch between objective and evaluation metric
• weak robustness
• compute or efficiency bottleneck
• missing information flow or representation quality

Do not confuse random inconveniences with true research limitations.

The limitations map should be concrete enough that each top limitation can support one falsifiable research question.

For each top limitation, also record:

• why it matters for the main metric
• what evidence currently supports it
• whether it is likely a data, model, objective, optimization, inference, evaluation, or infrastructure issue
• 2-4 concrete root-cause hypotheses

5. Add mathematical and mechanism framing

Where possible, express the baseline as a concrete optimization or algorithmic object rather than only prose.

For each serious line, state:

• the baseline as a special case or constrained version
• what assumption or constraint may be hurting performance
• what relaxation, extension, or alternative information flow might help
• what competing hypothesis could explain the same problem

Also decompose the broader research problem into 3-5 sub-problems when useful, so later experiments can target them separately.

This step is important because it prevents superficial "just add module X" ideation.

5.1 Run a bounded creative-divergence pass

Before ranking or narrowing, deliberately widen once unless strong durable evidence already makes one serious route obviously dominant. If you skip the full widening pass, record why.

• produce 6-12 raw ideas unless the search space is genuinely tiny
• use at least 3 distinct ideation lenses unless the route is already forced by evidence
• include at least one failure-centric lens and one mechanism-centric lens
• if the first slate is all from one mechanism family, widen again with at least 2 different lenses

At this stage, clarity matters more than polish. Each raw idea should at least answer:

• what limitation it targets
• what the mechanism is
• why now / what changed
• what the likely closest overlap is
• what kind of route it is:
  • conservative
  • higher-upside
  • elegance-first

Do not confuse this widening pass with final selection. Its purpose is to ensure the later shortlist contains genuinely different options rather than renamed variants.

6. Generate direction options first, then candidate ideas

After the bounded divergent pass, or after explicitly recording why it was unnecessary, derive exactly five actionable research directions whenever the space is not already tiny. Rank them from higher to lower expected return on investment.

For each direction, specify:

• targeted limitation
• problem plus solution approach
• key discipline and technique
• code-level implementation sketch
• metrics to watch and success threshold
• abandonment criteria
• risks and confounders
• reader-facing takeaway
• defensibility evidence package

At the direction stage, these should remain exploration directions rather than full implementation plans. Favor directions that:

• solve the core insufficiency more elegantly
• avoid unnecessary complexity or compute cost
• fit the existing architecture
• create genuinely differentiated research value

When possible, make the direction-generation step explicitly two-layered:

1. abstract direction:
   • the core conceptual thrust
   • the first-principles rationale
   • why it is more elegant than brute-force scaling
2. repo-grounded translation:
   • where it could land in the current codebase
   • what the smallest meaningful implementation would be
   • what evidence would falsify it quickly

Then reduce to a compact 2-5 candidate set for actual selection. When operating in a tightly scoped idea assignment, prefer converging to one final idea rather than dumping many half-baked options.

When the search space is not tiny, try to preserve diversity in the final candidate set:

• one conservative or low-risk line
• one higher-upside line
• one elegance-first line with low engineering burden

If all surviving candidates are minor variants of the same mechanism family, widen the search once before converging.

When the quest needs a stronger strategist-style ideation pass, prefer a two-layer direct-agent framing for each direction:

1. conceptual thrust
   • one memorable abstract phrase
2. first-principles rationale
   • why the direction should work from mathematical, algorithmic, or logical reasoning
3. path to an elegant solution
   • why it is better than brute-force scaling or expensive engineering
4. innovation factor
   • what appears genuinely unexplored or underexplored
5. research value justification
   • why the direction should score well on usefulness, quality, or exploration value
6. optional cross-domain inspiration
   • where the idea borrows its structural intuition, if relevant

For each candidate idea, specify:

• mechanism
• expected gain
• main risk
• required files or components
• likely metric effect
• cheapest falsification path
• strongest competing hypothesis
• closest prior work and novelty / value verdict
• whether it overlaps too much with prior quest ideas or prior failed findings

Treat each serious candidate as a compact decision package, not a slogan. For every candidate that survives initial triage, make sure you can state:

• target limitation
• why current methods still fail here
• the smallest credible implementation surface in the current repo
• the primary metric that would matter first
• the cheapest falsification path
• the abandonment condition
• the reader-facing payoff if it works
• the exact reason it is still worth trying despite the closest prior work

When possible, also specify:

• why current methods fail on this point
• reader-facing takeaway if the direction works
• minimum defensibility evidence package needed later for writing

Prefer ideas that can be tested in the current repo with minimal ambiguity. If a candidate requires a large refactor, call that out explicitly and propose a smaller variant.

7. Score the candidates

Score each candidate along explicit axes:

• relevance to the limitation
• feasibility in the current codebase
• expected upside
• clarity of the two-sentence pitch
• falsifiability
• implementation cost
• evaluation clarity
• risk of confounding
• novelty headroom
• research value even if not fully novel
• expected information gain
• reusability as a platform capability
• why now credibility

Also keep a compact strategist-style score lens when useful:

• utility_score
• quality_score
• exploration_score

If these are used, explain the scores in prose rather than treating them as magic numbers. Use them as a secondary decision lens, not as a substitute for evidence-backed reasoning.

Avoid "best sounding" choices. Prefer the best-explained choice.

If a candidate scores weakly on novelty but strongly on research value, label that explicitly instead of pretending it is novel.

7.1 Lightweight quality gate before selection

Run the final candidate through the quality gate in references/selection-gate.md.

At minimum, explicitly score:

• novelty
• falsifiability
• feasibility
• evidence quality
• constraint fit

Before promotion, also require:

• a two-sentence pitch that a smart non-expert can follow
• the strongest likely objection stated explicitly
• a one-sentence why now statement explaining what changed or why this is timely now

If the total is below 7/10, do not promote the idea yet. Either refine once more or record a blocked / reject decision with the exact weakness.

8. Select, branch, reject, or route back

The idea stage should end with one of:

• a selected idea ready for experiment
• a decision to branch and keep more than one line alive
• a rejection of all current ideas and a return to scout
• a blocked state if the real issue is missing evidence rather than missing creativity

Before selecting, perform a narrative defensibility precheck:

• who is the target reader or evaluator of the claim?
• why should they care?
• what is the one falsifiable research question for this direction?
• what evidence package would be needed later to defend it?
• what is the claim boundary?
• what is the strongest nearby prior work, and what remains differentiating here?
• why is this the highest-leverage direction to invest in now, rather than merely one direction that could work?

If the direction is not defensible even in outline form, do not promote it just because it is implementable.

If multiple directions remain plausible and the choice is materially preference-sensitive, ask the user for a structured decision instead of pretending the tradeoff is objective.

If the real issue is that literature coverage is weak or novelty is uncertain, route back to scout rather than forcing an idea selection.

When the stage reaches a route-shaping outcome, notify the user through ka_artifact_record ...) deliberately:

• use a richer threaded milestone update when a selected idea package, a rejected-ideas summary, or a route back to scout is durably recorded
• the update should name the winner or rejection result, the strongest supporting evidence, the main residual risk, and the exact recommended next stage
• if more than one candidate remains genuinely plausible and preference-sensitive, use reply_mode='blocking' for the user decision instead of pretending the choice is objective

Idea output contract

The selected idea should be recorded in a form that the experiment stage can follow without drift. Use the handoff template in references/selection-gate.md.

At minimum, preserve:

• a stable idea id
• a two-sentence pitch
• a falsifiable claim tied to metric and direction
• a why now statement
• the code-level plan and minimal experiment
• the literature relation and evidence pointers
• inline citations or citation markers tied to the papers actually used in the idea rationale
• a References or Bibliography section in a standard citation format
• the strongest alternative hypothesis
• the strongest likely objection

The selected idea draft must cite the survey papers that actually shaped the mechanism, motivation, novelty check, or claim boundary. Use one consistent standard citation format throughout the draft, such as numbered references or author-year style. Do not mention paper titles casually in prose without giving them a proper citation entry.

Idea quality rules

Good ideas should be:

• literature-grounded
• specific
• executable
• testable
• comparable against baseline
• cheap enough to falsify
• either genuinely novel or clearly research-valuable
• narratively defensible to a real reader
• constraint-compatible with the current dataset and evaluation setup

Weak ideas often look like:

• pure ambition without a mechanism
• a large rewrite without a clean test
• a metric claim without a plausible path to improvement
• a direction that requires a new dataset or evaluation regime without scope approval
• an apparent novelty that collapses after reading nearby papers
• a direction with no clear reader payoff even if it works
• a mechanism borrowed from another domain without translation to this codebase
• an idea that cannot be validated automatically with current metrics
• a brute-force scale-up disguised as a research idea

Novelty and research-value rules

Use the novelty and value labels from references/selection-gate.md.

Do not force every good direction into the novel bucket. But do require every selected direction to land in either:

• novel, or
• incremental but valuable

If it lands in not sufficiently differentiated, reject it or send it back for refinement.

Code-change rule

The idea stage is primarily a planning and reasoning stage.

• avoid large code changes during ideation
• only perform a tiny code or config inspection change if it is necessary to verify feasibility
• if major implementation seems necessary just to understand the idea, that is a sign to stop and sharpen the idea first

Artifact rules

Typical durable records:

• report artifact for the literature survey
• report artifact for related-work mapping
• report artifact for limitation analysis
• idea artifact for one or more candidate directions
• decision artifact for the selected line

Preferred artifact choices:

• use report for:
  • literature survey synthesis
  • survey-delta refresh
  • related-work mapping
  • limitation analysis
  • novelty or value audit
• use idea for:
  • shortlisted candidates
  • the selected direction package
• use decision for:
  • select / reject / branch / return-to-scout outcomes
• use approval when the user explicitly confirms a preference-sensitive choice
• use milestone when ideation hits a meaningful user-visible checkpoint

If the idea is selected and becomes the active route, immediately call artifact.submit_idea(mode='create', lineage_intent='continue_line'|'branch_alternative', ...). Before that call, first finalize a concise but durable Markdown draft for the chosen route. Do not start writing that final draft until the literature survey has already met the hard minimum of at least 5 and usually 5-10 usable papers. That draft should usually cover:

• executive summary
• bottleneck or limitation framing
• whether the route is problem-first or solution-first
• why now / what changed
• closest prior work and overlap
• any cross-domain inspirations worth borrowing
• selected claim
• theory and method
• code-level change plan
• evaluation or falsification plan
• risks, caveats, and implementation notes
• a citation-ready References or Bibliography section that lists the survey-stage papers actually used by the idea in a standard citation format

Use the draft to think clearly first, then compress the accepted contract into the structured artifact.submit_idea(...) fields. When the native runtime surface supports it, pass the final Markdown draft through draft_markdown so the branch records both idea.md and draft.md. Ensure the final draft carries appropriate citations for the closest prior work, direct inspirations, and any cross-domain papers that materially shaped the selected idea. Normal durable idea flow should create a new branch and a new canvas node every time an accepted idea package changes meaningfully, including documentation-only idea-package changes. Use lineage_intent='continue_line' when the new idea is a child of the current active branch. Use lineage_intent='branch_alternative' when the new idea should branch from the current branch's parent foundation as a sibling-like alternative. artifact.submit_idea(mode='revise', ...) is maintenance-only compatibility for the same branch and should not be the normal research-route mechanism. Do not prefer artifact.submit_idea(...) for the normal idea-selection path.

Do not record a final selected-idea artifact without first recording a literature survey report.

Failure and blocked handling

If ideation stalls, record why:

• baseline is still too uncertain
• evaluation contract is under-specified
• code path is unclear
• candidate ideas are too confounded to rank safely
• user preference is required for the tradeoff
• related-work coverage is still too weak to judge novelty or value
• closest prior work already invalidated the strongest candidate

Do not hide blocked ideation behind generic brainstorming text.

Exit criteria

Exit the idea stage once one of the following is durably true:

• one idea is selected and ready for experiment
• several ideas are retained with an explicit branching decision
• the current line is rejected and the quest returns to scout
• the stage is blocked and a clear next decision is recorded

Do not exit this stage with a "selected idea" if:

• the literature survey report is missing
• the related-work map is missing
• the novelty / value verdict is still hand-wavy
• the falsification path is unclear
• the experiment handoff contract is incomplete

Research records

Review prior ideas, literature surveys and experiment outcomes before proposing a new direction. Preserve selected, deferred and rejected alternatives with rationale in research records. Paper notes should include identifiers, year, URL, task/data/metric overlap, mechanism, novelty caveats and search coverage or unresolved gaps.