/full-pipeline

name: full-pipeline
description: Run the complete end-to-end production pipeline — parse, match, compose, copy, preview, review, finalize.
argument-hint: "[brand] [YYYY-MM] [calendar-source]"
effort: max
user-invocable: true

/socialforge:full-pipeline — Complete Production Pipeline

Run all phases sequentially with quality gates between each.

Context efficiency

Asset-heavy skill. **Grep before Read** the asset catalog (`${CLAUDE_PLUGIN_DATA}/socialforge/brands/<brand>/asset-index.json`) — never list the asset directory. Reference generated images / videos by path, not by loading metadata. Brand profile loads once per session.

Pipeline Phases

| Phase | Skill | Gate | |-------|-------|------| | -1 | credential-check | API credentials configured (Vertex AI and/or WaveSpeed) | | 0 | parse-calendar | Calendar parsed, all required fields present | | 1 | match-assets | Asset matches confirmed by user | | 2 | compose-creative | All images/videos generated, quality scores ≥7.0 | | 3 | adapt-copy | Copy adapted, compliance passed | | 4 | create-previews | Previews rendered for all posts | | 5 | build-review-gallery | Gallery built and accessible (images + video) | | 6 | manage-reviews | All posts reviewed (async — pipeline pauses here) | | 7 | finalize-month | All approved posts packaged for delivery |

Phase -1: Credential Check

Before any production work begins, verify that the required API credentials are configured via `credential_manager.py`.

1. Run `credential_manager.py status` to check Vertex AI and WaveSpeed configuration 2. **Image generation** requires Vertex AI credentials configured via `/socialforge:setup` 3. **Video generation** requires WaveSpeed API key (only checked if calendar contains video posts) 4. If any required credential is missing, stop the pipeline and prompt the user: "Required credentials not configured. Run `/socialforge:setup` to configure API keys before starting production." 5. If all credentials are valid, proceed to Phase 0

Phase 2: Compose Creative

Phase 2 operates in two distinct modes depending on how it is invoked.

Interactive mode (`/socialforge:generate-post`)

Produces creative for a single post with full user control at each stage.

**Image posts — 4-stage approval:** 1. **Direction** — Review creative direction and prompt before generation 2. **Generate** — AI generates 2-3 variants; user picks the best or requests regeneration 3. **Composite** — Selected variant composited with brand asset, overlay, and logo; user approves 4. **Resize** — Platform-specific resizes produced; user confirms final set

**Video posts — 5-stage approval:** 1. **Direction** — Review video concept, storyboard outline, and scene descriptions 2. **Script** — Approve shot-by-shot script with timing and transitions 3. **Generate** — AI generates video clip; user reviews motion and pacing 4. **Composite** — Overlay, logo, and captions applied; user approves 5. **Resize** — Platform-specific aspect ratios produced; user confirms final set

Batch mode (`/socialforge:generate-all`)

Produces creative for all posts in the calendar with minimal interruption.

1. **Group-based direction** — Posts are grouped by creative mode (ANCHOR, ENHANCE, STYLE_REF, PURE). User approves creative direction per group rather than per post. 2. **Auto-generate** — All posts generate in sequence using the approved group directions. Progress is displayed per post with quality scores. 3. **Gallery review** — Once all posts are generated, a review gallery is built automatically so the user can review everything at once. 4. **Flagged regeneration** — User flags any posts that need rework. Flagged posts regenerate with adjusted prompts. Unflagged posts proceed as approved.

Phase 5: Review Gallery

The review gallery (`/socialforge:review`) now supports both image and video content:

• **Image posts** display as before — preview thumbnail, quality score, copy, and compliance status
• **Video posts** display with side-by-side `<video>` tags showing the raw generated clip alongside the composited version with overlays, enabling direct comparison of motion, pacing, and brand overlay placement

Progress

SocialForge Full Pipeline — AcmeCorp / April 2026

[pre] Credential Check ✓ — Vertex AI ready, WaveSpeed ready
[1/7] Parse Calendar ✓ — 28 posts extracted (24 image, 4 video)
[2/7] Match Assets ✓ — 8 ANCHOR, 5 ENHANCE, 9 STYLE_REF, 4 PURE, 2 CAROUSEL
[3/7] Compose Creative → IN PROGRESS
  Mode: batch (group-based direction)
  Groups approved: ANCHOR ✓ ENHANCE ✓ STYLE_REF ✓ PURE → awaiting direction
  Generated: 18/28 posts (~10 min remaining)
  Latest: P18 — STYLE_REFERENCED — Score: 8.4/10 ✓
  Videos: 2/4 generated — P07 Score: 7.8/10 ✓
[4/7] Adapt Copy — waiting
[5/7] Create Previews — waiting
[6/7] Review Gallery — waiting
[7/7] Finalize — waiting

Rules

• Each phase must pass its gate before the next starts
• Phase -1 (Credential Check) is the first gate — no production without valid credentials
• Phase 6 (Review) is async — pipeline pauses for human review
• User can interrupt at any phase and resume later
• Status persists in status-tracker.json

Async Review Gate (Phase 6)

Phase 6 (manage-reviews) is the only async gate — the pipeline pauses here because human review takes hours or days.

**When pipeline reaches Phase 6:** 1. Gallery is built and shared (Phase 5 output) 2. Pipeline shows: "Review gallery ready. Pipeline paused — resume after reviews complete." 3. User reviews posts via `/socialforge:review` or `/socialforge:manage-reviews` 4. To resume after reviews: run `/socialforge:full-pipeline --resume` or `/socialforge:finalize` directly

**Escalation (per approval-chain.json):**

• Reminder after N days (configurable per tier)
• Escalate to next reviewer after M days
• Auto-finalize HYGIENE tier after N days if configured

**Timeout:** No automatic timeout — Phase 6 stays paused until human action. The `/socialforge:status` command shows pe