planflow-plugin 0.1.1 → 0.1.2

package/commands/pfSyncPush/SKILL.md

@@ -193,22 +193,191 @@ echo "Tasks: $TASKS_COUNT, Completed: $COMPLETED_COUNT, Progress: $PROGRESS%"
  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 ```
 
-**If tasksCount is 0 or null, show warning card:**
+**If tasksCount is 0 or null, run automatic format validation (Step 3d):**
+
+## Step 3d: Automatic Format Validation (if tasksCount is 0)
+
+**CRITICAL: If no tasks were parsed, automatically validate and fix the format!**
+
+When tasksCount is 0, you MUST:
+
+1. **Read PROJECT_PLAN.md and scan for potential tasks**
+2. **Check for common format issues**
+3. **Offer to auto-fix if fixable**
+
+### Format Detection Logic
+
+```javascript
+// Read the plan content
+const planContent = readFile("PROJECT_PLAN.md")
+
+// Check for tasks in various formats
+const validHeaderFormat = /^#{2,4}\s*\*{0,2}T\d+[A-Za-z]?\.\d+\*{0,2}[:\s]+.+/gm
+const validTableFormat = /\|\s*T\d+[A-Za-z]?\.\d+\s*\|/g
+
+// Check for INVALID formats (common mistakes)
+const wrongFormat1 = /^[-*]\s*T\d+[A-Za-z]?\.\d+[:\s]+.+/gm  // Bullet list format
+const wrongFormat2 = /^\d+\.\s*T\d+[A-Za-z]?\.\d+[:\s]+.+/gm // Numbered list format
+const wrongFormat3 = /^T\d+[A-Za-z]?\.\d+[:\s]+.+/gm         // No header prefix
+
+const validTasks = (planContent.match(validHeaderFormat) || []).length +
+                   (planContent.match(validTableFormat) || []).length
+const invalidTasks = (planContent.match(wrongFormat1) || []).length +
+                     (planContent.match(wrongFormat2) || []).length +
+                     (planContent.match(wrongFormat3) || []).length
+
+if (invalidTasks > 0 && validTasks === 0) {
+  // Tasks exist but in wrong format - offer to fix
+  showFormatFixCard()
+} else if (validTasks === 0 && invalidTasks === 0) {
+  // No tasks at all
+  showNoTasksCard()
+}
+```
+
+### If wrong format detected, show fix offer card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  FORMAT ISSUE DETECTED                                                   │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Found {invalidTasks} tasks in incorrect format.                             │
+│                                                                              │
+│  ── Current Format (incorrect) ─────────────────────────────────────────     │
+│                                                                              │
+│  - T1.1: Task Name           ❌ Bullet list not supported                    │
+│  1. T1.2: Another Task       ❌ Numbered list not supported                  │
+│  T1.3: Direct task           ❌ Missing header prefix                        │
+│                                                                              │
+│  ── Required Format ────────────────────────────────────────────────────     │
+│                                                                              │
+│  #### T1.1: Task Name        ✅ Header format                                │
+│  - [ ] **Status**: TODO                                                      │
+│  - **Complexity**: Low                                                       │
+│  - **Dependencies**: None                                                    │
+│                                                                              │
+│  OR table format:                                                            │
+│  | ID    | Task      | Complexity | Status | Dependencies |                 │
+│  |-------|-----------|------------|--------|--------------|                 │
+│  | T1.1  | Task Name | Low        | TODO   | -            |                 │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  🔧 Would you like me to auto-fix the format?                                │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Use AskUserQuestion:**
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Would you like me to convert tasks to the correct format?",
+    header: "Fix Format",
+    multiSelect: false,
+    options: [
+      {
+        label: "Yes, auto-fix (Recommended)",
+        description: "Convert all tasks to header format and re-sync"
+      },
+      {
+        label: "No, I'll fix manually",
+        description: "Keep current format, sync without tasks"
+      }
+    ]
+  }]
+})
+```
+
+### If user chooses auto-fix:
+
+**Convert tasks to correct format:**
+
+```javascript
+// Find all tasks in wrong format and convert
+let fixedContent = planContent
+
+// Convert bullet format: "- T1.1: Task" → "#### T1.1: Task\n- [ ] **Status**: TODO\n- **Complexity**: Medium\n- **Dependencies**: None"
+fixedContent = fixedContent.replace(
+  /^[-*]\s*(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)$/gm,
+  (match, taskId, taskName) => {
+    return `#### ${taskId}: ${taskName}
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: None`
+  }
+)
+
+// Convert numbered format: "1. T1.1: Task" → header format
+fixedContent = fixedContent.replace(
+  /^\d+\.\s*(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)$/gm,
+  (match, taskId, taskName) => {
+    return `#### ${taskId}: ${taskName}
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: None`
+  }
+)
+
+// Convert plain format: "T1.1: Task" → header format
+fixedContent = fixedContent.replace(
+  /^(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)$/gm,
+  (match, taskId, taskName) => {
+    return `#### ${taskId}: ${taskName}
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: None`
+  }
+)
+
+// Write fixed content
+writeFile("PROJECT_PLAN.md", fixedContent)
+```
+
+**After fixing, re-push automatically:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  🔧 FORMAT FIXED                                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Converted {fixedCount} tasks to correct format.                             │
+│                                                                              │
+│  Re-syncing to cloud...                                                      │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+Then repeat Step 3b (API call) with the fixed content.
+
+### If no tasks found at all:
 
 ```
 ╭──────────────────────────────────────────────────────────────────────────────╮
-│  ⚠️  WARNING                                                                  │
+│  ⚠️  NO TASKS FOUND                                                          │
 ├──────────────────────────────────────────────────────────────────────────────┤
 │                                                                              │
-│  No tasks were parsed from the plan.                                         │
+│  The plan was synced but no tasks were detected.                             │
+│                                                                              │
+│  Your plan may be missing the Tasks section.                                 │
+│                                                                              │
+│  ── Expected Task Format ───────────────────────────────────────────────     │
+│                                                                              │
+│  ## Tasks & Implementation Plan                                              │
 │                                                                              │
-│  This could mean:                                                            │
-│  • The plan format is not recognized                                         │
-│  • Tasks should use format: #### T1.1: Task Name                             │
-│  • Or table format: | T1.1 | Task Name | Low | TODO | - |                    │
+│  ### Phase 1: Foundation                                                     │
+│                                                                              │
+│  #### T1.1: Setup Project                                                    │
+│  - [ ] **Status**: TODO                                                      │
+│  - **Complexity**: Low                                                       │
+│  - **Dependencies**: None                                                    │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
 │                                                                              │
 │  💡 {t.ui.labels.nextSteps}                                                  │
-│     • /planNext              Verify your plan format                         │
+│     • /planNew               Create a new plan with tasks                    │
+│     • Manually add tasks in the format shown above                           │
 │                                                                              │
 ╰──────────────────────────────────────────────────────────────────────────────╯
 ```

