Skill Tracer
Skills › Scientific Agent Skills › scientific-brainstorming › idea_evaluation.md

idea_evaluation.md

307 lines · skills/scientific-brainstorming/references/idea_evaluation.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Transparent Idea Evaluation
2
3Evaluation narrows a candidate set; it does not convert ideas into evidence.
4Use explicit criteria, independent ratings, uncertainty, qualitative review,
5adversarial checks, and noncompensatory gates.
6

Transparent Idea Evaluation

Evaluation narrows a candidate set; it does not convert ideas into evidence. Use explicit criteria, independent ratings, uncertainty, qualitative review, adversarial checks, and noncompensatory gates.

Raw lines 1 to 6
7## Define criteria before viewing scores
8
9For every criterion record:
11- name and decision relevance;
12- direction (`higher` or `lower`);
13- observable anchors for the minimum, midpoint, and maximum;
14- weight and who set it;
15- evidence required for a rating;
16- uncertainty representation;
17- conflicts or overlap with other criteria.
19Possible criteria include information gain, ability to distinguish mechanisms,
20importance to stakeholders, feasibility, reversibility, novelty relative to a
21documented search, methodological rigor, cost, time, equity, safety, and
22dual-use burden.
24Avoid:
26- “impact” or “quality” without anchors;
27- counting correlated criteria twice;
28- silently converting missing information to a zero;
29- changing weights after seeing which idea wins;
30- averaging away an ethics, safety, regulatory, or feasibility veto.

Define criteria before viewing scores

For every criterion record:

  • name and decision relevance;
  • direction (higher or lower);
  • observable anchors for the minimum, midpoint, and maximum;
  • weight and who set it;
  • evidence required for a rating;
  • uncertainty representation;
  • conflicts or overlap with other criteria.

Possible criteria include information gain, ability to distinguish mechanisms, importance to stakeholders, feasibility, reversibility, novelty relative to a documented search, methodological rigor, cost, time, equity, safety, and dual-use burden.

Avoid:

  • “impact” or “quality” without anchors;
  • counting correlated criteria twice;
  • silently converting missing information to a zero;
  • changing weights after seeing which idea wins;
  • averaging away an ethics, safety, regulatory, or feasibility veto.
Raw lines 7 to 31
32## Rating process
341. Train raters on two neutral examples that are not session candidates.
352. Ask raters to score independently and cite the reason or source.
363. Allow `not assessable` and abstention rather than forced precision.
374. Collect a central score and plausible low/high values when uncertainty is
38 material.
395. Reveal distributions and reasons.
406. Discuss disagreements, then retain both original and revised ratings.
417. Resolve factual errors separately from preference differences.
43Do not report inter-rater agreement as evidence that an idea is correct.
44Agreement can reflect shared information or shared bias.

Rating process

  1. Train raters on two neutral examples that are not session candidates.
  2. Ask raters to score independently and cite the reason or source.
  3. Allow not assessable and abstention rather than forced precision.
  4. Collect a central score and plausible low/high values when uncertainty is material.
  5. Reveal distributions and reasons.
  6. Discuss disagreements, then retain both original and revised ratings.
  7. Resolve factual errors separately from preference differences.

Do not report inter-rater agreement as evidence that an idea is correct. Agreement can reflect shared information or shared bias.

Raw lines 32 to 45
46## Weighted additive matrix
48The bundled `scripts/evaluate_matrix.py` uses a simple, fully disclosed model.
49For criterion \(j\), observed score \(x_{ij}\), minimum \(L_j\), maximum \(U_j\),
50and positive weight \(w_j\):
52- higher-is-better: \(n_{ij}=(x_{ij}-L_j)/(U_j-L_j)\)
53- lower-is-better: \(n_{ij}=(U_j-x_{ij})/(U_j-L_j)\)
54- normalized weight: \(p_j=w_j/\sum_j w_j\)
55- displayed score: \(100\sum_j p_j n_{ij}\)
57This compensatory formula means a high value on one criterion can offset a low
58value on another. Keep hard gates outside the formula.

Weighted additive matrix

The bundled scripts/evaluate_matrix.py uses a simple, fully disclosed model. For criterion \(j\), observed score \(x_{ij}\), minimum \(L_j\), maximum \(U_j\), and positive weight \(w_j\):

  • higher-is-better: \(n_{ij}=(x_{ij}-L_j)/(U_j-L_j)\)
  • lower-is-better: \(n_{ij}=(U_j-x_{ij})/(U_j-L_j)\)
  • normalized weight: \(p_j=w_j/\sum_j w_j\)
  • displayed score: \(100\sum_j p_j n_{ij}\)

