R77.F2 Audit — Missing section index.md files (breadcrumb 404s)
Scope
10 docs/ folders return 404 on GitHub Pages when their bare folder URL is
hit via breadcrumb or sidebar click. Cause: no index.md in the folder.
Jekyll with remote_theme: just-the-docs/just-the-docs does not serve
README.md as a directory index — only index.md.
Curl confirmation (live Pages @ main ae0b78ec)
| URL | HTTP |
|---|---|
https://lasteld.github.io/AMS/3-world/physics/laws/ |
404 |
https://lasteld.github.io/AMS/architecture/ |
404 |
https://lasteld.github.io/AMS/architecture/decisions/ |
404 |
https://lasteld.github.io/AMS/agents/ |
404 |
https://lasteld.github.io/AMS/reference/ |
404 |
https://lasteld.github.io/AMS/reference/extractions/ |
404 |
https://lasteld.github.io/AMS/audits/ |
404 |
https://lasteld.github.io/AMS/contracts/ |
404 |
https://lasteld.github.io/AMS/packets/ |
404 |
https://lasteld.github.io/AMS/verification/ |
404 |
All 10 confirmed. Most impactful: 3-world/physics/laws/ (home of
κ η θ ι Greek concept docs).
Inventory — existing siblings per folder
| Folder | Files | index.md? |
README.md? |
|---|---|---|---|
3-world/physics/laws/ |
consensus.md, proof-store.md, rule-engine.md, state-fork.md |
no | no |
architecture/ |
decisions/ |
no | no |
architecture/decisions/ |
ADR-001..006 + README.md |
no | yes (not served) |
agents/ |
executor-contract.md, pm-contract.md, sigma-orchestrator.md, writeback-protocol.md |
no | no |
reference/ |
cross-reference.md, design-system.md, glossary.md, mcp-tools-phase-0.md, extractions/ |
no | no |
reference/extractions/ |
48 *-extraction.md files (α..π donor pseudocode) |
no | no |
audits/ |
37 R75/R76 audit artefacts | no | no |
contracts/ |
37 R75/R76 contract artefacts | no | no |
packets/ |
37 R75/R76 packet artefacts | no | no |
verification/ |
37 R75/R76 verification artefacts | no | no |
Frontmatter convention (existing index.md pattern @ 6 files)
Existing section indexes (docs/index.md, docs/3-world/index.md,
docs/3-world/physics/index.md, docs/3-world/social/index.md,
docs/3-world/execution/index.md, docs/4-additions/index.md,
docs/5-time/index.md) share:
title: <Title>
tags: [...]
type: section-index
updated: YYYY-MM-DD
Zero files in the repo use nav_order:, has_children:. parent: is
used on 30 files (mixed — ../index.md path form OR just-the-docs page
title form). The repo convention is therefore not the just-the-docs
nav_order/parent inheritance pattern; it relies on title + the folder
URL existing + jekyll-relative-links for inter-doc linking.
Decision
Follow the repo-consistent pattern: title + tags + type:
section-index + updated + H1 + 1–2 sentence purpose + sibling link
list + “See also”. Skip nav_order/parent/has_children — the task
prompt suggested them but the repo does not use them and introducing
them for just 10 files would create a mixed convention that later rounds
would have to clean up.
Out of scope (per task prompt)
- No
colibri-hero.jschanges (R77.F1) - No edits to existing non-index docs
- No
nav_order/parenton non-index docs (separate P1 pass) - No
src/changes - No
_config.ymlchanges