diff --git a/docs/DESIGN.md b/docs/DESIGN.md
index d54c5d3..e0feabe 100644
--- a/docs/DESIGN.md
+++ b/docs/DESIGN.md
@@ -39,10 +39,16 @@ evolving in lockstep with the language:
   `merge-prose`, etc., preferably with `--json` for machine consumption.
 - **Examples** (`examples/`): canonical `.ail.json` programs. They are
   specification anchors, not demos — the E2E suite hangs off them.
-- **Agents** (`agents/`): specialised sub-prompts (implementer,
-  architect, tester, debugger) that form the project's own LLM tooling.
-  They are a versioned part of the repo. See `agents/README.md`.
-- **Docs** (`docs/`): DESIGN.md (what and why), JOURNAL.md (history).
+- **Skills** (`skills/`): specialised disciplines
+  (`brainstorm`, `plan`, `implement`, `audit`, `debug`,
+  `fieldtest`) plus the agent rosters they dispatch
+  (`skills/<name>/agents/`). They form the project's own
+  development methodology and are versioned with the codebase.
+  See `skills/README.md`.
+- **Docs** (`docs/`): `DESIGN.md` (canonical state),
+  `JOURNAL.md` (chronological decisions log),
+  `roadmap.md` (forward queue), `specs/` (per-milestone design
+  specs), `plans/` (per-iteration implementation plans).
 - **Tests**: unit tests per crate plus E2E in `crates/ail/tests/e2e.rs`. Every
   new compiler path needs a test, otherwise the feature does not count as done.