Legacy template docs sit outside the ores.* physical-space graph
Table of Contents
This page is a capture in the inbox bucket of the product backlog — a pre-sprint idea, not yet pulled into a sprint as a story.
1. What
Eleven pages in projects/ores.codegen/library/templates/ are titled
Archetype: ... but are typed #+type: knowledge and carry no
#+facet: keyword. They are also named for the template they hold
(doc_facet_org.org) instead of by MASD address. The pages are
doc_facet_org, doc_facet_group_org, doc_technical_space_org,
doc_archetype_org, doc_profile_org, doc_feature_org, and five
sql_* pages.
The inventory generator at
projects/ores.codegen/scripts/regenerate_physical_space_inventories.py
globs ores.*.org only, so it never sees them. Every facet they belong to
therefore reports zero archetypes in its generated table, even though the
facet's own prose names the templates.
Migrate each page to the ores.<facet>.<archetype>.org filename, set
#+type: archetype and #+facet: <facet>, and keep the :ID: and the
#+begin_src mustache :tangle ... block unchanged so the tangle target
still resolves. Then regenerate the inventories.
2. Why
The gap is invisible from the graph side: a facet page with no archetypes
looks like a facet with no templates. It became visible on 2026-09-16 when
the inventory regeneration replaced a hand-maintained four-row table on
ores.doc.template with an empty generated one, and dropped two rows from
ores.doc.modeling for doc_profile_org and doc_feature_org. Both pages
recovered the rows into a section the generator does not own, but that is a
patch, not a fix.
The same mis-typing may reach further than these eleven pages, and the
ores.qt facet showed a related symptom: its old table claimed 12
archetypes while 9 pages exist.
3. References
projects/ores.codegen/scripts/regenerate_physical_space_inventories.py— the generator that globsores.*.org.doc/agile/versions/v0/sprint_25/shell-command-codegen/story.org— the wave whose inventory regeneration surfaced this.
4. See also
- Codegen template library — the groups overview.