package/commands/planFormatCheck/SKILL.md

@@ -0,0 +1,346 @@
+---
+name: planFormatCheck
+description: Validate and fix PROJECT_PLAN.md task format
+---
+
+# Plan Format Check
+
+Validate PROJECT_PLAN.md format and automatically fix any issues to ensure cloud sync compatibility.
+
+## Usage
+
+```bash
+/planFormatCheck              # Check format and show issues
+/planFormatCheck --fix        # Automatically fix format issues
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const localConfigPath = "./.plan-config.json"
+  let localConfig = {}
+  if (fileExists(localConfigPath)) {
+    try { localConfig = JSON.parse(readFile(localConfigPath)) } catch {}
+  }
+
+  const globalConfigPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  let globalConfig = {}
+  if (fileExists(globalConfigPath)) {
+    try { globalConfig = JSON.parse(readFile(globalConfigPath)) } catch {}
+  }
+
+  return { ...globalConfig, ...localConfig }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Parse Arguments
+
+```javascript
+const args = commandArgs.trim().split(/\s+/)
+const autoFix = args.includes("--fix")
+```
+
+## Step 2: Read and Analyze Plan
+
+```javascript
+// Check if PROJECT_PLAN.md exists
+if (!fileExists("PROJECT_PLAN.md")) {
+  showNoPlanCard()
+  return
+}
+
+const planContent = readFile("PROJECT_PLAN.md")
+```
+
+### Format Detection Patterns
+
+```javascript
+// VALID formats (will be parsed by API)
+const validHeaderPattern = /^#{2,4}\s*\*{0,2}(T\d+[A-Za-z]?\.\d+)\*{0,2}[:\s]+(.+)/gm
+const validTablePattern = /\|\s*(T\d+[A-Za-z]?\.\d+)\s*\|/g
+
+// INVALID formats (won't be parsed)
+const bulletPattern = /^[-*]\s*(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)/gm
+const numberedPattern = /^\d+\.\s*(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)/gm
+const plainPattern = /^(T\d+[A-Za-z]?\.\d+)[:\s]+([^|\n]+)$/gm
+
+// Count tasks in each format
+const validHeaderTasks = [...planContent.matchAll(validHeaderPattern)]
+const validTableTasks = [...planContent.matchAll(validTablePattern)]
+const bulletTasks = [...planContent.matchAll(bulletPattern)]
+const numberedTasks = [...planContent.matchAll(numberedPattern)]
+const plainTasks = [...planContent.matchAll(plainPattern)]
+
+const totalValid = validHeaderTasks.length + validTableTasks.length
+const totalInvalid = bulletTasks.length + numberedTasks.length + plainTasks.length
+```
+
+## Step 3: Show Analysis Results
+
+### All formats valid - success card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ FORMAT CHECK PASSED                                                      │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Your PROJECT_PLAN.md format is correct!                                     │
+│                                                                              │
+│  ── Task Summary ───────────────────────────────────────────────────────     │
+│                                                                              │
+│  📊 Total tasks found:    {totalValid}                                       │
+│  📝 Header format:        {validHeaderTasks.length}                          │
+│  📋 Table format:         {validTableTasks.length}                           │
+│                                                                              │
+│  ── Format Details ─────────────────────────────────────────────────────     │
+│                                                                              │
+│  ✅ All tasks use valid format                                               │
+│  ✅ Ready for cloud sync                                                     │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfSyncPush          Push to cloud                                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+### Issues found - warning card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  FORMAT ISSUES FOUND                                                     │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Found {totalInvalid} tasks in incorrect format.                             │
+│                                                                              │
+│  ── Current Status ─────────────────────────────────────────────────────     │
+│                                                                              │
+│  ✅ Valid tasks:           {totalValid}                                      │
+│  ❌ Invalid tasks:         {totalInvalid}                                    │
+│                                                                              │
+│  ── Issues Detected ────────────────────────────────────────────────────     │
+│                                                                              │
+│  {bulletTasks.length > 0 ? "• Bullet format (- T1.1: ...): " + bulletTasks.length + " tasks" : ""}
+│  {numberedTasks.length > 0 ? "• Numbered format (1. T1.1: ...): " + numberedTasks.length + " tasks" : ""}
+│  {plainTasks.length > 0 ? "• Plain format (T1.1: ...): " + plainTasks.length + " tasks" : ""}
+│                                                                              │
+│  ── Invalid Tasks ──────────────────────────────────────────────────────     │
+│                                                                              │
+│  {Show first 5 invalid tasks as examples}                                    │
+│                                                                              │
+│  ── Required Format ────────────────────────────────────────────────────     │
+│                                                                              │
+│  Header format:                                                              │
+│  #### T1.1: Task Name                                                        │
+│  - [ ] **Status**: TODO                                                      │
+│  - **Complexity**: Low                                                       │
+│  - **Dependencies**: None                                                    │
+│                                                                              │
+│  OR table format:                                                            │
+│  | ID   | Task      | Complexity | Status | Deps |                          │
+│  |------|-----------|------------|--------|------|                          │
+│  | T1.1 | Task Name | Low        | TODO   | -    |                          │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /planFormatCheck --fix    Auto-fix all issues                          │
+│     • Fix manually using the format shown above                              │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 4: Auto-Fix (if --fix flag)
+
+If `--fix` flag is provided and there are invalid tasks:
+
+### Convert all invalid formats to header format:
+
+```javascript
+let fixedContent = planContent
+let fixedCount = 0
+
+// Convert bullet format: "- T1.1: Task" → header format
+fixedContent = fixedContent.replace(
+  /^([-*])\s*(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)$/gm,
+  (match, bullet, taskId, taskName) => {
+    fixedCount++
+    return `#### ${taskId}: ${taskName.trim()}
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: None`
+  }
+)
+
+// Convert numbered format: "1. T1.1: Task" → header format
+fixedContent = fixedContent.replace(
+  /^(\d+)\.\s*(T\d+[A-Za-z]?\.\d+)[:\s]+(.+)$/gm,
+  (match, num, taskId, taskName) => {
+    fixedCount++
+    return `#### ${taskId}: ${taskName.trim()}
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: None`
+  }
+)
+
+// Convert plain format: "T1.1: Task" → header format (only at line start, not in tables)
+fixedContent = fixedContent.replace(
+  /^(T\d+[A-Za-z]?\.\d+)[:\s]+([^|\n]+)$/gm,
+  (match, taskId, taskName) => {
+    // Skip if this looks like it might be part of a table (has | nearby)
+    if (taskName.includes('|')) return match
+    fixedCount++
+    return `#### ${taskId}: ${taskName.trim()}
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: None`
+  }
+)
+
+// Write fixed content
+writeFile("PROJECT_PLAN.md", fixedContent)
+```
+
+### Show fix success card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ FORMAT FIXED                                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Successfully converted {fixedCount} tasks to correct format!                │
+│                                                                              │
+│  ── Changes Made ───────────────────────────────────────────────────────     │
+│                                                                              │
+│  • Converted bullet format tasks to header format                            │
+│  • Converted numbered list tasks to header format                            │
+│  • Converted plain format tasks to header format                             │
+│  • Added Status, Complexity, and Dependencies fields                         │
+│                                                                              │
+│  ── Before → After ─────────────────────────────────────────────────────     │
+│                                                                              │
+│  BEFORE:                                                                     │
+│  - T1.1: Setup project                                                       │
+│                                                                              │
+│  AFTER:                                                                      │
+│  #### T1.1: Setup project                                                    │
+│  - [ ] **Status**: TODO                                                      │
+│  - **Complexity**: Medium                                                    │
+│  - **Dependencies**: None                                                    │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • Review the changes in PROJECT_PLAN.md                                  │
+│     • Update Status/Complexity/Dependencies as needed                        │
+│     • /pfSyncPush          Push to cloud                                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Error Handling
+
+### No PROJECT_PLAN.md found:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  No PROJECT_PLAN.md found in current directory.                              │
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /planNew             Create a new project plan                         │
+│     • cd to your project directory and try again                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+### No tasks found at all:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  NO TASKS FOUND                                                          │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  No tasks were found in PROJECT_PLAN.md.                                     │
+│                                                                              │
+│  Your plan may be missing the Tasks section entirely.                        │
+│                                                                              │
+│  ── Add Tasks Using This Format ────────────────────────────────────────     │
+│                                                                              │
+│  ## Tasks & Implementation Plan                                              │
+│                                                                              │
+│  ### Phase 1: Foundation                                                     │
+│                                                                              │
+│  #### T1.1: Setup Project                                                    │
+│  - [ ] **Status**: TODO                                                      │
+│  - **Complexity**: Low                                                       │
+│  - **Dependencies**: None                                                    │
+│  - **Description**:                                                          │
+│    - Initialize the project structure                                        │
+│    - Configure development tools                                             │
+│                                                                              │
+│  #### T1.2: Configure Database                                               │
+│  - [ ] **Status**: TODO                                                      │
+│  - **Complexity**: Medium                                                    │
+│  - **Dependencies**: T1.1                                                    │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /planNew             Create a new plan with tasks                      │
+│     • Add tasks manually in the format shown above                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Valid Format Reference
+
+### Header Format (Preferred)
+
+```markdown
+#### T1.1: Task Name
+- [ ] **Status**: TODO
+- **Complexity**: Low
+- **Estimated**: 2 hours
+- **Dependencies**: None
+- **Description**:
+  - Detail 1
+  - Detail 2
+
+#### T1.2: Another Task
+- [x] **Status**: DONE
+- **Complexity**: Medium
+- **Dependencies**: T1.1
+```
+
+Status values: `TODO`, `IN_PROGRESS`, `DONE`, `BLOCKED`
+Complexity values: `Low`, `Medium`, `High`
+
+### Table Format (Alternative)
+
+```markdown
+| ID    | Task           | Complexity | Status | Dependencies |
+|-------|----------------|------------|--------|--------------|
+| T1.1  | Setup Project  | Low        | TODO   | -            |
+| T1.2  | Add Database   | Medium     | TODO   | T1.1         |
+| T1.3  | Create API     | High       | TODO   | T1.1, T1.2   |
+```
+
+### Task ID Format
+
+Valid task IDs:
+- `T1.1`, `T1.2`, `T2.1` - Standard format
+- `T5A.1`, `T5A.2`, `T5B.1` - Sub-phase format
+- `T10.1`, `T10.15` - Multi-digit phases
+
+Invalid task IDs:
+- `Task1`, `T-1.1`, `T1-1` - Wrong format

package/commands/planSpec/SKILL.md

@@ -694,60 +694,122 @@ try {
    ```
 
 **Task generation from features:**
