parallel-prompt-generator

Prompt Generator

Generate agent-ready prompts from existing task specification files in tasks/.

CRITICAL: Prompt Template Requirements

Every generated prompt file MUST include ALL of these sections (see Step 4 for full template):

Section	Purpose	Required
=== REQUIRED SKILLS ===	Skills to invoke at start	YES
=== CONTEXT ===	Shared project context	YES
=== OBJECTIVE ===	Task goal	YES
=== CONTRACTS ===	Contract file references	YES
=== FILES TO CREATE ===	Scope CREATE	YES
=== FILES TO MODIFY ===	Scope MODIFY	YES
=== DO NOT MODIFY ===	Scope BOUNDARY	YES
=== IMPLEMENTATION REQUIREMENTS ===	Requirements	YES
=== ACCEPTANCE CRITERIA ===	Checklist	YES
=== EXECUTION INSTRUCTIONS ===	How to implement	MANDATORY
=== IMPORTANT RULES ===	Constraints	MANDATORY
=== COMPLETION SIGNAL ===	touch .claude-task-complete	MANDATORY

DO NOT generate prompts without the EXECUTION INSTRUCTIONS, IMPORTANT RULES, and COMPLETION SIGNAL sections.

When to Use

• After editing task files in tasks/
• To regenerate prompts with updated template
• Before running cpo run if prompts are missing
• To test different prompt formats

Input Requirements

The parallel directory must have:

parallel/TS-XXXX-slug/
  manifest.json       # Required: wave structure, agents
  context.md          # Required: shared context
  contracts/          # Required: types.py, api-schema.yaml
  tasks/              # Required: task-*.md files
    task-001-users.md
    task-002-products.md

Output

Generates:

parallel/TS-XXXX-slug/
  prompts/
    agent-prompts.md   # Wave summary and launch commands
    task-001.txt       # Individual agent prompt
    task-002.txt
    ...

Workflow

flowchart TB
    Start[("tasks/ folder")]
    Read["1. Read manifest.json"]
    Context["2. Load context.md"]
    Parse["3. Parse each task file"]
    Generate["4. Generate task-NNN.txt"]
    Summary["5. Create agent-prompts.md"]
    Done[("prompts/ ready")]

    Start --> Read
    Read --> Context
    Context --> Parse
    Parse --> Generate
    Generate --> Summary
    Summary --> Done