This compensatory formula means a high value on one criterion can offset a low value on another. Keep hard gates outside the formula.

Raw lines 46 to 59
Runs code scripts/evaluate_matrix.py :48
60### Criteria configuration
62```json
64 "schema_version": "1.0",
65 "criteria": [
66 {
67 "name": "information_gain",
68 "description": "Ability to discriminate plausible mechanisms",
69 "weight": 3,
70 "direction": "higher",
71 "minimum": 1,
72 "maximum": 5
73 },
74 {
75 "name": "resource_burden",
76 "description": "Relative time, cost, and scarce-resource burden",
77 "weight": 2,
78 "direction": "lower",
79 "minimum": 1,
80 "maximum": 5
81 }
82 ]
84```
86Weights must be explicit, finite, and positive. They need not sum to one; the
87script reports both supplied and normalized values. Criterion names must not
88collide with `idea_id`, `qualitative_review`, `uncertainties`, or another
89criterion's generated `_low`/`_high` columns. Scale widths must be finite.

Criteria configuration

{
  "schema_version": "1.0",
  "criteria": [
    {
      "name": "information_gain",
      "description": "Ability to discriminate plausible mechanisms",
      "weight": 3,
      "direction": "higher",
      "minimum": 1,
      "maximum": 5
    },
    {
      "name": "resource_burden",
      "description": "Relative time, cost, and scarce-resource burden",
      "weight": 2,
      "direction": "lower",
      "minimum": 1,
      "maximum": 5
    }
  ]
}

Weights must be explicit, finite, and positive. They need not sum to one; the script reports both supplied and normalized values. Criterion names must not collide with idea_id, qualitative_review, uncertainties, or another criterion's generated _low/_high columns. Scale widths must be finite.

Raw lines 60 to 90
91### Scores CSV
93```csv
94idea_id,information_gain,information_gain_low,information_gain_high,resource_burden,resource_burden_low,resource_burden_high,qualitative_review,uncertainties,evidence_status,ethics_status
95I001,4,3,5,3,2,4,"Distinguishing prediction is clear","Assay performance unknown",search-incomplete,review-required
96I002,3,2,4,2,2,3,"Lower burden but less discriminating","Population transfer uncertain",mixed,not-assessed
97```
99Required columns are `idea_id`, every configured criterion,
100`qualitative_review`, and `uncertainties`. Low/high columns are optional but
101must appear as pairs and contain `low <= score <= high`. Extra columns are
102preserved as qualitative context.
104Missing central scores, including abstentions, are rejected. Keep them in the
105session record and defer the comparison or document a separate complete-case
106matrix; never impute zero or drop a criterion silently. Missing or jointly blank
107bounds hold the central rating fixed only for calculation. The output records
108`bounds_supplied` per criterion, lists `criteria_without_uncertainty_bounds`,
109and warns that this does not imply certainty. Even fully supplied bounds are
110plausibility judgments, not confidence or credible intervals.
112Run:
114```bash
115python scripts/evaluate_matrix.py scores.csv \
116 --config criteria.json \
117 --weight-delta 0.10 \
118 --output matrix.json
119```
121The output includes:
123- raw and normalized criterion scores;
124- supplied and normalized weights;
125- base score and deterministic presentation rank;
126- score interval implied by input low/high values;
127- minimum/maximum score and rank when each weight is perturbed one at a time
128 by the requested fraction and all weights are renormalized;
129- qualitative fields, limitations, formula, and tie rule;
130- `decision: null` and an explicit notice that no scientific conclusion or
131automatic selection was made.
133The sensitivity analysis is local and one-factor-at-a-time. It does not explore
134all possible weights, criterion dependence, model-form uncertainty, correlated
135ratings, or uncertainty in the scale anchors.

Scores CSV

idea_id,information_gain,information_gain_low,information_gain_high,resource_burden,resource_burden_low,resource_burden_high,qualitative_review,uncertainties,evidence_status,ethics_status
I001,4,3,5,3,2,4,"Distinguishing prediction is clear","Assay performance unknown",search-incomplete,review-required
I002,3,2,4,2,2,3,"Lower burden but less discriminating","Population transfer uncertain",mixed,not-assessed

Required columns are idea_id, every configured criterion, qualitative_review, and uncertainties. Low/high columns are optional but must appear as pairs and contain low <= score <= high. Extra columns are preserved as qualitative context.

