diff --git a/.agents/shared/page-templates.md b/.agents/shared/page-templates.md
index 247a444..d02efde 100644
--- a/.agents/shared/page-templates.md
+++ b/.agents/shared/page-templates.md
@@ -4,6 +4,17 @@ The structural templates for each page type. Prose voice, vocabulary, and cross-
 in [writing-style.md](writing-style.md); the layer model (sources / wiki / index / log) lives in
 [llm-wiki.md](llm-wiki.md).
 
+## File naming
+
+- **Root entry-point files:** ALL-CAPS (e.g. `AGENTS.md`, `README.md`). These are discovery paths — agents and humans find them first.
+- **Container pages:** `<id>-<name>.md` (e.g. `101-jellyfin.md`, `132-rclone.md`). The `<id>` is the LXC/VM ordinal from `inventory.yaml`.
+- **Infrastructure / cross-cutting pages:** lowercase-with-dashes (e.g. `dns.md`, `auto-deploy.md`, `mesh.md`). Describes a system, not a specific node.
+- **Plans / investigations / time-stamped docs:** `YYYY-MM-DD-<slug>.md` (e.g. `2026-07-05-oikos-prometheus-lxc.md`). Date first, then lowercase slug.
+- **Skills / runbooks:** folder name is lowercase-with-dashes (e.g. `client-enrollment/`), contains `SKILL.md` (uppercase). Emphasizes the skill-name for navigation.
+- **Indices:** `README.md` or `index.md` (both lowercase). Prefer `README.md` for folders; use `index.md` only when both an intro page and a listing coexist.
+
+All paths use lowercase letters, numbers, and hyphens (no underscores). This keeps them readable, shell-friendly, and consistent across the repo.
+
 ## Voice
 
 Concise, technical, sysadmin-to-sysadmin. No marketing prose, no exclamation marks. Full rules in
diff --git a/AGENTS.md b/AGENTS.md
index d29e474..07cae3a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -75,19 +75,25 @@ Grep is fine for browsing or when MCP is unreachable.
 
 ## 4. Wiki conventions
 
-- Narrative pages live under `knowledge/wiki/{containers,hosts,vms,infrastructure}/`;
+See [page-templates.md](.agents/shared/page-templates.md) for file naming, page
+structure, and the tone standard. Quick reference:
+
+- **File naming:** Root entry-points are ALL-CAPS (`AGENTS.md`); containers use
+  `<id>-<name>.md`; infrastructure uses lowercase-with-dashes; plans and investigations
+  use `YYYY-MM-DD-slug.md`; skills are folders with `SKILL.md` inside.
+- **Where pages live:** Narrative under `knowledge/wiki/{containers,hosts,vms,infrastructure}/`;
   incident records under `knowledge/sources/investigations/`; runbook procedures under
   `.agents/skills/<name>/SKILL.md`; operator reference under `.agents/operations/`;
   design docs under `plans/`. Cross-link liberally; orphans are bugs.
-- Every page ends with a `## Changelog` section, entries in reverse-chrono
-  order:
+- **Changelog format:** Every page ends with a `## Changelog` section, entries in
+  reverse-chronological order:
 
       ### YYYY-MM-DD — short title
       one or two lines describing what changed and why.
 
-- Investigation files are dated and slugged: `YYYY-MM-DD-slug.md`.
-- Live state takes precedence over docs. If you observe a discrepancy, update
-  the docs *in the same session* (per the same-session update rule).
+- **Live state precedence.** If you observe a discrepancy between the docs and
+  running state, update the docs *in the same session* (per the same-session update
+  rule in [page-templates.md](.agents/shared/page-templates.md#same-session-update-rule)).
 
 ## 5. Acting on the homelab
 
diff --git a/README.md b/README.md
index 2735ff9..53cc9b7 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,7 @@ Resolved cases move to [`investigations/archive/`](knowledge/sources/investigati
 
 ## Conventions
 
+- **File naming.** Root entry-points are ALL-CAPS; containers use `<id>-<name>.md`; infrastructure pages use lowercase-with-dashes; plans and incident records use `YYYY-MM-DD-slug.md`. See [page-templates.md](.agents/shared/page-templates.md) for the full rules.
 - **Each node page** ends with a `## Changelog` section. Reverse-chronological. Entry format:
   ```
   ### YYYY-MM-DD — short title