| 1 Story Structure | 8 sections per story_template_universal.md in order | Add/reorder sections and subsections with TODO placeholders; update Linear; preserve language | Skip if Done/Canceled or older than 30 days |
| 2 Tasks Structure | Each Task has 7 sections in order | Load each Task full description sequentially; add/reorder sections with placeholders; update Linear and comment; preserve language | Sequential per task; skip if Done/Canceled or older than 30 days |
| 3 Story Statement | As a/I want/So that clarity | Rewrite using persona (Context), capability (Technical Notes), value (Success Metrics); update Linear and comment | - |
| 4 Acceptance Criteria | Given/When/Then, 3-5 items, edge/error coverage | Normalize AC to G/W/T; add missing edge/error cases; update Linear and comment | - |
| 5 Solution Optimization | 2025-best approach aligned with prior patterns | Rewrite Technical Notes and Tasks if better approach exists; cite modern patterns/libs; reference prior Story context; add TODO for duplicates/conflicts | Log rationale in Linear |
| 6 Library & Version | Current stable versions; prefer built-ins | Update versions in Technical Notes/Tasks; replace custom helpers with built-ins; update Linear and comment | List versions checked |
| 7 Test Strategy | Section exists but remains empty now | Ensure Test Strategy section present; leave empty with note that testing is planned later by ln-350; do not add coverage details | Mention "testing handled later; not evaluated in this phase" |
| 8 Documentation Integration | No standalone doc tasks | Remove doc-only tasks; fold doc updates into implementation tasks and DoD; update Linear and comment | - |
| 9 Story Size & Granularity | 3-8 tasks; 3-5h each | If <3 tasks invoke ln-310-story-decomposer; if >8 add TODO to split; flag tasks <3h or >8h with TODO; reload metadata and update kanban_board.md | Comment creation source |
| 10 Test Task Cleanup | No premature test tasks | Cancel/remove tasks labeled as tests or named test/comprehensive/final; remove from Story/kanban; comment that testing tasks appear later | Testing not executed now |
| 11 YAGNI | No premature features | Move speculative items to Out of Scope/Future; update Technical Notes/Tasks; comment rationale | - |
| 12 KISS | Simplest solution within standards | Replace over-engineered parts with simpler options unless standards require otherwise; update Linear with reasoning | Standard overrides simplicity |
| 13 Documentation Links | Technical Notes reference docs | Add "Related Documentation" subsection; link guides/manuals/ADRs by path; update Linear | Use created/existing paths |
| 14 Foundation-First Order | Task order DB -> Repo -> Service -> API -> Frontend | Reorder Implementation Tasks and note execution order; update Linear and comment | - |
| 15 Code Quality Basics | No magic values; config approach defined | Add TODOs for constants/config/env creds; describe config management in Technical Notes; update Linear | Warn in summary if TODOs remain |
| 16 Industry Standards | Compliance with RFCs/protocols | Check docs in guides/manuals/ADRs; if missing invoke creators; document compliance and links; if none apply, state explicit reason; update Linear | Evidence required: doc path or worker call; log skip reason if applicable |
