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

skills/create-plan/codex/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 native discovery (Codex: `~/.agents/skills/`).
 - Deprecated CLI wrappers (for example, `superpowers-codex bootstrap` / `use-skill`) are not part of this workflow.
@@ -14,37 +16,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.
@@ -54,15 +65,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.
@@ -74,16 +88,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)
 ```
@@ -100,6 +117,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)