Missing central scores, including abstentions, are rejected. Keep them in the session record and defer the comparison or document a separate complete-case matrix; never impute zero or drop a criterion silently. Missing or jointly blank bounds hold the central rating fixed only for calculation. The output records bounds_supplied per criterion, lists criteria_without_uncertainty_bounds, and warns that this does not imply certainty. Even fully supplied bounds are plausibility judgments, not confidence or credible intervals.

Run:

python scripts/evaluate_matrix.py scores.csv \
  --config criteria.json \
  --weight-delta 0.10 \
  --output matrix.json

The output includes:

  • raw and normalized criterion scores;
  • supplied and normalized weights;
  • base score and deterministic presentation rank;
  • score interval implied by input low/high values;
  • minimum/maximum score and rank when each weight is perturbed one at a time by the requested fraction and all weights are renormalized;
  • qualitative fields, limitations, formula, and tie rule;
  • decision: null and an explicit notice that no scientific conclusion or

automatic selection was made.

The sensitivity analysis is local and one-factor-at-a-time. It does not explore all possible weights, criterion dependence, model-form uncertainty, correlated ratings, or uncertainty in the scale anchors.

Raw lines 91 to 136
Runs code python scripts/evaluate_matrix.py :115
137## Interpreting sensitivity
139Treat a ranking as fragile when:
141- rank changes under small, plausible weight perturbations;
142- score intervals overlap materially;
143- one criterion dominates the result;
144- rankings change after a reasonable alternative definition;
145- missing evidence is driving optimistic ratings;
146- qualitative review or a gate conflicts with the numeric order.
148Do not “fix” fragility by choosing weights that stabilize a preferred result.
149Use it to identify value judgments, missing information, or candidates that
150need further comparison.

Interpreting sensitivity

Treat a ranking as fragile when:

  • rank changes under small, plausible weight perturbations;
  • score intervals overlap materially;
  • one criterion dominates the result;
  • rankings change after a reasonable alternative definition;
  • missing evidence is driving optimistic ratings;
  • qualitative review or a gate conflicts with the numeric order.

Do not “fix” fragility by choosing weights that stabilize a preferred result. Use it to identify value judgments, missing information, or candidates that need further comparison.

Raw lines 137 to 151
152## Adversarial review template
154For every shortlisted idea record:
156```text
157Idea ID:
158Reviewer (not an originator):
159Strongest version of the idea:
160Observation that would count against it:
161At least two alternative explanations:
162Measurement or analysis failure:
163Sampling or generalizability failure:
164Prior evidence that challenges it:
165Potential harm, inequity, or misuse:
166Mitigation:
167Residual uncertainty:
168Disposition: retain / revise / pause / stop / external review
169```
171Review the strongest version before attacking it. Avoid performative “devil's
172advocacy” with no follow-up; every challenge needs a response, owner, and
173status.

Adversarial review template

For every shortlisted idea record:

Idea ID:
Reviewer (not an originator):
Strongest version of the idea:
Observation that would count against it:
At least two alternative explanations:
Measurement or analysis failure:
Sampling or generalizability failure:
Prior evidence that challenges it:
Potential harm, inequity, or misuse:
Mitigation:
Residual uncertainty:
Disposition: retain / revise / pause / stop / external review

Review the strongest version before attacking it. Avoid performative “devil's advocacy” with no follow-up; every challenge needs a response, owner, and status.

Raw lines 152 to 174
175## Literature check
177For each idea:
1791. Translate the idea into searchable concepts and alternative terminology.
1802. Search primary literature, systematic reviews, methods guidance, negative
181 findings, and adjacent disciplines.
1823. Record databases, exact queries, dates, filters, and screening limits.
1834. Verify each source, DOI, sample, design, and relevant result.
1845. Separate:
185 - directly relevant evidence;
186 - indirect analogy;
187 - conflicting or null evidence;
188 - expert opinion;
189 - no direct evidence located in this search.
1906. Update assumptions and ratings without overwriting the original record.
192Do not use citation counts as a validity score. Do not let an AI-generated
193summary substitute for reading the source.

Literature check

For each idea:

  1. Translate the idea into searchable concepts and alternative terminology.
  2. Search primary literature, systematic reviews, methods guidance, negative findings, and adjacent disciplines.
  3. Record databases, exact queries, dates, filters, and screening limits.
  4. Verify each source, DOI, sample, design, and relevant result.
  5. Separate:
  6. directly relevant evidence;
  7. indirect analogy;
  8. conflicting or null evidence;
  9. expert opinion;
  10. no direct evidence located in this search.
  11. Update assumptions and ratings without overwriting the original record.

