new-workflow

New Image Workflow

Scaffold a structured, multi-stage image workflow inside the user's registered image workspace. Unlike new-project (a flat source/working/exports layout), a workflow expects iteration: generation, human review, revision, and export are explicit stages, each with their own folder and manifest entry.

Cloud AI (Fal nano-banana via the fal REST queue API) is wired in as an optional driver for the generation and revision stages.

When to use this vs. new-project

• new-project — single batch of images, photo-editing style, no iteration loop.
• new-workflow — generative or hybrid work with multiple touchpoints: brief → references → generate → review → revise → export. Use when the user expects to come back to the project across several sessions and wants a stable structure to resume into.

Procedure

1. Resolve the workspace

CONFIG="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/image-production/workspace.json"
test -f "$CONFIG" || { echo "No workspace registered — run workspace-setup first."; exit 1; }
WS=$(jq -r .path "$CONFIG")

2. Gather workflow metadata

Ask (or infer if obvious):

• Name — required. Slugify (lowercase, hyphens).
• Brief — one or two sentences describing the deliverable.
• Cloud-AI driver — default fal-nano-banana (via the fal REST queue API, see skill ai-graphics). none if the user is bringing their own images.
• Expected rounds — how many revision cycles to scaffold (default 3).
• Final aspect ratio / resolution — for export-stage placeholders.

3. Create the layout

PROJ="$WS/<slug>"
test -e "$PROJ" && { echo "Already exists: $PROJ"; exit 1; }
mkdir -p "$PROJ"/{01-brief,02-references,03-generation,04-review,05-revision,06-export,_manifest}
mkdir -p "$PROJ"/05-revision/round-{1..N}   # N = expected rounds

Stage	Purpose	Touchpoint?
01-brief/	brief.md — goal, audience, constraints, do/don't list	✓ user
02-references/	Mood board, reference images, prompt fragments	✓ user
03-generation/	First-pass generations (Fal output lives here)	ai
04-review/	Selected candidates from 03-generation/ + review notes	✓ user
05-revision/	Per-round subfolders with revised generations + notes	ai + user
06-export/	Final deliverables — sized, formatted, metadata-scrubbed	ai
_manifest/	workflow.json — pipeline state; prompts.md — running prompt log	ai