planexportjson - SKILL.md Agent Skill

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

/planExportJson

Step 0: Load Configuration

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

{
  "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 Output:

Writing JSON export...

✅ 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

❌ 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.