full-pipeline

/socialforge:full-pipeline — Complete Production Pipeline

Script location. If your host does not set ${CLAUDE_PLUGIN_ROOT}, the scripts are in this plugin's scripts/ folder, next to skills/. Run them with Python 3.10 or newer: python, or python3 where python is not found (macOS, many Linux systems).

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.

Quote, then go (interactive, before the Generate stage)

Direction and confirmation cost nothing. The first paid call is the Generate stage, so the post is quoted once, after the user confirms the details and before anything is generated. This skill states no price: price_book.py is the only source.

1. List what is about to be generated: for each paid call, the registry alias (resolve_model.py --alias <alias> gives the current model id), the provider, and the units (images, or seconds of video, plus any option that changes the price, such as synchronised audio). For an image post that is the planned variants (typically 2-3); for a video post, both keyframe rounds and the clip.
2. Quote it:

python "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action quote-batch --items '[{"model":"<resolved model id>","provider":"<provider>","units":<n>,"label":"<post id and stage>"}]'

A single item can use --action quote --model <id> --provider <provider> --units <n>. If the quote exits non-zero or lists a blocked item, stop: run /socialforge:price-check to look the missing price up, then quote again. 3. Show the user the total, each line, its source URL, and how old the price is (a price older than 24 hours is stale and is refused; it must be looked up again):

Estimated cost: <total_usd> USD for <n> generations. Prices from <source>, <age_hours> h old (valid for 24 h).
Type "go" to generate. Anything else cancels.

4. Continue only on an explicit go for exactly this list. Anything else, including silence, cancels and nothing is generated. If the list changes (a regeneration, another model, an added option), quote again and ask again. A quote is never approval (approved_to_run is always false); only the user's go is.

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.

Quote, then go (batch, before any paid call)

A batch fans out across the whole calendar and video is billed by the second, so the batch is quoted once, after the group directions are approved and before anything is generated. This skill states no price: price_book.py is the only source, and one unpriced item blocks the whole batch.

1. List what is about to be generated: for each paid call, the registry alias (resolve_model.py --alias <alias> gives the current model id), the provider, and the units (images, or seconds of video, plus any option that changes the price, such as synchronised audio). In a batch, list every paid generation of every post. Interactive mode (/socialforge:generate-post) does the same per post, in /socialforge:compose-creative.
2. Quote it:

python "${CLAUDE_PLUGIN_ROOT}/scripts/price_book.py" --action quote-batch --items '[{"model":"<resolved model id>","provider":"<provider>","units":<n>,"label":"<post id and stage>"}]'

A single item can use --action quote --model <id> --provider <provider> --units <n>. If the quote exits non-zero or lists a blocked item, stop: run /socialforge:price-check to look the missing price up, then quote again. 3. Show the user the total, each line, its source URL, and how old the price is (a price older than 24 hours is stale and is refused; it must be looked up again):

Estimated cost: <total_usd> USD for <n> generations. Prices from <source>, <age_hours> h old (valid for 24 h).
Type "go" to generate. Anything else cancels.

4. Continue only on an explicit go for exactly this list. Anything else, including silence, cancels and nothing is generated. If the list changes (more posts, another model, an added option), quote again and ask again. A quote is never approval (approved_to_run is always false).

5. Group-based direction — Posts are grouped by creative mode (ANCHOR, ENHANCE, STYLE_REF, PURE). User approves creative direction per group rather than per post.

6. Quote, then go, then auto-generate — run the quote step above for the whole batch; only on an explicit go do all posts generate in sequence using the approved group directions. Progress is displayed per post with quality scores.

7. Gallery review — Once all posts are generated, a review gallery is built automatically so the user can review everything at once.

8. 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

Phase 7 is the user's. finalize-month is not model-invocable: it packages the delivery and can upload it and send a completion message. When every post is reviewed, the pipeline stops and tells the user: "All posts are reviewed. Run /socialforge:finalize to package the month." It never invokes the finalize skill itself, and --resume stops at the same place.

Escalation (per approval-chain.json):

• Reminder after N days (configurable per tier)
• Escalate to next reviewer after M days
• No tier is ever finalized or published automatically: an expired escalation period only sends a reminder (through the manage-reviews Execution gate), and finalizing waits for the user to run /socialforge:finalize

Timeout: No automatic timeout — Phase 6 stays paused until human action. The /socialforge:status command shows pending review counts.