Draftify PPT Generator

Overview

This skill transforms analyzed project data into a structured PowerPoint planning document (기획서) following the standard 10-section format. It is invoked by the /auto-draft skill during Phase 4 of the document generation workflow.

Note: All sections (01-10) are generated by Phase 3 agents; this skill only renders PPT from markdown.

Input Requirements

The skill expects the following files to exist in the project's output directory:

outputs/<project-name>/
?? screenshots/                    # Captured screen images
?? analysis/
?  ?? analyzed-structure.json      # Consolidated analysis data
?? sections/
?  ?? 01-cover.md                  # Cover
?  ?? 02-revision-history.md       # Revision history
?  ?? 03-table-of-contents.md      # Table of contents
?  ?? 04-section-divider.md        # Section divider pages
?  ?? 05-glossary.md               # Glossary
?  ?? 06-policy-definition.md      # Policies
?  ?? 07-process-flow.md           # Process flow
?  ?? 08-screen-definition.md      # Screen definitions
?  ?? 09-references.md             # References (optional)
?  ?? 10-eod.md                    # End of document
?? validation/
   ?? validation-report.md         # Quality validation results

Output

Generates <project>-draft-V{version}.pptx in the project output directory:

outputs/<project-name>/
└─ <project>-draft-V{version}.pptx

Note: Filename is normalized from project metadata (spaces -> hyphens, lowercased) and version is taken from analyzed-structure.json.

Document Structure

The generated PPT follows the 10-section structure defined in docs/design/auto-draft-guideline.md:

Generation Workflow

1. Read analyzed data: Load analyzed-structure.json and all section markdown files (01-10)
2. Parse section markdown: Convert each section into slide-ready structures
3. Render slides: Build slides based on section markdown content
4. Insert screenshots: Embed captured screenshots in screen definition slides
5. Apply template styling: Use assets/ppt_template.pptx as base
6. Save output: Write <project>-draft-V{version}.pptx

ID Scheme Compliance

All IDs must follow the scheme defined in the guideline:

• Policy IDs: POL-{CATEGORY}-{SEQ} (e.g., POL-AUTH-001)
• Screen IDs: SCR-{SEQ} (e.g., SCR-001)
• Element IDs: {TYPE}-{SEQ} (e.g., BTN-001, FORM-001)
• API IDs: API-{SEQ} (e.g., API-001)

Screen Definition Slide Layout

Each screen definition uses 1-2 slides with this structure:

Slide 1 (Required):

• Screen ID and name (header)
• Screenshot image (left 60%)
• Basic info panel (right 40%): purpose, entry/exit conditions

Slide 2 (If needed):

• UI element table
• Process flow within screen
• Related policies (POL-* references)

Usage by /auto-draft

The /auto-draft skill invokes this skill via Skill tool:

Task: Generate final PPT document
Input: outputs/<project-name>/ directory path
Timeout: 10 minutes

Error Handling

• Missing section files: Generate placeholder slide with warning
• Missing screenshots: Use placeholder image with screen ID
• Invalid IDs: Log warning, continue generation
• Template errors: Fall back to basic slide layout

Resources

scripts/

• generate_ppt.py: Main PPT generation script using python-pptx

docs/design/

• auto-draft-guideline.md: Complete specification for document structure and ID schemes

assets/

• ppt_template.pptx: PowerPoint template with predefined layouts and styling
• JOURNEYITSELF-BOLD 3.TTF: Bold font for headers
• JOURNEYITSELF-REGULAR 3.TTF: Regular font for body text
• JOURNEYITSELF-LIGHT 3.TTF: Light font for captions

Dependencies

• Python 3.8+
• python-pptx library
• Pillow (for image processing)