Auto-Draft Skill

Overview

This skill is the main entry point for the Draftify auto-draft system. It coordinates the entire document generation workflow:

1. Phase 1-3.5: Invokes auto-draft-orchestrator agent for data collection, analysis, and section generation
2. Phase 4: Calls /draftify-ppt skill to generate the final PowerPoint document

Usage

/auto-draft <URL> [options]

Required Arguments

Optional Arguments

Workflow

/auto-draft invoked
    │
    ▼
┌─────────────────────────────────────┐
│ 1. Argument Validation              │
│    - Validate URL format            │
│    - Check file paths exist         │
│    - Set default values             │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│ 2. Invoke Orchestrator (Phase 1-3.5)│
│    - Task tool call                 │
│    - auto-draft-orchestrator agent  │
│    - Timeout: 25 minutes            │
└─────────────────────────────────────┘
    │
    │ Orchestrator returns:
    │ - projectName
    │ - outputDir
    │ - validation result
    │
    ▼
┌─────────────────────────────────────┐
│ 3. Call /draftify-ppt (Phase 4)     │
│    - Skill tool call                │
│    - Generate <project>-draft-V{version}.pptx      │
│    - Timeout: 10 minutes            │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│ 4. Return Results                   │
│    - Output file path               │
│    - Success/failure status         │
│    - Validation summary             │
└─────────────────────────────────────┘

Implementation

Step 1: Argument Validation

// Validate required URL
if (!url || !isValidUrl(url)) {
  throw new Error("Valid URL is required");
}

// Validate optional file paths
if (prd && !fileExists(prd)) {
  throw new Error(`PRD file not found: ${prd}`);
}

// Set defaults
const config = {
  url,
  prd: prd || null,
  sdd: sdd || null,
  readme: readme || null,
  screenshots: screenshots || null,
  sourceDir: sourceDir || null,
  urls: urls || null,
  output: output || null,
  maxDepth: maxDepth || 5,
  maxPages: maxPages || 50,
  record: record || false
};

Step 2: Invoke Orchestrator

const orchestratorResult = await Task({
  subagent_type: "general-purpose",
  description: "Execute auto-draft workflow Phase 1-3.5",
  prompt: `You are the auto-draft-orchestrator agent.

Read the orchestrator agent prompt from docs/design/agents/orchestrator.md.

**Configuration**:
${JSON.stringify(config, null, 2)}

Execute Phase 1-3.5 of the auto-draft workflow:
- Phase 1: Input collection (crawling + file reading)
- Phase 2: Analysis (input-analyzer)
- Phase 3-1: Prerequisite sections (policy + glossary, parallel)
- Phase 3-2: Dependent sections (screen → process, sequential)
- Phase 3.5: Quality validation

Return the project output directory path and validation result when complete.
  `,
  timeout: 1500000  // 25 minutes
});

Step 3: Call /draftify-ppt (Phase 4)

// Extract output directory from orchestrator result
const outputDir = orchestratorResult.outputDir;

// Call draftify-ppt skill for Phase 4
const pptResult = await Skill({
  skill: "draftify-ppt",
  args: outputDir
});

Step 4: Return Results

return {
  success: true,
  outputDir: outputDir,
  // Filename normalized from project metadata (spaces -> hyphens, lowercased)
  pptFile: `${outputDir}/${projectName}-draft-V${version}.pptx`,
  validation: orchestratorResult.validation
};

Note: projectName and version should be read from analyzed-structure.json to match the draftify-ppt filename normalization.

Error Handling

Orchestrator Failure

If Phase 1-3.5 fails:

• Return partial results if any sections were generated
• Include error message in response
• Skip Phase 4 if no sections exist

PPT Generation Failure

If Phase 4 fails:

• Return markdown sections as fallback
• Attempt HTML generation as alternative
• Include error message in response

Output Structure

Upon successful completion:

outputs/<project-name>/
+-- screenshots/
|   +-- *.png
+-- analysis/
|   +-- crawling-result.json
|   +-- analyzed-structure.json
+-- sections/
|   +-- 01-cover.md
|   +-- 02-revision-history.md
|   +-- 03-table-of-contents.md
|   +-- 04-section-divider.md
|   +-- 05-glossary.md
|   +-- 06-policy-definition.md
|   +-- 07-process-flow.md
|   +-- 08-screen-definition.md
|   +-- 09-references.md (optional)
|   +-- 10-eod.md
+-- validation/
|   +-- validation-report.md
+-- <project>-draft-V{version}.pptx    // Generated by /draftify-ppt

Timeout Budget

Examples

Basic Usage

/auto-draft https://my-todo-app.com

With PRD Document

/auto-draft https://my-todo-app.com --prd docs/prd.md

With Screenshots Only (No Crawling)

/auto-draft https://my-todo-app.com --screenshots ./screens/

Full Options

/auto-draft https://my-shop.com \
  --prd docs/prd.md \
  --sdd docs/sdd.md \
  --screenshots ./screens/ \
  --source-dir ./src/ \
  --max-pages 30

Related Documents

• Orchestrator: [docs/design/agents/orchestrator.md](../../docs/design/agents/orchestrator.md)
• Workflow: [docs/design/workflow.md](../../docs/design/workflow.md)
• PPT Generator: [.claude/skills/draftify-ppt/SKILL.md](../draftify-ppt/SKILL.md)