| 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 via MCP Ref research | Call ref_search_documentation(query="[domain] best practices 2025"); rewrite Technical Notes if better approach found; cite RFC/standard number; add Linear comment with research evidence | Evidence: MCP Ref query + result summary |
| 6 Library & Version | Verify via Context7 + WebSearch | Call mcp__context7__get-library-docs(topic="version") for each library; if outdated, update to latest stable; log checked versions in Linear comment | Evidence: Context7 query + version comparison |
| 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 | MCP Ref verification mandatory | Call ref_search_documentation(query="[domain] RFC OWASP standard") BEFORE checking local docs; if RFC applies, verify Story complies; if local doc missing, invoke creators; add Linear comment with RFC reference or explicit "no standards apply" with reasoning | Evidence: MCP Ref query result or explicit skip reason |
| 17 Rate Limiting | API Stories must have Rate Limiting subsection | If API Story (keywords: endpoint, API, REST, GraphQL): check Rate Limiting in Technical Notes; if missing, add placeholder with TODO (Policy, Strategy, Headers, 429 Response); update Linear | Skip if internal service, no external API |
| 18 Auth/Security Pattern | Auth Stories must have Auth subsection | If Auth Story (keywords: auth, login, token, JWT, OAuth): check Authentication & Authorization in Technical Notes; if missing or generic, add TODO for token management, authorization model; update Linear | Skip if non-auth Story |
| 19 Error Handling Strategy | Story + all Tasks must have Error Handling | Check Story Technical Notes for Error Handling Strategy; check each Task for Error Handling Strategy section; add TODO placeholders if missing (error format, codes, retry, circuit breaker); update Linear | Mandatory for API Stories |
| 20 Logging & Observability | Story + all Tasks must have Logging | Check Story Technical Notes for Logging & Observability; check each Task for Logging Requirements section; add TODO placeholders if missing (log levels, format, audit trail, tracing); update Linear | Mandatory for all Stories |
