Campaign Orchestration skill

Orchestrates multi-deliverable campaigns by dispatching Designer and Video Producer workflows in parallel.

by pawbytes·MIT license·★ 114 Stars on the repo·GitHub ↗

Use now

Inside this skill

SKILL.md · the author's own words
# Campaign Orchestration

## Overview

This workflow is the **central orchestration engine** for the Aria Creative Suite. It takes a campaign brief containing multiple deliverabl…

**Args:** Supports `--headless` / `-H` for fully autonomous campaign execution without user interaction. Supports `--template:product-launc…

**Inputs:** Campaign brief (with deliverable list), brand guidelines, optional content calendar or strategy artifacts from Strategist.

**Outputs:** `status.md` (campaign progress tracker), specialist assignments, `design-manifest.json` and `video-manifest.json` from product…

Act as a campaign production manager who coordinates parallel workstreams. You understand creative production timelines, dependency analysi…

**Architectural context:** Designer and Video Producer are primary production agents that take briefs directly. Strategist is a service age…

Word-for-word excerpt, not a result. Read the full SKILL.md ↓

Files of Campaign Orchestration

pawbytes/main1 file shown
SKILL.md
Show the full text101 lines

Campaign Orchestration

Overview

This workflow is the central orchestration engine for the Aria Creative Suite. It takes a campaign brief containing multiple deliverables (social posts, carousels, videos, brand assets), parses them into production tasks, dispatches Designer and Video Producer workflows in parallel, tracks progress, aggregates results, and runs quality control across all produced assets.

Args: Supports --headless / -H for fully autonomous campaign execution without user interaction. Supports --template:product-launch for the product launch campaign variant (merged from cra-product-launch-campaign).

Inputs: Campaign brief (with deliverable list), brand guidelines, optional content calendar or strategy artifacts from Strategist.

Outputs: status.md (campaign progress tracker), specialist assignments, design-manifest.json and video-manifest.json from production workflows, qa-report.md from quality control, campaign completion report, daily log entries.

Act as a campaign production manager who coordinates parallel workstreams. You understand creative production timelines, dependency analysis, and how to keep multiple production tracks synchronized. Your job is coordination and progress tracking, not creative judgment — that belongs to the production agents.

Architectural context: Designer and Video Producer are primary production agents that take briefs directly. Strategist is a service agent — only invoke Strategist if a deliverable explicitly requires research, copy, or script writing that hasn't been provided. Never gate production on Strategist by default.

On Activation

Load available config from {project-root}/.pawbytes/config/config.yaml and {project-root}/.pawbytes/config/config.user.yaml (root level and cra section). If config is missing, let the user know paw-cra-setup can configure the module at any time. Resolve:

  • {user_name} (null) — address the user by name
  • {communication_language} (English) — use for all communications
  • {document_output_language} (English) — use for generated document content
  • {fal_key} — fal.ai API key (needed by production agents)
  • {elevenlabs_api_key} — ElevenLabs API key (optional, for video)
  • {output_directory} (.pawbytes/creative-suites) — base output path

Load shared agency memory from {project-root}/.pawbytes/creative-suites/index.md. Load brand guidelines from {project-root}/.pawbytes/creative-suites/brands/{brand-name}/guidelines.md.

Locate the campaign brief. Expected at {project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/brief.md. If not found, check if the user provided one inline or as a file path.

If --headless, execute all stages without interaction using the brief as-is. If --template:product-launch, load ./references/template-product-launch.md for the variant pipeline.

Otherwise, confirm the brief is loaded and present a summary of detected deliverables before proceeding.

Campaign Status File (Compaction Survival)

All progress is written to {project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/status.md. This file is both the output artifact and the recovery cache. Each stage updates it. After compaction, re-read this file plus the brief to recover full context.

---
campaign: '{campaign-name}'
brand: '{brand-name}'
status: 'in-progress'  # pending | in-progress | quality-gate | complete | failed
current_stage: '01-brief-parsing'
brief_path: './brief.md'
created: 'ISO-8601'
updated: 'ISO-8601'
deliverables_total: 0
deliverables_complete: 0
design_track: 'pending'
video_track: 'pending'
qc_status: 'pending'
---

Stages

Stage Purpose Reference
01 Brief Parsing Load ./references/01-brief-parsing.md
02 Dependency Analysis & Queue Build Load ./references/02-dependency-queue.md
03 Parallel Dispatch Load ./references/03-parallel-dispatch.md
04 Progress Tracking & Collection Load ./references/04-progress-collection.md
05 Quality Gate & Completion Load ./references/05-quality-completion.md

Progression: Each stage updates status.md with its results before loading the next stage. If interrupted, resume from the last completed stage by reading status.md.

External Skills & Workflows

Skill/Workflow When Invoked Purpose
paw-cra-agent-designer Stage 03 Dispatch design production (via Agent tool)
paw-cra-agent-video-producer Stage 03 Dispatch video production (via Agent tool)
paw-cra-agent-strategist Stage 02 (conditional) Only if deliverables require unresolved copy/scripts/research
paw-cra-quality-control Stage 05 Aggregate QC across all produced assets
paw-cra-multi-platform-export Stage 05 (conditional) Suggested if platform variants are needed post-QC

Invocation pattern: Use the Agent tool with the skill name in the prompt. For parallel dispatch in Stage 03, launch Designer and Video Producer agent groups simultaneously.

Memory Contract

Reads:

  • {project-root}/.pawbytes/creative-suites/index.md — agency state
  • {project-root}/.pawbytes/creative-suites/brands/{brand-name}/guidelines.md — brand identity
  • {project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/brief.md — campaign brief

Writes:

  • {project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/status.md — campaign progress
  • {project-root}/.pawbytes/creative-suites/daily/YYYY-MM-DD.md — daily log (append, tagged [Campaign])

Collects (from production agents):

  • design-manifest.json — from Designer workflows
  • video-manifest.json — from Video Producer workflows
  • qa-report.md — from quality control workflow
1---
2name: paw-cra-campaign-orchestration
3description: Orchestrates multi-deliverable campaigns by dispatching Designer and Video Producer workflows in parallel. Use when the user requests 'run campaign', 'execute campaign', 'launch campaign production', or 'orchestrate deliverables'.
4---
5 
6# Campaign Orchestration
7 
8## Overview
9 
10This workflow is the **central orchestration engine** for the Aria Creative Suite. It takes a campaign brief containing multiple deliverables (social posts, carousels, videos, brand assets), parses them into production tasks, dispatches Designer and Video Producer workflows **in parallel**, tracks progress, aggregates results, and runs quality control across all produced assets.
11 
12**Args:** Supports `--headless` / `-H` for fully autonomous campaign execution without user interaction. Supports `--template:product-launch` for the product launch campaign variant (merged from `cra-product-launch-campaign`).
13 
14**Inputs:** Campaign brief (with deliverable list), brand guidelines, optional content calendar or strategy artifacts from Strategist.
15 
16**Outputs:** `status.md` (campaign progress tracker), specialist assignments, `design-manifest.json` and `video-manifest.json` from production workflows, `qa-report.md` from quality control, campaign completion report, daily log entries.
17 
18Act as a campaign production manager who coordinates parallel workstreams. You understand creative production timelines, dependency analysis, and how to keep multiple production tracks synchronized. Your job is coordination and progress tracking, not creative judgment — that belongs to the production agents.
19 
20**Architectural context:** Designer and Video Producer are primary production agents that take briefs directly. Strategist is a service agent — only invoke Strategist if a deliverable explicitly requires research, copy, or script writing that hasn't been provided. Never gate production on Strategist by default.
21 
22## On Activation
23 
24Load available config from `{project-root}/.pawbytes/config/config.yaml` and `{project-root}/.pawbytes/config/config.user.yaml` (root level and `cra` section). If config is missing, let the user know `paw-cra-setup` can configure the module at any time. Resolve:
25 
26- `{user_name}` (null) — address the user by name
27- `{communication_language}` (English) — use for all communications
28- `{document_output_language}` (English) — use for generated document content
29- `{fal_key}` — fal.ai API key (needed by production agents)
30- `{elevenlabs_api_key}` — ElevenLabs API key (optional, for video)
31- `{output_directory}` (`.pawbytes/creative-suites`) — base output path
32 
33Load shared agency memory from `{project-root}/.pawbytes/creative-suites/index.md`. Load brand guidelines from `{project-root}/.pawbytes/creative-suites/brands/{brand-name}/guidelines.md`.
34 
35Locate the campaign brief. Expected at `{project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/brief.md`. If not found, check if the user provided one inline or as a file path.
36 
37If `--headless`, execute all stages without interaction using the brief as-is. If `--template:product-launch`, load `./references/template-product-launch.md` for the variant pipeline.
38 
39Otherwise, confirm the brief is loaded and present a summary of detected deliverables before proceeding.
40 
41## Campaign Status File (Compaction Survival)
42 
43All progress is written to `{project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/status.md`. This file is both the output artifact and the recovery cache. Each stage updates it. After compaction, re-read this file plus the brief to recover full context.
44 
45```yaml
46---
47campaign: '{campaign-name}'
48brand: '{brand-name}'
49status: 'in-progress' # pending | in-progress | quality-gate | complete | failed
50current_stage: '01-brief-parsing'
51brief_path: './brief.md'
52created: 'ISO-8601'
53updated: 'ISO-8601'
54deliverables_total: 0
55deliverables_complete: 0
56design_track: 'pending'
57video_track: 'pending'
58qc_status: 'pending'
59---
60```
61 
62## Stages
63 
64| Stage | Purpose | Reference |
65|-------|---------|-----------|
66| 01 | Brief Parsing | Load `./references/01-brief-parsing.md` |
67| 02 | Dependency Analysis & Queue Build | Load `./references/02-dependency-queue.md` |
68| 03 | Parallel Dispatch | Load `./references/03-parallel-dispatch.md` |
69| 04 | Progress Tracking & Collection | Load `./references/04-progress-collection.md` |
70| 05 | Quality Gate & Completion | Load `./references/05-quality-completion.md` |
71 
72**Progression:** Each stage updates `status.md` with its results before loading the next stage. If interrupted, resume from the last completed stage by reading `status.md`.
73 
74## External Skills & Workflows
75 
76| Skill/Workflow | When Invoked | Purpose |
77|----------------|--------------|---------|
78| `paw-cra-agent-designer` | Stage 03 | Dispatch design production (via Agent tool) |
79| `paw-cra-agent-video-producer` | Stage 03 | Dispatch video production (via Agent tool) |
80| `paw-cra-agent-strategist` | Stage 02 (conditional) | Only if deliverables require unresolved copy/scripts/research |
81| `paw-cra-quality-control` | Stage 05 | Aggregate QC across all produced assets |
82| `paw-cra-multi-platform-export` | Stage 05 (conditional) | Suggested if platform variants are needed post-QC |
83 
84**Invocation pattern:** Use the Agent tool with the skill name in the prompt. For parallel dispatch in Stage 03, launch Designer and Video Producer agent groups simultaneously.
85 
86## Memory Contract
87 
88**Reads:**
89- `{project-root}/.pawbytes/creative-suites/index.md` — agency state
90- `{project-root}/.pawbytes/creative-suites/brands/{brand-name}/guidelines.md` — brand identity
91- `{project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/brief.md` — campaign brief
92 
93**Writes:**
94- `{project-root}/.pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/status.md` — campaign progress
95- `{project-root}/.pawbytes/creative-suites/daily/YYYY-MM-DD.md` — daily log (append, tagged `[Campaign]`)
96 
97**Collects (from production agents):**
98- `design-manifest.json` — from Designer workflows
99- `video-manifest.json` — from Video Producer workflows
100- `qa-report.md` — from quality control workflow
101 

Discussion