Curator Guide
The policy a reviewer applies: what makes a record, how to grade it, conflicts, knockouts and hosts, duplicates, reject reasons, and the published extraction rules R-16 to R-22.
How to read this guide. Two kinds of statement appear here, and they are marked differently.
- Policy. Enforced by the code, or ratified in the project's design decisions or the extraction pipeline's rulings (as of 2026-09-27). Apply it as written.
- Draft — maintainer to confirm A recommendation for a judgement call that nothing yet settles. Use it as a default and note in the record when you do. Only the maintainer can turn a draft into policy.
Contents:
1. The review workflow
- One inbox. The Curator Inbox lists every pending item across every queue: papers to review, papers needing a PDF, running extractions, community flags and suggestions, and change/removal requests. Counts always cover the whole backlog. Each row opens the page where the item is actually worked.
- Assignment is a to-do mark, not a lock. "Assign to me" puts a paper on your list and lasts until you release it. Anyone can still open and approve an assigned paper. Only a superuser can assign a paper to someone else or take it off a colleague's list. The live "open now" badge (the claim) is separate: it lapses minutes after a tab closes and only says someone is typing.
- Who may publish what.
- Approving or rejecting an AI extraction of a published paper: curator or superuser.
- Approving or rejecting a user submission (someone else's unpublished data): superuser only. Curators may read, correct and prepare it.
- Reject, withdraw and correct are different outcomes.
- Reject: a pending extraction is turned away before anything is written.
- Withdraw: an approved paper's records are deleted from the live database. Use it when the paper should never have been approved.
- Correct (reopen, then approve a revision): the records were right in kind but
wrong in detail. The earlier run becomes
superseded. When the extraction producer re-delivers corrections for many papers at once, its revisions are grouped by sweep at Revision batches: read each row's changes there and approve or reject a selection. Each paper is approved separately, exactly as from its review page; one that fails (an unresolvable organism, say) stays waiting and is corrected on its own page.
2. What makes a record
The unit of record is one actor tested against one plastic, in one paper (an interaction). Its evidence is one or more experiments, each with one or more observations.
2.1 Scope and provenance
- The paper must put an enzyme or a microorganism in contact with a plastic (R-13). Identity, cloning, expression or structure work with no plastic anywhere is out of scope, even for a famous enzyme.
- Only this paper's own Results count (R-15). A degradation claim cited from another
study, or stated as background, produces no interaction, not an
inconclusiveone. Put the cited study forward for harvest instead. - The actor must meet the plastic, not a compound derived from it (R-16). Oligomeric materials the vocabulary lists as plastics are plastics (R-17).
- An insect larva is a host, never an actor (R-18).
- Only microbial enzymes are actors (ratified 2026-09-27). The test is the source organism: animal and plant enzymes are not recorded; fungal and bacterial lipases and proteases are.
- A community is never an actor. A consortium, sludge or enrichment culture cannot be
credited. An enzyme recovered from a metagenome with no cultured source is a
proteinactor fromuncultured bacterium. An unnamed isolate is one organism, not a community: record it at the nearest node NCBI holds (fungal sp.,unidentified bacterium) with the strain code instrain_designation. - No
predictedresults. Allowed results arepositive,negativeandinconclusive. A computational prediction with no experiment is omitted, not downgraded.
2.2 Grading the result
- Clear zone or halo →
positive(R-2). Do not downgrade an observed halo because plate assays are weak evidence. Put the caveat innotesinstead. - Mass loss below 2% →
inconclusive(R-3). This applies toweight_lossandmass_remainingonly, strictly below 2.0%, and only when the paper gives no verdict of its own. - Growth on the plastic is
inconclusive(R-14), when growth is the only evidence. Sole carbon source strengthens the claim, not the evidence. - A value inside its own error bar is not activity (R-22).
- A measured negative is a finding. Record negatives, including wild-type negative
controls. Never push a clean negative into
inconclusive. - Evidence strength has no field. There is no confidence grade on an interaction.
Write caveats such as "no abiotic control" or "mixed-flask value" in the interaction's
notes.
2.3 Evidence minimums
- A
positiveshould rest on at least one experiment with at least one observation from this paper. The schema does not require it (legacy V1 rows carry none), so treat a positive with zero experiments as a reason to check the paper, not as settled evidence. - Prefer a record whose positive is supported by a direct measure of the polymer (mass loss above the R-3 threshold, clear zone, molecular-weight or functional-group change, released monomer, CO₂ evolution) over growth alone.
- Do not copy one mixed-culture or mixed-flask value onto several isolates as independent positives. If the paper did not assay each isolate in pure culture, record the caveat and grade on what was actually shown.
3. Conflicting evidence
- Each paper keeps its own result. Interactions are per paper, so two papers that disagree about the same actor and plastic both stand. Public pages show the pair as mixed. Never edit one paper's result to agree with another's.
- The merge tool will not reconcile a conflict. A duplicate group whose members disagree positive/negative on the same plastic is refused, as is one with a softer disagreement (section 5).
- A paper that contradicts itself.
inconclusivecovers results that are ambiguous or contradictory, or that the paper itself calls inconclusive. If you grade on one reading, say which one innotes.
notes. Do not withdraw the earlier paper unless it is
itself retracted.
4. Knockouts, expression hosts and engineered strains
- A gene implicated only by knockout, complementation or overexpression is not a
proteinactor (R-6). The enzyme must be purified or recombinantly expressed and assayed against the plastic in its own right. Name the gene in the notes and keep the interaction at the organism level. - A purified-enzyme result is not an organism result. Do not create a microorganism interaction from an enzyme-only result.
- A halo around a knockout-versus-wild-type pair is evidence about the organism, not about the gene.
Strain type (genetic_background). Every whole-organism
record carries the kind of strain the paper tested: wild type, expression host,
knockout / deletion mutant, engineered strain, or not classified (the
default). The last three-but-one are constructs: their results stay visible on the
paper and protein pages, labelled, and are never counted towards the species — not
in its badges, its paper count, "First Reported", the plastic page, the statistics, the exports, the
Taxonomy Tree or Annotate Taxa Table. Set it on the ingestion review form ("Strain type"), or for an
existing record on Curation → Evidence checks.
- Expression host (for example E. coli BL21 or K. phaffii
carrying a foreign PETase): record the activity on the enzyme (
proteinactor,enzyme_production_context = heterologous). Record a whole-cell interaction for the host only if the paper assays the host as a degrader, and mark it expression host. - Engineered strain (for example Acetivibrio thermocellus DSM1313::pHK-LCC, a strain of the species itself carrying a construct): mark it engineered strain.
- Knockout or deletion mutant (for example Δpetase): its loss of activity is a
control for the wild type, not a finding about the species. Keep the genotype in
strain_designationand mark it knockout; it no longer turns the species' result mixed.
python -m scripts.propose_genetic_background --apply
classifies only the high-confidence class (an expression chassis whose paper also assays an enzyme from
another organism); the medium and low proposals are listed on Evidence checks for a curator.
5. Duplicates and renames
- Merge and tombstone, never reuse. A merged record's accession redirects to the survivor and stays citable.
- A merge unions the evidence. Every row pointing at a retired record moves to the survivor. The loser's name is kept as a synonym, and a second accession is kept as a cross-reference. The survivor takes the most restrictive visibility in the group.
- The merge tool refuses verdict conflicts or disagreements, members with different source organisms, and merges that would take a public or staged record out of the public corpus or the release queue. Those are curator or operator decisions, not cleaning.
- Merges are run by an operator (
scripts/merge_duplicate_proteins, planned first and then applied). The Duplicates report shows the same plan read-only. - Protein names are not unique. Many rows are named "PETase". Identify a protein by accession or sequence, never by name alone. New papers fold onto an existing record automatically when the stored sequence matches.
- Organisms are species-level and keyed on the NCBI tax-id. Strains are separate
strain_designations, not separate organisms. A<Genus> sp.is stored at the genus. An ambiguous name is refused, never guessed. - Renamed species: the current accepted name is stored and the paper's name is kept as a synonym, so search finds both.
6. Unresolved organism names
The Unresolved names page lists them.
- An unresolved name is not automatically wrong. NCBI indexes sequenced taxa and is not a register of valid names.
- Correct a strain code, typo or obsolete name at the name.
- Leave a validly published species NCBI does not hold. The retry job keeps asking.
- Mark as unresolvable only a name that will never resolve as written, for example a nomen invalidum, and give the cause.
- Never change an organism's name to something NCBI happens to hold just to get an id.
7. The extraction rulebook: R-16 to R-22
These are the pipeline's ratified rulings, quoted from the extraction contract. The AI's extraction notes cite them by code. A human reviewer applies them the same way.
R-16: an actor must act on the plastic, not on a compound derived from it
Ratified 2026-08-12, extended 2026-08-13. A pair only exists when the actor met the plastic.
An enzyme or organism that acted on a named chemical compound derived from a plastic records
no interaction for that pair. Such compounds include a monomer, a lactam, a diacid, a
diol, a carbamate, MHET or BHET. The vocabulary decides: plastics versus compounds.
- It does not matter what performed the earlier depolymerisation. Chemistry or another enzyme, the actor under study still did not touch the polymer, so MHETase on MHET is out. Record PETase × PET, which is a real pair.
- Plasticisers and additives are compounds, for example DEHP. An actor degrading a plasticised-PVC film acts on a plastic. An actor on the free plasticiser in solution does not. Ask whether the substance was in the material or in the medium.
- It removes pairs, not papers. A study that also assays the polymer keeps those pairs.
- It is not about provenance. An organism sourced from plastic waste is fine.
- Out of scope is zero interactions. Never write a deliberately invalid value to register an objection.
R-17: an oligomeric material is a plastic, and it is not nylon
Ratified 2026-08-13. Nylon oligomer (and Polyisoprene oligomer) are legitimate
substrates. NylA/NylB/NylC on 6-aminohexanoate oligomers, including the cyclic dimer, are in scope. The
result belongs to Nylon oligomer, never to Nylon 6 or Nylon 66.
The split is material versus named compound, not long chain versus short chain. A single lactam ring is
a compound under R-16.
R-18: an insect larva is a host, never an actor
A paper on plastivorous larvae is in scope when it identifies a microbial actor (a gut bacterium, gut fungus or enzyme), which is what gets recorded. It is out of scope when the larva itself is the only actor. The insect never gets an interaction of its own. A 16S shift with no isolate yields zero interactions, because a community is never an actor.
R-19: an enzyme's melting temperature is not a polymer measurement
Ratified 2026-08-28. thermal_degradation describes the thermal behaviour of the
plastic (TGA/DSC on the material), never the thermal stability of the enzyme. An enzyme's
Tm, T50 or unfolding midpoint belongs in the experiment's properties (tm,
t50), never in an observation. The same number must never appear in both. Decide by asking
what was in the pan: protein or plastic. A Tm measured under two conditions is two experiments.
R-20: depolymerization_rate takes a rate
Ratified 2026-08-28; vocabulary extended 2026-08-29. A rate is a quantity per unit time.
| The number is | It goes to |
|---|---|
| a substrate degradation half-life / t½ | degradation_half_life (unit h; days are fine) |
a dimensionless extent (%, fold, % of wild type) | depolymerization_extent (unit %) |
| an enzyme's thermal half-life | properties.half_life + half_life_temperature (not an observation) |
| the experiment's elapsed time | experiments[].duration |
unit: "h" on depolymerization_rate is always an error. A time-to-90% is not a
half-life.
R-21: weight_loss means the balance said so
Ratified 2026-08-28. weight_loss is gravimetric mass loss: a specimen recovered, washed,
dried and weighed. A conversion calculated from something else takes its own term:
- monomer by HPLC →
monomer_released - pH-stat NaOH →
depolymerization_rateper unit time, otherwisemonomer_released - TOC/DOC/COD →
soluble_carbon_released - CO₂ →
co2_evolved
This is a typing rule, not a scepticism rule. Record both numbers under their own terms and downgrade nothing.
R-22: a value inside its own error bar is not activity
Ratified 2026-08-28. Where every observation supporting a pair is a flat zero or has an
error that spans zero, the pair is not positive. It is:
negativewhen the assay was made and cleanly came back with nothing;inconclusivewhen the assay could not resolve the question.
It never pushes a measured negative into inconclusive, never deletes an observation and never
removes the interaction. One substantive observation anywhere and the rule does not apply.
mass_remaining: 0 is the strongest positive there is.
Other codes you will see in extraction notes
| Code | Ruling |
|---|---|
| R-1 | sequence is the deposited record verbatim. Never trimmed, never de-tagged. The mature form is derived by PlasticDB. |
| R-2 | A clear zone or halo is positive. |
| R-3 | Mass loss below 2% (weight_loss/mass_remaining, no author verdict) is inconclusive. |
| R-5 | Intracellular PHA/PHB degradation is in scope. |
| R-6 | An enzyme becomes a protein actor only by direct assay against the plastic. |
| R-7 | Mutation positions keep the paper's numbering; numbering_offset carries the frame. Null means "not established", not 0. |
| R-11 / R-12 | Screening scope and the non-terminal "uncertain" screening verdict (pipeline-side). |
| R-13 | The paper must involve a plastic somewhere to be in scope. |
| R-14 | Growth on a plastic as the only evidence is inconclusive. |
| R-15 | Only this paper's own Results count; cited evidence produces no interaction. |
Extraction confidence ("Step 14")
The AI grades its own extraction, not the paper. high means all seven criteria hold:
- full text was available;
- every supplement it depends on was readable;
- the actor list is complete;
- no approximate vocabulary mappings were used;
- every sequence is resolved and every variant offset verified;
- every number the paper reports was captured;
- every result follows unambiguously.
medium means 1 and 3 hold but some of the others do not. low means it
had an abstract only, unreadable core supplements, dropped actors, or undeterminable results.
"Step 14 criterion 4" in a note means an approximate vocabulary mapping. Check that mapping first.
8. Reject reasons
Every reject and withdrawal carries a free-text reason that is kept on the record. Rejection is for an extraction that should not be written. Use Re-run extraction when the extraction is merely poor, and Correct this paper when approved records need fixing.
| Label | Use when |
|---|---|
out-of-scope (R-13) | no enzyme or organism meets a plastic anywhere in the paper |
no own evidence (R-15) | the only support is cited or background |
compound, not plastic (R-16) | every pair is on a monomer, product or additive |
larva-only (R-18) | the insect is the only actor |
non-microbial enzyme | the enzymes are animal or plant enzymes |
community only | nothing was isolated and no enzyme identified |
duplicate run | another ingestion of this DOI is already approved; correct that one instead |
not primary research | a review, commentary or erratum |
retracted | the paper was retracted |
unreadable source | the source could not be read; try Re-run extraction or a new PDF first |
9. Visibility decisions are not curator decisions
- Visibility decisions belong to an operator, not a reviewer. Curators never publish records directly. Approved records are staged and published by the weekly dataset release, which is a superuser action, and a release snapshot's Figshare DOI cannot be withdrawn.
- All curated data is public. There are no embargoes, private deposits or visibility holds (removed in v1.26.0). Record negative results like any other result; they are published with the next weekly release.