Identifiers
StablePrefixes
| Prefix | Entity | Registry | Lives under |
|---|---|---|---|
RQ | Research question | registry/research-questions.yaml | /research/questions |
HYP | Hypothesis | registry/hypotheses.yaml | /research/hypotheses |
PRJ | Research project | registry/projects.yaml | /projects |
PUB | Publication | registry/publications.yaml | /publications |
EXP | Experiment | registry/experiments.yaml | /experiments |
DATA | Dataset | registry/datasets.yaml | /datasets |
ALG | Algorithm | registry/artifacts.yaml | /artifacts/algorithms |
CODE | Software | registry/artifacts.yaml | /artifacts/software |
MODEL | Model | registry/artifacts.yaml | /artifacts/models |
FIG | Figure | registry/artifacts.yaml | /artifacts/figures |
TABLE | Table | registry/artifacts.yaml | /artifacts/tables |
DIAG | Diagram | registry/artifacts.yaml | /artifacts/diagrams |
DOC | Document | registry/artifacts.yaml | /artifacts/documents |
PRES | Presentation | registry/artifacts.yaml | /artifacts/presentations |
PROMPT | Prompt | registry/artifacts.yaml | /artifacts/prompts |
BENCH | Benchmark | registry/artifacts.yaml | /artifacts/benchmarks |
CONFIG | Configuration | registry/artifacts.yaml | /artifacts/configurations |
Thesis chapters use CH01 through CH09 and are not registered separately;
the chapter list is fixed by the outline.
Format
PREFIX-NNN, zero-padded to three digits, assigned in order within the prefix.
RQ-001, FIG-042, CONFIG-007.
Three digits is enough. A doctorate that produces more than 999 of any one entity kind has a different problem than numbering.
Rules
- Numbers are never reused. If
EXP-014is abandoned,EXP-014stays abandoned and the next experiment isEXP-015. Reusing a number makes every older reference to it silently wrong. - Numbers never change. Directory slugs may change; the number in them may
not.
PRJ-001-vague-ideabecomingPRJ-001-orbital-thermal-studyis fine. - Assignment happens in the registry. Take the next free number from the registry file and add the entry in the same commit that creates the page. Two branches that both take the next number is the one failure mode here, and it shows up as a merge conflict in the registry, which is exactly where it should show up.
- An entity with no page is not an entity. A registry row pointing at
nothing is a broken reference;
pnpm validatereports it.
Referencing
Inside prose, write the bare identifier and link it: [EXP-001](/experiments/EXP-001-experiment-name).
Do not write “the first experiment”; a reader six months later cannot resolve
that, and neither can a search.
Last updated on