diff --git a/docs/ORIN-RUNTIME.md b/docs/ORIN-RUNTIME.md
index 877b696..0b34463 100644
--- a/docs/ORIN-RUNTIME.md
+++ b/docs/ORIN-RUNTIME.md
@@ -1,6 +1,3 @@
----
-type: default
----
 # Orin runtime
 
 [ARCHITECTURE.md](ARCHITECTURE.md) describes services and the bus without saying
diff --git a/docs/REPOS.md b/docs/REPOS.md
index 57cb6b4..8d85c8e 100644
--- a/docs/REPOS.md
+++ b/docs/REPOS.md
@@ -110,3 +110,26 @@ docs/
 The `impl/plans` ÷ `impl/reports` split is worth keeping: plans go stale,
 reports do not. A report like `PCAN-SETUP.md` stays valuable precisely because
 it records the investigation and the dead ends, not just the final commands.
+
+### Scaffolding conventions
+
+No template repository for this. Template instantiation is fork-at-create, so it
+could not reach the repos that already exist, and the scaffolding is three
+markdown files — lighter than the machinery to manage it. A template earns its
+place where there is a real toolchain to carry, which is the ESP32 case above.
+
+What every component repo has instead:
+
+```
+README.md                 frontmatter, the shared blurb, "What this repo is
+                          about", then links to guidelines and impl/
+docs/GUIDELINES.md        frontmatter, numbered sections, ends "## N. To be added"
+docs/impl/plans/          at least INITIAL.md
+docs/impl/reports/
+docs/BOM.md               only where the repo owns hardware
+```
+
+**Frontmatter follows the document's nature, not its location:** living documents
+carry `type: default`; historical records do not. So README, GUIDELINES, BOM and
+plans have it, and reports do not. The hub carries none at all, being the portal
+rather than a component.