planning-doc-generator

Planning Document Generator Skill

Purpose

Generate structured assessment documents from JSON configuration. Converts project planning data into markdown assessment reports with purpose, stakeholder, and scope analysis plus a GO/NO-GO decision framework.

When to Use

• Creating project assessment documents
• Generating planning documentation from structured data
• Building evaluation reports with decision matrices
• Documenting project vision and scope
• Creating stakeholder alignment assessments
• Generating baseline project documentation

Input: JSON Format

The skill expects JSON input with the following structure:

{
  "project_name": "Project Name",
  "date": "2025-11-03",
  "why": {
    "exists": "Why does this project exist?",
    "problem": "What problem does it solve?",
    "vision": "What is the desired outcome?"
  },
  "who": {
    "stakeholders": "List of key stakeholders",
    "decision_makers": "Who decides",
    "executors": "Who does the work",
    "concerns": "Their priorities and concerns"
  },
  "what": {
    "building": "What are we building/changing?",
    "features": "Key features and components",
    "out_of_scope": "What is out of scope",
    "success_criteria": "Definition of success"
  },
  "go_no_go": {
    "purpose_clarity": "✓|⚠|✗",
    "stakeholder_alignment": "✓|⚠|✗",
    "scope_definition": "✓|⚠|✗",
    "resource_availability": "✓|⚠|✗",
    "timeline_feasibility": "✓|⚠|✗",
    "risk_assessment": "✓|⚠|✗",
    "success_metrics": "✓|⚠|✗"
  },
  "decision": "GO|CONDITIONAL|NO-GO",
  "rationale": "Explanation of decision"
}

Template Filling Process

1. Load templates/assessment-template.md
2. Replace all {PLACEHOLDER} values with JSON data
3. Calculate coverage: Count non-empty answers ÷ 17 questions
4. Insert status indicators (✓/⚠/✗) from GO/NO-GO section
5. Generate markdown with formatted decision matrix
6. Validate all sections populated with content (no {ANSWER} remaining)

Coverage Calculation