diff --git a/README.md b/README.md
index 4fa26ac..3f27016 100644
--- a/README.md
+++ b/README.md
@@ -139,8 +139,9 @@ plugin.
 
 ## Status
 
-Migration from AILang's in-tree `~/dev/ailang/skills/` is in
-progress. The `boss` skill is the landed pilot; the remaining
-seven skills follow. See `docs/migration.md` for the per-skill
-and per-agent migration checklists and the expected final
-layout.
+The migration from AILang's in-tree `~/dev/ailang/skills/` into
+this plugin is complete — the pipeline skills, the `specify` and
+`tdd` entry paths, the `boss` orchestrator, and the utility and
+conversational skills documented above have all landed.
+`docs/migration.md` records the repo-layout convention and the
+per-skill and per-agent authoring checklists.
diff --git a/docs/migration.md b/docs/migration.md
index 586833f..3ff1b9d 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -1,7 +1,8 @@
 # Migration
 
-This document tracks the migration from AILang's in-tree
-`~/dev/ailang/skills/` into this plugin.
+This document records the migration of AILang's in-tree
+`~/dev/ailang/skills/` into this plugin — now complete — and the
+layout convention and authoring checklists that came out of it.
 
 Each skill is one top-level directory at the repo root,
 containing a `SKILL.md` plus the agent files it dispatches
@@ -9,60 +10,17 @@ under `agents/`. Agents live with their dispatching skill —
 this is what makes the "no orphan agents" rule structurally
 true rather than only documented.
 
-The `boss` skill is the migration pilot (landed); the remaining
-seven skills follow once the pattern is approved.
+## Repo layout
 
-## Expected layout after migration
+Every top-level directory at the repo root that contains a
+`SKILL.md` is a skill; if it dispatches agents, they live in an
+`agents/` subdirectory beside that `SKILL.md`. The repo root is
+the authoritative list of skills — this document deliberately
+does not enumerate them, so it cannot drift out of sync as
+skills are added or renamed.
 
-```
-~/dev/skills/
-├── README.md
-├── INSTALL.md
-├── install.sh
-├── uninstall.sh
-├── docs/
-├── templates/
-├── boss/                          (pilot: landed)
-│   └── SKILL.md
-├── brainstorm/
-│   └── SKILL.md
-├── specify/
-│   ├── SKILL.md
-│   └── agents/
-│       └── grounding-check.md
-├── planner/
-│   ├── SKILL.md
-│   └── agents/
-│       └── plan-recon.md
-├── implement/
-│   ├── SKILL.md
-│   └── agents/
-│       ├── implement-orchestrator.md
-│       ├── implementer.md
-│       ├── spec-reviewer.md
-│       ├── quality-reviewer.md
-│       └── tester.md
-├── audit/
-│   ├── SKILL.md
-│   └── agents/
-│       ├── architect.md
-│       └── bencher.md
-├── debug/
-│   ├── SKILL.md
-│   └── agents/
-│       └── debugger.md
-├── fieldtest/
-│   ├── SKILL.md
-│   └── agents/
-│       └── fieldtester.md
-└── docwriter/
-    ├── SKILL.md
-    └── agents/
-        └── docwriter.md
-```
-
-`boss` has no agents — it is itself the dispatcher of the
-others, not a dispatcher-of-subagents.
+`boss` is the exception with no `agents/`: it is itself the
+dispatcher of the other skills, not a dispatcher-of-subagents.
 
 `install.sh` walks the repo root, treats every top-level
 directory that contains a `SKILL.md` as a skill, and symlinks