feat(M2): Documentation flow, accuracy, consistency cleanup, and cross-platform shell portability

skills/create-plan/cursor/templates/milestone-plan.md

@@ -1,11 +1,13 @@
 # [Plan Title]
 
 ## Overview
+
 - **Goal:** [One sentence describing the end state]
 - **Created:** YYYY-MM-DD
 - **Status:** In Progress | Complete
 
 ## Planning Guardrails
+
 - This plan assumes design was validated before implementation planning.
 - Skills are invoked via workspace discovery (`.cursor/skills/`).
 - Milestones require verification + local commits + explicit approval before proceeding.
@@ -13,37 +15,46 @@
 ## Context
 
 ### Requirements
+
 [Gathered requirements from user questions]
 
 ### Constraints
+
 [Technical, business, or timeline constraints]
 
 ### Success Criteria
+
 [How we know this is complete]
 
 ## Architecture
 
 ### Design Decisions
+
 [Key architectural choices and rationale]
 
 ### Component Relationships
+
 [How pieces fit together]
 
 ### Data Flow
+
 [How data moves through the system]
 
 ## Milestones
 
 ### M1: [Name]
+
 **Description:** [What this milestone achieves]
 
 **Acceptance Criteria:**
+
 - [ ] [Criterion 1]
 - [ ] [Criterion 2]
 
 **Stories:** S-101, S-102, S-103...
 
 **Milestone Completion Rule (MANDATORY):**
+
 - Run lint/typecheck/tests for changed files.
 - Commit locally (DO NOT push).
 - Stop and ask user for feedback.
@@ -53,15 +64,18 @@
 ---
 
 ### M2: [Name]
+
 **Description:** [What this milestone achieves]
 
 **Acceptance Criteria:**
+
 - [ ] [Criterion 1]
 - [ ] [Criterion 2]
 
 **Stories:** S-201, S-202, S-203...
 
 **Milestone Completion Rule (MANDATORY):**
+
 - Run lint/typecheck/tests for changed files.
 - Commit locally (DO NOT push).
 - Stop and ask user for feedback.
@@ -73,16 +87,19 @@
 ## Technical Specifications
 
 ### Types & Interfaces
+
 ```typescript
 // Key type definitions (or equivalent language constructs)
 ```
 
 ### API Contracts
+
 ```typescript
 // Endpoint signatures, request/response shapes (if applicable)
 ```
 
 ### Constants & Enums
+
 ```typescript
 // Shared constants (if applicable)
 ```
@@ -99,6 +116,7 @@
 ## Related Plan Files
 
 This file is part of the plan folder under `ai_plan/`:
+
 - `original-plan.md` - Original approved plan (reference for original intent)
 - `final-transcript.md` - Final planning transcript (reference for rationale/context)
 - `milestone-plan.md` - This file (full specification)