Do not use citation counts as a validity score. Do not let an AI-generated summary substitute for reading the source.

Raw lines 175 to 194
195## Feasibility and rigor gate
197Ask a relevant methods expert to review:
199- research question, unit of inference, and proposed comparison;
200- discriminating predictions and plausible alternatives;
201- sampling frame, controls, randomization, blinding, and replication;
202- measurement validity and resource authentication;
203- nuisance variables, batch effects, missingness, and analytic flexibility;
204- sample-size or information requirements;
205- feasibility, dependencies, cost, skills, and failure recovery;
206- value and interpretability of null or contradictory outcomes.
208This is a gate to protocol development, not approval to collect data.

Feasibility and rigor gate

Ask a relevant methods expert to review:

  • research question, unit of inference, and proposed comparison;
  • discriminating predictions and plausible alternatives;
  • sampling frame, controls, randomization, blinding, and replication;
  • measurement validity and resource authentication;
  • nuisance variables, batch effects, missingness, and analytic flexibility;
  • sample-size or information requirements;
  • feasibility, dependencies, cost, skills, and failure recovery;
  • value and interpretability of null or contradictory outcomes.

This is a gate to protocol development, not approval to collect data.

Raw lines 195 to 209
210### NIH-funded biomedical work
212When NIH guidance applies, the later application or protocol should address:
214- rigor of prior published and unpublished research;
215- robust and unbiased design, methodology, analysis, interpretation, and
216 reporting;
217- relevant biological variables;
218- authentication of key biological or chemical resources.
220NIH's SABV policy expects sex to be considered in research questions, design,
221analysis, and reporting for vertebrate animal and human studies, with strong
222justification for a single-sex scope. “Include both sexes” alone is not an
223analysis plan, and an inappropriate underpowered comparison can reduce rather
224than improve rigor. Consult current NIH instructions and program staff.

NIH-funded biomedical work

When NIH guidance applies, the later application or protocol should address:

  • rigor of prior published and unpublished research;
  • robust and unbiased design, methodology, analysis, interpretation, and reporting;
  • relevant biological variables;
  • authentication of key biological or chemical resources.

NIH's SABV policy expects sex to be considered in research questions, design, analysis, and reporting for vertebrate animal and human studies, with strong justification for a single-sex scope. “Include both sexes” alone is not an analysis plan, and an inappropriate underpowered comparison can reduce rather than improve rigor. Consult current NIH instructions and program staff.

Raw lines 210 to 225
226## Ethics, safety, and regulatory gate
228Ask whether the idea involves:
230- people, identifiable or sensitive data, vulnerable groups, or clinical care;
231- animals;
232- pathogens, toxins, engineered biological systems, or environmental release;
233- dual-use capabilities, dangerous optimization, or security-sensitive
234 details;
235- controlled technologies, export restrictions, or research-security duties;
236- Indigenous, community, cultural, or data-sovereignty obligations;
237- proprietary information or unpublished work;
238- environmental, distributive, or accessibility harms.
240Record `not-assessed`, `not-applicable`, `review-required`, `approved under
241identifier ...`, `redesign-required`, or `stop`. Only the authorized body can
242issue approval. Current policies vary by jurisdiction and can change.

Ethics, safety, and regulatory gate

Ask whether the idea involves:

  • people, identifiable or sensitive data, vulnerable groups, or clinical care;
  • animals;
  • pathogens, toxins, engineered biological systems, or environmental release;
  • dual-use capabilities, dangerous optimization, or security-sensitive details;
  • controlled technologies, export restrictions, or research-security duties;
  • Indigenous, community, cultural, or data-sovereignty obligations;
  • proprietary information or unpublished work;
  • environmental, distributive, or accessibility harms.

Record not-assessed, not-applicable, review-required, approved under identifier ..., redesign-required, or stop. Only the authorized body can issue approval. Current policies vary by jurisdiction and can change.

Raw lines 226 to 243
244## Decision log
246Record the decision while alternatives and uncertainty are still visible:
248- date, owner, and decision scope;
249- candidate IDs and versions;
250- criteria, anchors, weights, and sensitivity settings;
251- raw ratings, ranges, dissent, missing ratings, and abstentions;
252- evidence-check protocol and results;
253- adversarial review and responses;
254- feasibility and ethics/safety/regulatory gate status;
255- selected next action and why;
256- rejected or deferred alternatives and why;
257- revisit trigger, owner, and deadline.
259Do not rewrite the log after outcomes are known. Append corrections and
260reasons.

