Authoring a Blue Life Commons species page
You are contributing to a public scientific commons. Unsourced claims do not ship.
Before writing (read these in the target repo)
AGENTS.md— binding rules for agent contributions.SOURCES.md— citation tiers (Tier 1 primary / Tier 2 institutional only for science claims).ETHICS.md— no anthropomorphism, no interaction promotion, no precise locations for vulnerable taxa.schema/artifact-schema.yaml— required frontmatter fields.
The gold-standard structure (each factual sentence must trace to a source)
- Taxonomy & description — accepted scientific name + authority; defer ranges to cited sources.
- IUCN status — category with assessment date and Red List version. A 2009 "Least Concern" is not current truth; surface the assessment age.
- Distribution — at safe granularity. Use regional/coarse description, never exact aggregation sites, nesting beaches, or haul-outs for vulnerable taxa. When in doubt, coarsen.
- Behavior / ecology — every claim cited to Tier 1–2; no "what the animal is thinking" framing.
- Threats — cite IUCN threat classification + regional pressures.
- What you can do — welfare-first; minimum approach distance citing the strictest applicable rule; link iNaturalist / Happywhale for ethical reporting.
- Sources — full list, DOIs where available, access dates.
Frontmatter
Set status: needs-expert-review and review.science: pending for any new science page — you do not decide scientific truth; reviewers do. Fill sources[], species, species_group, outputs.website_path, outputs.github_path, contributors, license: CC-BY-4.0.
Sensitivity check (mandatory)
Before finalizing distribution: would a coarse location + a season + a visible landmark in any included media reconstruct an exact site? If yes, coarsen further or omit. Apply the GBIF four-category model where the commons has adopted it.
Finish
- Run
/source-verifyover the draft (no un-sourced factual sentence). - Run
/ethics-check. - Run
/validate-artifact(schema gate). - Run
/open-artifact-pr.
Built on SIP · Blue Life Commons (CC-BY-4.0).