diff --git a/README.md b/README.md index 07fb9c4..6789a35 100644 --- a/README.md +++ b/README.md @@ -121,8 +121,11 @@ Dev-instance-only (see `tools/CONTRACT.md` for how it got here): A directory under `kb/` is a **collection** exactly when it holds a `COLLECTION.md`; a -subdirectory inside one is an **area** that inherits it. `COLLECTION.md` never appears outside -`kb/` - the other layers carry a `CONTRACT.md` or a root type-spec instead. A stage may carry +subdirectory inside one is an **area** that inherits it, and that is as deep as a page goes - +nothing nests below an area, because the generated catalog reads exactly two path segments +under `kb/` and would fold a deeper page into the area silently (`kb/CONTRACT.md` ยง Collections +has the rule; `wikitool lint` reports a violation as a hard error). `COLLECTION.md` never +appears outside `kb/` - the other layers carry a `CONTRACT.md` or a root type-spec instead. A stage may carry both a `README.md` and a `CONTRACT.md`: they have different readers. The README is for humans working *on* that layer, the contract is what binds an agent working *with* it.