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}/<brand>/assets/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 pending review counts.