Scientific research documentation
Read references/00-RESEARCH-DOCUMENTATION.md before applying any of this.
That file is the standard; everything below it is a summary to help you decide
whether this skill applies and to check your work afterwards.
Reference-architecture principles: P14.
Bundled templates: assets/TEMPLATE.md, assets/PAPER-TEMPLATE.tex, assets/BEAMER-THEME.sty.
What this standard covers
- What counts as research (and what doesn't)
- Where research lives in a repository
- The shape of a study
- The evidence rules
- From study to paper (LaTeX)
- Presenting work as slides (Beamer)
- Documents that borrow the house style without being studies
- Diagrams in a PDF
- Publishing a document in more than one language
- Building the PDF in CI
- Relationship to the rest of the standards
- Worked example
What counts as research (and what doesn't)
A study asks a question whose answer wasn't known before the work was done, and answers it with evidence: measurements, verified computations, reproducible experiments, or systematic analysis of committed code. Examples: benchmarking an algorithm against its theoretical complexity, verifying an implementation against independently derived expected values, characterizing a system's behavior under a sweep of inputs, root-causing a discrepancy between a model's specification and its implementation.
Not research, and living elsewhere:
- Theory/background material — teaching a reader established results
(textbook algorithms, probability rules). That is a theory doc
(
docs/THEORY.mdinbayesian-inferenceis the worked example) and a study cites it rather than repeating it. - Design decisions — those go in the decisions log
(
docs/architecture/05-DECISIONS.mdpattern). - Gap analysis / roadmap —
docs/architecture/per the constitution.
Generated from docs/research/00-RESEARCH-DOCUMENTATION.md by scripts/build-marketplace.mjs. Do not edit this file: change the source document, or its entry in catalog/marketplace.catalog.json, and re-run the generator.