| 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.
- Run
credential_manager.py status to check Vertex AI and WaveSpeed configuration
- Image generation requires Vertex AI credentials configured via
/socialforge:setup
- Video generation requires WaveSpeed API key (only checked if calendar contains video posts)
- 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."
- 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:
- Direction — Review creative direction and prompt before generation
- Generate — AI generates 2-3 variants; user picks the best or requests regeneration
- Composite — Selected variant composited with brand asset, overlay, and logo; user approves
- Resize — Platform-specific resizes produced; user confirms final set
Video posts — 5-stage approval:
- Direction — Review video concept, storyboard outline, and scene descriptions
- Script — Approve shot-by-shot script with timing and transitions
- Generate — AI generates video clip; user reviews motion and pacing
- Composite — Overlay, logo, and captions applied; user approves
- 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.
- Group-based direction — Posts are grouped by creative mode (ANCHOR, ENHANCE, STYLE_REF, PURE). User approves creative direction per group rather than per post.
- Auto-generate — All posts generate in sequence using the approved group directions. Progress is displayed per post with quality scores.
- Gallery review — Once all posts are generated, a review gallery is built automatically so the user can review everything at once.
- 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:
- Gallery is built and shared (Phase 5 output)
- Pipeline shows: "Review gallery ready. Pipeline paused — resume after reviews complete."
- User reviews posts via
/socialforge:review or /socialforge:manage-reviews
- 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.
