This document helps humans and agents choose work that moves OpenAMP Foundry toward becoming the default open infrastructure for trustworthy antimicrobial peptide experiment selection.
The goal is not more activity.
The goal is more compounding.
Choose the task that most increases one of these:
- Scientific truthfulness.
- Safety.
- Reproducibility.
- Decision quality.
- External usefulness.
- Agent/human continuation speed.
Avoid tasks that only make the repo look more advanced.
The repo already has a strong dry-lab foundation, calibration scaffolding, benchmark discipline, and safety framing.
The bottleneck is now external credibility:
Can the system help choose real experiments better than cheap baselines?
Tasks should increasingly point toward:
- external review;
- fair baseline comparison;
- pre-registered pilot packages;
- result intake;
- negative-result preservation;
- calibration that improves the next batch.
These tasks outrank everything else.
Review README, docs, reports, and generated text for unsupported language.
Upgrade: stronger claim discipline.
Verification:
- no Level 6+ language for dry-lab artifacts;
- claims map to
PROOF_LADDER.md; - forbidden phrases removed or qualified.
Check whether any outputs, examples, or docs could be interpreted as unscreened high-risk candidate publication.
Upgrade: safer release posture.
Verification:
- examples remain toy/demo where intended;
- release boundaries are explicit;
- unsafe publication paths are blocked or documented.
Improve PR, release, or model-adapter checklists.
Upgrade: safer human and agent contributions.
Verification:
- checklist catches a concrete failure mode;
- docs link to relevant safety policy;
- no ambiguity around human review.
Ensure major outputs include or reference:
- commit hash;
- config path/hash;
- input path/hash;
- random seed;
- package version;
- generation command;
- timestamp where appropriate.
Upgrade: easier external audit.
Verification:
- schema or tests enforce required fields;
- generated report displays them.
Improve evidence certificates so humans can understand why a candidate was selected or rejected.
Upgrade: better lab/expert review.
Verification:
- certificate still validates;
- report includes limitations and failure modes;
- reviewer can reconstruct selection logic.
Add tests that rerun pipeline steps and compare outputs.
Upgrade: lower reproducibility risk.
Verification:
- test fails if nondeterminism enters an output path;
- seed/config behavior is documented.
Create stronger controls that prevent activity scoring from winning merely by preferring cationic sequences.
Upgrade: harder-to-fool benchmark.
Verification:
- charge distribution between positives and negatives is reported;
- pipeline performance is compared against charge-only baseline;
- caveats are added to
METRICS_CURRENT.md.
Test whether top candidates are mostly near-neighbors of known AMPs.
Upgrade: stronger novelty claims.
Verification:
- similarity distribution reported;
- near-duplicate threshold justified;
- novelty claims downgraded where needed.
Expand per-family benchmark analysis so weak AMP classes are visible and not excluded by ranker bias.
Upgrade: better experimental panel design.
Verification:
- per-family metrics reported;
- panel selection compensates for weak classes;
- docs state this is not evidence that weak classes are better.
Make it easy for any new scorer or simulation module to declare and run its cheapest meaningful baseline.
Upgrade: permanent anti-hype infrastructure.
Verification:
- new scorer tests fail without baseline comparison;
- report shows delta vs baseline.
Generate a complete review packet from candidate outputs.
Packet should include:
- candidate manifest;
- evidence certificates;
- novelty summary;
- safety-risk summary;
- synthesis summary;
- diversity rationale;
- benchmark caveats;
- unsupported-claim warning;
- reviewer questionnaire.
Upgrade: better expert collaboration.
Verification:
- generated packet is deterministic;
- schema validates included artifacts;
- docs explain how to review without private context.
Improve expert-review forms so reviewers can reject candidates for concrete reasons.
Upgrade: better human decision-making.
Verification:
- questionnaire covers novelty, controls, safety, synthesis, and claim scope;
- answer format can be parsed or summarized.
Create a template for freezing candidate selection, baselines, controls, and success/failure criteria before any pilot.
Upgrade: lower cherry-picking risk.
Verification:
- template includes baseline panels;
- success criteria cannot be silently changed;
- docs link to proof ladder.
When selecting a second batch, generate a report explaining which candidates are likely winners and which are uncertainty probes.
Upgrade: clearer learning logic.
Verification:
- each selected candidate has a reason category;
- safety gates are visible;
- diversity and uncertainty tradeoff is reported.
Ensure every synthetic lab-result path clearly labels synthetic evidence and prevents accidental interpretation as real validation.
Upgrade: anti-overclaim protection.
Verification:
- generated files carry synthetic labels;
- reports state synthetic data cannot support biological claims;
- tests enforce labels.
Add example artifacts where recalibration is correctly rejected.
Upgrade: trust in the gate.
Verification:
- gate exits with rejection code;
- report explains why;
- docs say rejection is success when evidence is weak.
Create a documented registry of external predictor and simulation adapters, including status and evidence level.
Upgrade: easier extension without false trust.
Verification:
- each adapter has scope, version, inputs, outputs, limitations, and baseline result;
- unsupported adapters cannot affect ranking.
Define which schemas are stable, experimental, or deprecated.
Upgrade: external adoption.
Verification:
- schema versions documented;
- breaking-change policy exists;
- deprecated artifacts remain readable where practical.
Create a minimal template for external groups that want to use OpenAMP evidence certificates or result schemas.
Upgrade: ecosystem growth.
Verification:
- template runs without private data;
- safety docs included;
- claim ladder included.
These tasks are valuable only if they remain benchmarked and claim-limited.
Add or adapt a predictor for bacterial-vs-mammalian selectivity.
Required evidence:
- comparison against cheap selectivity proxies;
- within-AMP safety benchmark;
- uncertainty reporting;
- fail-closed behavior.
Add a stability-related signal.
Required evidence:
- clear scope;
- benchmark or literature-supported limitation;
- no claim of in vivo stability;
- baseline comparison.
Add representation-aware diversity or novelty scoring.
Required evidence:
- comparison against sequence-similarity baseline;
- family-stratified behavior;
- failure modes;
- no silent model downloads.
Compare multiple batch-selection strategies.
Required evidence:
- random baseline;
- top-k exploitation baseline;
- uncertainty-only baseline;
- diversity-only baseline;
- safety-adjusted yield metric;
- pre-registered evaluation.
Use these labels in issues or planning docs.
| Label | Meaning |
|---|---|
good-first-task |
Small, safe, clear verification path. |
agent-safe |
Suitable for autonomous or semi-autonomous agents. |
needs-domain-review |
Requires microbiology, peptide, toxicology, or assay expertise. |
needs-safety-review |
Could affect release, safety, claims, or misuse risk. |
benchmark-critical |
Affects evidence or regression gates. |
wet-lab-facing |
Changes artifacts that a lab or expert may review. |
do-not-automerge |
Human review mandatory. |
Stop or downgrade a task when:
- it cannot be tested;
- it requires unsafe content;
- it strengthens claims without evidence;
- it fails against a cheap baseline;
- it introduces hidden data or nondeterminism;
- it makes external review harder;
- it creates maintenance burden without strategic leverage.
After any meaningful task:
- Update the source-of-truth doc if metrics, behavior, or claims changed.
- Add tests or explain why the change is docs-only.
- Record limitations.
- Link related docs.
- Make the next task obvious.
A good contribution should leave a trail.
The single highest-leverage milestone is a pre-registered, safety-reviewed, baseline-controlled external pilot package.
Not because it will necessarily succeed.
Because it will reveal what the repo is actually worth under real experimental pressure.
Every task that makes that milestone more honest, safer, cheaper, or easier to review is high leverage.