planflow-plugin 0.1.0

package/commands/planExportCsv/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: planExportCsv
+description: Export PROJECT_PLAN.md tasks as a CSV file
+---
+
+# Plan Export to CSV
+
+Export PROJECT_PLAN.md tasks as a CSV file for spreadsheet applications.
+
+## Usage
+
+```bash
+/planExportCsv
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  if (fileExists("./.plan-config.json")) {
+    try { return JSON.parse(readFile("./.plan-config.json")) } catch {}
+  }
+  const globalPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalPath)) {
+    try { return JSON.parse(readFile(globalPath)) } catch {}
+  }
+  return { "language": "en" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Read PROJECT_PLAN.md
+
+If not found:
+```
+{t.commands.update.planNotFound}
+
+{t.commands.update.runPlanNew}
+```
+
+## Step 2: Parse Project Data
+
+Extract all task information.
+
+## Step 3: Create CSV Structure
+
+```csv
+Task ID,Task Name,Phase,Status,Complexity,Estimated Hours,Dependencies,Description
+T1.1,Project Setup,1,DONE,Low,2,None,"Initialize project..."
+T1.2,Database Setup,1,DONE,Medium,3,T1.1,"Setup PostgreSQL..."
+T1.3,Authentication,1,TODO,High,6,T1.2,"Implement JWT auth..."
+```
+
+**Important:** Escape commas and quotes in content properly.
+
+## Step 4: Write File
+
+Write to `project-plan.csv`
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Exported to: project-plan.csv                                               │
+│                                                                              │
+│  ── CSV Details ───────────────────────────────────────────────────────────  │
+│                                                                              │
+│  📊 Rows:      [X] tasks                                                     │
+│  📋 Columns:   8                                                             │
+│                                                                              │
+│  ── Use This For ──────────────────────────────────────────────────────────  │
+│                                                                              │
+│  • Excel/Sheets import                                                       │
+│  • Data analysis                                                             │
+│  • Project management tools                                                  │
+│  • Reporting                                                                 │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View file: cat project-plan.csv                                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Write Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Cannot write export file.                                                   │
+│                                                                              │
+│  Please check directory permissions and try again.                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/planExportGithub/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: planExportGithub
+description: Export PROJECT_PLAN.md tasks as GitHub Issues
+---
+
+# Plan Export to GitHub Issues
+
+Export PROJECT_PLAN.md tasks as GitHub Issues with labels and dependencies.
+
+## Usage
+
+```bash
+/planExportGithub
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  if (fileExists("./.plan-config.json")) {
+    try { return JSON.parse(readFile("./.plan-config.json")) } catch {}
+  }
+  const globalPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalPath)) {
+    try { return JSON.parse(readFile(globalPath)) } catch {}
+  }
+  return { "language": "en" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Read PROJECT_PLAN.md
+
+If not found:
+```
+{t.commands.update.planNotFound}
+
+{t.commands.update.runPlanNew}
+```
+
+## Step 2: Check Prerequisites
+
+### Check GitHub CLI
+```bash
+gh --version
+```
+
+**GitHub CLI Not Found Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.export.ghNotFound}                                              │
+│                                                                              │
+│  {t.commands.export.ghInstall}                                               │
+│  {t.commands.export.ghUrl}                                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+### Check Authentication
+```bash
+gh auth status
+```
+
+**Not Authenticated Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.export.ghNotAuth}                                               │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • {t.commands.export.ghAuthCommand}                                      │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+### Check Git Repository
+```bash
+git rev-parse --is-inside-work-tree
+```
+
+**Not a Git Repository Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  WARNING                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Not a Git repository.                                                       │
+│                                                                              │
+│  To export to GitHub Issues:                                                 │
+│     1. Initialize a Git repo: git init                                       │
+│     2. Create a GitHub repo: gh repo create                                  │
+│     3. Or run this command in an existing Git repo                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Parse Project Data
+
+Extract from PROJECT_PLAN.md:
+- Project name
+- All tasks (ID, name, status, complexity, estimate, dependencies, description)
+- Phases
+
+## Step 4: Create Labels
+
+Create these labels (if they don't exist):
+- `phase-1`, `phase-2`, `phase-3`, `phase-4`
+- `complexity-low`, `complexity-medium`, `complexity-high`
+- `status-todo`, `status-in-progress`, `status-done`, `status-blocked`
+- `plan-plugin`
+
+## Step 5: Create Issues
+
+For each task:
+
+### Issue Title Format
+```
+[Phase N] TX.Y: Task Name
+```
+
+### Issue Body Format
+```markdown
+## Task Details
+
+**Phase**: [N] - [Phase Name]
+**Complexity**: [Low/Medium/High]
+**Estimated Effort**: [X] hours
+**Status**: [TODO/IN_PROGRESS/DONE/BLOCKED]
+
+## Description
+
+[Full task description from plan]
+
+## Dependencies
+
+[List of dependency task IDs, or "None"]
+
+---
+
+*Exported from PROJECT_PLAN.md*
+*Created by plan-plugin*
+```
+
+### Create Issue Command
+```bash
+gh issue create \
+  --title "[Phase 1] T1.1: Project Setup" \
+  --body "$(cat <<'EOF'
+[Issue body content here]
+EOF
+)" \
+  --label "phase-1,complexity-low,status-todo,plan-plugin"
+```
+
+## Step 6: Show Progress
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  GitHub Issues created!                                                      │
+│                                                                              │
+│  ── Created Issues ────────────────────────────────────────────────────────  │
+│                                                                              │
+│  ✅ [Phase 1] T1.1: Project Setup (#1)                                       │
+│  ✅ [Phase 1] T1.2: Database Setup (#2)                                      │
+│  ✅ [Phase 1] T1.3: Authentication (#3)                                      │
+│  ...                                                                         │
+│                                                                              │
+│  ── Export Summary ────────────────────────────────────────────────────────  │
+│                                                                              │
+│  📋 Total Issues Created: 18                                                 │
+│                                                                              │
+│  🏷️  Labels Created:                                                         │
+│     • phase-1, phase-2, phase-3, phase-4                                     │
+│     • complexity-low, complexity-medium, complexity-high                     │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View all issues:                                                         │
+│     • gh issue list --label plan-plugin                                      │
+│     • https://github.com/user/repo/issues                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**GitHub CLI Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  gh command failed.                                                          │
+│                                                                              │
+│  [Error message from gh CLI]                                                 │
+│                                                                              │
+│  ── Possible Solutions ────────────────────────────────────────────────────  │
+│                                                                              │
+│  1. Authenticate: gh auth login                                              │
+│  2. Check repo access: gh repo view                                          │
+│  3. Verify network connection                                                │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/planExportJson/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: planExportJson
+description: Export PROJECT_PLAN.md as a structured JSON file
+---
+
+# Plan Export to JSON
+
+Export PROJECT_PLAN.md as a structured JSON file.
+
+## Usage
+
+```bash
+/planExportJson
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  if (fileExists("./.plan-config.json")) {
+    try { return JSON.parse(readFile("./.plan-config.json")) } catch {}
+  }
+  const globalPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalPath)) {
+    try { return JSON.parse(readFile(globalPath)) } catch {}
+  }
+  return { "language": "en" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Read PROJECT_PLAN.md
+
+If not found:
+```
+{t.commands.update.planNotFound}
+
+{t.commands.update.runPlanNew}
+```
+
+## Step 2: Parse Project Data
+
+Extract all project information:
+- Project name, description, type
+- Progress statistics
+- Tech stack
+- All phases and tasks
+
+## Step 3: Create JSON Structure
+
+```json
+{
+  "project": {
+    "name": "Project Name",
+    "description": "Project description",
+    "type": "Full-Stack / Backend / Frontend",
+    "status": "In Progress",
+    "progress": {
+      "total": 14,
+      "completed": 3,
+      "in_progress": 1,
+      "blocked": 0,
+      "percentage": 21
+    },
+    "created": "2026-01-26",
+    "updated": "2026-01-26"
+  },
+  "techStack": {
+    "frontend": ["React", "TypeScript", "Tailwind CSS"],
+    "backend": ["Node.js", "Express", "PostgreSQL"],
+    "devops": ["Docker", "GitHub Actions"],
+    "testing": ["Jest", "Playwright"]
+  },
+  "phases": [
+    {
+      "id": 1,
+      "name": "Foundation",
+      "tasks": [
+        {
+          "id": "T1.1",
+          "name": "Project Setup",
+          "status": "DONE",
+          "complexity": "Low",
+          "estimated_hours": 2,
+          "dependencies": [],
+          "description": "Initialize project structure...",
+          "phase": 1
+        }
+      ],
+      "progress": {
+        "total": 4,
+        "completed": 2,
+        "percentage": 50
+      }
+    }
+  ],
+  "exportedAt": "2026-01-26T12:00:00Z",
+  "exportedBy": "plan-plugin v1.2.0"
+}
+```
+
+## Step 4: Write File
+
+Write to `project-plan.json`
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Exported to: project-plan.json                                              │
+│                                                                              │
+│  ── Export Details ────────────────────────────────────────────────────────  │
+│                                                                              │
+│  📁 Project:  Task Manager                                                   │
+│  📋 Tasks:    18 total                                                       │
+│  🎯 Phases:   4                                                              │
+│  📄 Format:   JSON                                                           │
+│                                                                              │
+│  ── Use This File For ─────────────────────────────────────────────────────  │
+│                                                                              │
+│  • Custom integrations                                                       │
+│  • Data analysis                                                             │
+│  • Importing into other tools                                                │
+│  • Version control tracking                                                  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View file: cat project-plan.json                                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Write Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Cannot write export file.                                                   │
+│                                                                              │
+│  The file may be:                                                            │
+│     • In use by another program                                              │
+│     • In a read-only directory                                               │
+│     • Blocked by permissions                                                 │
+│                                                                              │
+│  Please check and try again.                                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/planExportSummary/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: planExportSummary
+description: Export PROJECT_PLAN.md as a condensed Markdown summary
+---
+
+# Plan Export to Summary
+
+Export PROJECT_PLAN.md as a condensed Markdown summary.
+
+## Usage
+
+```bash
+/planExportSummary
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  if (fileExists("./.plan-config.json")) {
+    try { return JSON.parse(readFile("./.plan-config.json")) } catch {}
+  }
+  const globalPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalPath)) {
+    try { return JSON.parse(readFile(globalPath)) } catch {}
+  }
+  return { "language": "en" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Read PROJECT_PLAN.md
+
+If not found:
+```
+{t.commands.update.planNotFound}
+
+{t.commands.update.runPlanNew}
+```
+
+## Step 2: Parse Project Data
+
+Extract summary information:
+- Overall progress
+- Current focus (next task, in progress, blocked)
+- Phase breakdown
+- Tech stack
+
+## Step 3: Create Summary Structure
+
+```markdown
+# [Project Name] - Summary
+
+**Type**: [Full-Stack/Backend/Frontend]
+**Progress**: [X]% complete ([Y]/[Z] tasks done)
+**Status**: [In Progress/Blocked/Complete]
+
+## Current Focus
+
+🎯 **Next Task**: T[X].[Y] - [Name]
+🔄 **In Progress**: [N] tasks
+🚫 **Blocked**: [M] tasks
+
+## Progress by Phase
+
+| Phase | Name | Progress | Status |
+|-------|------|----------|--------|
+| 1 | Foundation | █████░░░░░ 50% | In Progress |
+| 2 | Core Features | ░░░░░░░░░░ 0% | Not Started |
+| 3 | Advanced | ░░░░░░░░░░ 0% | Not Started |
+| 4 | Testing & Deploy | ░░░░░░░░░░ 0% | Not Started |
+
+## Task Checklist
+
+### Phase 1: Foundation
+- [x] T1.1: Project Setup (DONE)
+- [x] T1.2: Database Setup (DONE)
+- [ ] T1.3: Authentication (TODO)
+- [ ] T1.4: Basic API (TODO)
+
+### Phase 2: Core Features
+- [ ] T2.1: User CRUD (TODO)
+- [ ] T2.2: Dashboard (TODO)
+...
+
+## Tech Stack
+
+**Frontend**: [Frameworks]
+**Backend**: [Frameworks]
+**Database**: [Database]
+
+## Quick Stats
+
+- 📅 Started: [Date]
+- 📅 Updated: [Date]
+- ⏱️ Total Estimated: [X] hours
+- ✅ Completed: [Y] hours
+- 📋 Remaining: [Z] hours
+
+---
+
+*Generated by plan-plugin*
+*Full plan: PROJECT_PLAN.md*
+```
+
+## Step 4: Write File
+
+Write to `PROJECT_SUMMARY.md`
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Exported to: PROJECT_SUMMARY.md                                             │
+│                                                                              │
+│  ── Summary Includes ──────────────────────────────────────────────────────  │
+│                                                                              │
+│  • Overall progress                                                          │
+│  • Phase breakdown                                                           │
+│  • Task checklist                                                            │
+│  • Tech stack overview                                                       │
+│                                                                              │
+│  ── Use This For ──────────────────────────────────────────────────────────  │
+│                                                                              │
+│  • Quick project overview                                                    │
+│  • Sharing with team                                                         │
+│  • Status reports                                                            │
+│  • README updates                                                            │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View file: cat PROJECT_SUMMARY.md                                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Write Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Cannot write export file.                                                   │
+│                                                                              │
+│  Please check directory permissions and try again.                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```