Plan: Update migration-from-legacy.md to implemented status#
Summary#
Update docs/migration-from-legacy.md to reflect the completed shell-to-agent-core migration (2026-03-16). The document currently describes the migration as in-progress with draft language; it needs metadata updates, PM workflow corrections, hook behavior documentation, router routing details, and a migration completion note.
Files#
| File | Action | Description |
|---|---|---|
docs/migration-from-legacy.md | modify | Update metadata, refine phase, hooks, router, and completion status |
Steps#
- Update metadata header — change
last-updatedto2026-03-16, addstatus: implementedfield to the YAML frontmatter. - Update refine phase description — add documentation of the conversational PM workflow (question-and-answer rounds with the issue author) in the TLA Flow or a new "Refine Phase" subsection.
- Document PhaseHooksService refine hook — add that the refine hook removes the
in-refinementlabel and moves the issue to AgentQueue status; clarify that norefinedlabel is used in the hook flow. - Update router section — document that
issue_commentevents are routed based onin-refinementlabel presence (if label present → refine phase; otherwise → directive handling). - Remove or correct stale references — remove references to
refinedlabel in the "Labels Kept by TLA" table; replace any "draft"/"in-progress" migration language with "implemented" language; update "Labels Deprecated by TLA" section to includeawaiting-plan-approval. - Add migration completion note — add a section confirming all 17 WAL issues were completed and merged as of 2026-03-16, closing out the migration.
Verification#
- All acceptance criteria from the issue are addressed in the updated document.
- No references to
refinedlabel remain except in the Legacy Labels table. - Metadata header reflects
status: implementedandlast-updated: 2026-03-16.
Risks#
- The
awaiting-plan-approvallabel appears in both "Labels Kept by TLA" and may need to move to "Labels Deprecated" — will verify against issue requirements.