diff --git a/pql-migration.md b/docs/architecture/pql-migration.md
similarity index 96%
rename from pql-migration.md
rename to docs/architecture/pql-migration.md
index 667be61f6..263ae0ded 100644
--- a/pql-migration.md
+++ b/docs/architecture/pql-migration.md
@@ -2,13 +2,20 @@
 title: "pql Migration Plan — decisions + ticketing"
 description: "Migrate the SQLite-backed ticket system and markdown decisions sync onto pql (markdown-vault indexer + planning tool)"
 type: plan
-status: approved
+status: completed
 created: 2026-06-06
 updated: 2026-06-06
 decision_refs: []
 tags: [migration, tooling, pql, decisions, ticketing]
 ---
 
+> **COMPLETED & ARCHIVED (2026-06-06).** This plan shipped: Phases 0–5 in PR #154,
+> the phases-as-hierarchy refactor + Phase-6 SQLite retirement in PR #155. It is kept
+> as a historical record of *why and how* the planning system moved off the binary
+> SQLite DB onto pql. **Current usage** is in `CLAUDE.md`, `.claude/rules/ticket-cli.md`,
+> and `governance/README.md`; the one-shot transforms live in `tooling/pql-migrate/`.
+> Open feedback for the pql team is in the root `pql-requirements.md`.
+
 # pql Migration Plan — decisions + ticketing
 
 > **Status:** approved, not yet executed. All work happens on the `pql-migration`