+
+**CRITICAL: Use this EXACT markdown format for each task!**
+
+```markdown
+#### T{phase}.{num}: {Task Name}
+- [ ] **Status**: TODO
+- **Complexity**: Low/Medium/High
+- **Dependencies**: None (or T1.1, T1.2)
+- **Description**:
+  - Detail from specification
+  - Implementation notes
+```
+
+**Example generated tasks:**
+
+```markdown
+#### T2.1: Implement User Authentication
+- [ ] **Status**: TODO
+- **Complexity**: High
+- **Dependencies**: T1.2
+- **Description**:
+  - Setup JWT authentication
+  - Implement login/register endpoints
+  - Add password hashing
+
+#### T2.2: Create User Dashboard
+- [ ] **Status**: TODO
+- **Complexity**: Medium
+- **Dependencies**: T2.1
+- **Description**:
+  - Build dashboard layout
+  - Display user statistics
+  - Add navigation menu
+```
+
+**Pseudo-code for task generation:**
 ```javascript
+function generateTaskMarkdown(taskId, name, complexity, dependencies, description) {
+  const depStr = dependencies.length > 0 ? dependencies.join(", ") : "None"
+  const descLines = description.map(d => `  - ${d}`).join("\n")
+
+  return `#### ${taskId}: ${name}
+- [ ] **Status**: TODO
+- **Complexity**: ${complexity}
+- **Dependencies**: ${depStr}
+- **Description**:
+${descLines}`
+}
+
 function generateTasks(features, phase) {
   const tasks = []
   let taskNum = 1
 
   for (const feature of features) {
-    // Simple feature → 1 task
-    // Complex feature → 2-3 tasks
-
     const complexity = estimateComplexity(feature)
 
     if (complexity === "High") {
       // Split into multiple tasks
-      tasks.push({
-        id: `T${phase}.${taskNum}`,
-        name: `Setup ${feature.name}`,
-        complexity: "Medium",
-        status: "TODO"
-      })
+      tasks.push(generateTaskMarkdown(
+        `T${phase}.${taskNum}`,
+        `Setup ${feature.name}`,
+        "Medium",
+        taskNum > 1 ? [`T${phase}.${taskNum-1}`] : [],
+        ["Initialize component structure", "Setup dependencies"]
+      ))
       taskNum++
 
-      tasks.push({
-        id: `T${phase}.${taskNum}`,
-        name: `Implement ${feature.name} core logic`,
-        complexity: "High",
-        status: "TODO",
-        dependencies: [`T${phase}.${taskNum-1}`]
-      })
+      tasks.push(generateTaskMarkdown(
+        `T${phase}.${taskNum}`,
+        `Implement ${feature.name} core logic`,
+        "High",
+        [`T${phase}.${taskNum-1}`],
+        ["Implement business logic", "Add validation", "Handle edge cases"]
+      ))
       taskNum++
 
-      tasks.push({
-        id: `T${phase}.${taskNum}`,
-        name: `${feature.name} UI and integration`,
-        complexity: "Medium",
-        status: "TODO",
-        dependencies: [`T${phase}.${taskNum-1}`]
-      })
+      tasks.push(generateTaskMarkdown(
+        `T${phase}.${taskNum}`,
+        `${feature.name} UI and integration`,
+        "Medium",
+        [`T${phase}.${taskNum-1}`],
+        ["Build UI components", "Connect to backend", "Add error handling"]
+      ))
       taskNum++
     } else {
-      // Single task
-      tasks.push({
-        id: `T${phase}.${taskNum}`,
-        name: `Implement ${feature.name}`,
-        complexity: complexity,
-        status: "TODO"
-      })
+      tasks.push(generateTaskMarkdown(
+        `T${phase}.${taskNum}`,
+        `Implement ${feature.name}`,
+        complexity,
+        [],
+        feature.description ? [feature.description] : ["Implement feature as specified"]
+      ))
       taskNum++
     }
   }
 
-  return tasks
+  return tasks.join("\n\n")
 }
 ```
 
+**IMPORTANT: Never use these WRONG formats:**
+```markdown
+❌ - T2.1: Task Name         (bullet format - won't parse)
+❌ 1. T2.1: Task Name        (numbered format - won't parse)
+❌ T2.1: Task Name           (plain format - won't parse)
+❌ ## T2.1: Task Name        (wrong header level)
+```
+
+**Always use this CORRECT format:**
+```markdown
+✅ #### T2.1: Task Name
+✅ - [ ] **Status**: TODO
+✅ - **Complexity**: Medium
+✅ - **Dependencies**: T2.0
+```
+
 **Write the file:**
 ```javascript
 const outputPath = `./${outputFileName}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planflow-plugin",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "PlanFlow CLI plugin for Claude Code - slash commands for project planning",
   "author": "PlanFlow <hello@planflow.tools>",
   "license": "MIT",