Decision log

Record the decision while alternatives and uncertainty are still visible:

  • date, owner, and decision scope;
  • candidate IDs and versions;
  • criteria, anchors, weights, and sensitivity settings;
  • raw ratings, ranges, dissent, missing ratings, and abstentions;
  • evidence-check protocol and results;
  • adversarial review and responses;
  • feasibility and ethics/safety/regulatory gate status;
  • selected next action and why;
  • rejected or deferred alternatives and why;
  • revisit trigger, owner, and deadline.

Do not rewrite the log after outcomes are known. Append corrections and reasons.

Raw lines 244 to 261
262## Bounded pilot record for a shortlisted idea
264Plan the smallest informative check before developing a full protocol:
266```text
267Idea ID and source/target mapping (if analogical):
268Target-domain baseline or current explanation:
269Competing explanations and their differing predictions:
270Observable, units, comparison, and measurement limitations:
271Feasibility dependencies and required review:
272Advance / revise / stop rule fixed before seeing pilot outcomes:
273Outcomes that would be inconclusive (including failed controls):
274Next evidence needed if the pilot succeeds:
275```
277Illustrative example, not an executed experiment: an optical signal rises after
278a sample treatment. One candidate explanation is a change in the target
279quantity; another is altered measurement response. A preliminary plan could
280compare the original readout with an orthogonal measurement and a response
281control. Define acceptable disagreement and control performance from assay
282characterization before inspecting outcomes. Concordant readings with adequate
283controls justify further investigation; a failed response control is
284inconclusive about the biological mechanism. No numeric threshold, sample size,
285or causal conclusion is supplied by this brainstorming example.
287For an analogy, record what was demonstrated in the source system separately
288from what was observed in the target. A successful pilot establishes only the
289tested conditions and cannot by itself prove the transferred mechanism.

Bounded pilot record for a shortlisted idea

Plan the smallest informative check before developing a full protocol:

Idea ID and source/target mapping (if analogical):
Target-domain baseline or current explanation:
Competing explanations and their differing predictions:
Observable, units, comparison, and measurement limitations:
Feasibility dependencies and required review:
Advance / revise / stop rule fixed before seeing pilot outcomes:
Outcomes that would be inconclusive (including failed controls):
Next evidence needed if the pilot succeeds:

Illustrative example, not an executed experiment: an optical signal rises after a sample treatment. One candidate explanation is a change in the target quantity; another is altered measurement response. A preliminary plan could compare the original readout with an orthogonal measurement and a response control. Define acceptable disagreement and control performance from assay characterization before inspecting outcomes. Concordant readings with adequate controls justify further investigation; a failed response control is inconclusive about the biological mechanism. No numeric threshold, sample size, or causal conclusion is supplied by this brainstorming example.

For an analogy, record what was demonstrated in the source system separately from what was observed in the target. A successful pilot establishes only the tested conditions and cannot by itself prove the transferred mechanism.

Raw lines 262 to 290
291## Preregistration and open science handoff
293Ideation is normally exploratory. When a candidate becomes a confirmatory
294study:
2961. distinguish hypotheses formed before versus after seeing relevant outcomes;
2972. specify design, primary outcomes, exclusions, stopping, and analysis
298 decisions before outcome inspection;
2993. use a time-stamped registry appropriate to the field;
3004. document amendments and label departures and new analyses as exploratory;
3015. consider a Registered Report when protocol review before results is useful;
3026. follow consent, privacy, intellectual-property, security, and community
303 constraints when sharing.
305Preregistration supports transparency; it does not guarantee a good question,
306adequate power, correct analysis, reproducibility, ethics approval, or truthful
307execution. Exploratory research remains valuable when reported as exploratory.

Preregistration and open science handoff

Ideation is normally exploratory. When a candidate becomes a confirmatory study:

  1. distinguish hypotheses formed before versus after seeing relevant outcomes;
  2. specify design, primary outcomes, exclusions, stopping, and analysis decisions before outcome inspection;
  3. use a time-stamped registry appropriate to the field;
  4. document amendments and label departures and new analyses as exploratory;
  5. consider a Registered Report when protocol review before results is useful;
  6. follow consent, privacy, intellectual-property, security, and community constraints when sharing.

Preregistration supports transparency; it does not guarantee a good question, adequate power, correct analysis, reproducibility, ethics approval, or truthful execution. Exploratory research remains valuable when reported as exploratory.

Raw lines 291 to 307