@growthub/cli 0.8.1 → 0.8.2

package/assets/worker-kits/growthub-creative-video-pipeline-v1/runtime-assumptions.md

@@ -0,0 +1,61 @@
+# Runtime Assumptions — Creative Video Pipeline
+
+## Required dependencies
+
+| Dependency | Version | Purpose |
+|---|---|---|
+| Node.js | >= 20 | CLI, Vite dev, Next.js dev |
+| Git | any | Fork registration |
+| FFmpeg | any | Stage 3 video render |
+| Python 3 | >= 3.11 | video-use upstream pipeline |
+| pip | any | video-use install |
+
+Optional:
+
+| Dependency | Purpose |
+|---|---|
+| yt-dlp | Downloading online source clips for Stage 3 |
+
+## Required secrets
+
+| Env var | Required when | Notes |
+|---|---|---|
+| `ELEVENLABS_API_KEY` | Always (Stage 3) | ElevenLabs Scribe word-level transcription |
+| `GROWTHUB_BRIDGE_ACCESS_TOKEN` | `ADAPTER=growthub-pipeline` | Auth token from `growthub auth login` |
+| `GROWTHUB_BRIDGE_BASE_URL` | `ADAPTER=growthub-pipeline` | Growthub hosted base URL |
+| `GOOGLE_AI_API_KEY` | `ADAPTER=byo-api-key`, `PROVIDER=veo` | Google AI / Vertex key |
+| `FAL_API_KEY` | `ADAPTER=byo-api-key`, `PROVIDER=fal` | fal.ai key |
+| `RUNWAY_API_KEY` | `ADAPTER=byo-api-key`, `PROVIDER=runway` | Runway key |
+
+## Workspace paths
+
+| Path | Default | Purpose |
+|---|---|---|
+| `CREATIVE_VIDEO_PIPELINE_HOME` | `$HOME/creative-video-pipeline` | Kit workspace root |
+| `VIDEO_USE_HOME` | `$HOME/video-use` | video-use upstream fork |
+| `CREATIVE_STRATEGIST_HOME` | `$HOME/creative-strategist` | Optional: hooks library source |
+
+## Growthub CLI
+
+Minimum version: `0.4.3`. Verify:
+
+```bash
+growthub --version
+```
+
+Required for `growthub pipeline execute` (Stage 2, primary adapter) and `growthub kit fork` commands.
+
+## video-use fork
+
+Cloned to `${VIDEO_USE_HOME:-$HOME/video-use}` by `setup/clone-fork.sh`. Registered as a Claude Code skill by `setup/install-skill.sh`. Required for Stage 3.
+
+## Claude Code skill
+
+`~/.claude/skills/video-use` symlink must be present for conversational edit flow. Set up by `setup/install-skill.sh`.
+
+## Credential hygiene
+
+- No secrets are stored in this kit.
+- All secrets live in the per-fork `.env` (not committed).
+- `ELEVENLABS_API_KEY` must never appear in any output artifact.
+- Provider keys must never appear in any output artifact.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/check-deps.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PASS=0; FAIL=0
+
+check() {
+  if command -v "$1" &>/dev/null; then
+    echo "  [ok] $1"
+    ((PASS++))
+  else
+    echo "  [missing] $1"
+    ((FAIL++))
+  fi
+}
+
+echo "=== growthub-creative-video-pipeline-v1 dependency check ==="
+echo ""
+echo "CLI tools:"
+check growthub
+check node
+check npm
+check ffmpeg
+
+echo ""
+echo "Optional (video-use fork):"
+if [ -n "${VIDEO_USE_HOME:-}" ] && [ -d "$VIDEO_USE_HOME" ]; then
+  echo "  [ok] VIDEO_USE_HOME=$VIDEO_USE_HOME"
+else
+  echo "  [missing] VIDEO_USE_HOME — set and point to video-use fork clone"
+fi
+
+echo ""
+echo "Environment:"
+for var in CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER ELEVENLABS_API_KEY; do
+  if [ -n "${!var:-}" ]; then
+    echo "  [ok] $var"
+  else
+    echo "  [missing] $var"
+  fi
+done
+
+ADAPTER="${CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER:-growthub-pipeline}"
+if [ "$ADAPTER" = "growthub-pipeline" ]; then
+  for var in GROWTHUB_BRIDGE_ACCESS_TOKEN GROWTHUB_BRIDGE_BASE_URL; do
+    if [ -n "${!var:-}" ]; then
+      echo "  [ok] $var"
+    else
+      echo "  [missing] $var (required for growthub-pipeline adapter)"
+    fi
+  done
+elif [ "$ADAPTER" = "byo-api-key" ]; then
+  for var in VIDEO_MODEL_PROVIDER; do
+    if [ -n "${!var:-}" ]; then
+      echo "  [ok] $var"
+    else
+      echo "  [missing] $var (required for byo-api-key adapter)"
+    fi
+  done
+fi
+
+echo ""
+echo "Result: $PASS ok, $FAIL missing"
+[ "$FAIL" -eq 0 ] && echo "All required dependencies present." || echo "Fix missing items before running the pipeline."

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/clone-fork.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+DEST="${VIDEO_USE_HOME:-$HOME/video-use}"
+
+if [ -d "$DEST/.git" ]; then
+  echo "video-use fork already cloned at $DEST"
+  exit 0
+fi
+
+echo "Clone the video-use fork into $DEST, then re-run this script or set VIDEO_USE_HOME."
+echo ""
+echo "  git clone <your-video-use-fork-url> $DEST"
+echo ""
+echo "After cloning, install dependencies:"
+echo "  cd $DEST && npm install"
+echo ""
+echo "Then set VIDEO_USE_HOME=$DEST in your .env.local"

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/install-skill.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SKILL_SRC="$(cd "$(dirname "$0")/.." && pwd)/SKILL.md"
+DEST_DIR="$HOME/.claude/skills/growthub-creative-video-pipeline"
+
+mkdir -p "$DEST_DIR"
+cp "$SKILL_SRC" "$DEST_DIR/SKILL.md"
+echo "Skill installed to $DEST_DIR/SKILL.md"
+echo "Reload Claude Code (or open a new session) to activate."

package/assets/worker-kits/growthub-creative-video-pipeline-v1/setup/verify-env.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from "fs";
+import { resolve } from "path";
+
+const ROOT = new URL("..", import.meta.url).pathname;
+const envFile = resolve(ROOT, ".env.local");
+
+if (existsSync(envFile)) {
+  const lines = readFileSync(envFile, "utf8").split("\n");
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const [key, ...rest] = trimmed.split("=");
+    if (key && rest.join("=")) process.env[key] = rest.join("=");
+  }
+}
+
+const REQUIRED = [
+  "CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER",
+  "ELEVENLABS_API_KEY",
+];
+
+const ADAPTER_DEPS = {
+  "growthub-pipeline": ["GROWTHUB_BRIDGE_ACCESS_TOKEN", "GROWTHUB_BRIDGE_BASE_URL"],
+  "byo-api-key": ["VIDEO_MODEL_PROVIDER"],
+};
+
+const errors = [];
+
+for (const key of REQUIRED) {
+  if (!process.env[key]) errors.push(`Missing required: ${key}`);
+}
+
+const adapter = process.env.CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER ?? "growthub-pipeline";
+const adapterDeps = ADAPTER_DEPS[adapter] ?? [];
+for (const key of adapterDeps) {
+  if (!process.env[key]) errors.push(`Missing for ${adapter} adapter: ${key}`);
+}
+
+if (!process.env.VIDEO_USE_HOME) {
+  errors.push("Missing VIDEO_USE_HOME (required for Stage 3)");
+}
+
+if (errors.length) {
+  console.error("Environment verification failed:");
+  for (const e of errors) console.error(`  - ${e}`);
+  process.exit(1);
+} else {
+  console.log("Environment verified.");
+}

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/README.md

@@ -0,0 +1,11 @@
+# skills/
+
+Sub-skills for the creative-video-pipeline operator. Each sub-skill is a self-contained governed primitive with its own SKILL.md.
+
+| Sub-skill | Stage | Purpose |
+|-----------|-------|---------|
+| brief-generation | Stage 1 | Brand-grounded creative brief from brand-kit.md |
+| generative-execution | Stage 2 | Adapter-routed generative image/video execution |
+| video-edit | Stage 3 | video-use fork delegation: Scribe → EDL → FFmpeg |
+
+The top-level `SKILL.md` at the kit root composes all three sub-skills into the full three-stage pipeline.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/brief-generation/SKILL.md

@@ -0,0 +1,42 @@
+---
+id: creative-video-pipeline/brief-generation
+name: creative-video-pipeline-brief-generation
+description: Generate the Stage 1 brand-grounded pipeline brief from the worker kit brand kit and write output artifacts.
+version: 1.0.0
+triggers:
+  - "generate creative brief"
+  - "run brief stage"
+  - "stage 1 brief"
+  - "write pipeline brief"
+selfEval:
+  criteria:
+    - "Brief is sourced exclusively from brand-kit.md — no invented brand attributes"
+    - "Scene structure matches brand hook patterns"
+    - "pipeline-brief.md written to output/<client>/<project>/brief/"
+    - "project.md appended with Stage 1 completion"
+    - "trace.jsonl event written for stage-complete"
+  maxRetries: 3
+---
+
+# Brief Generation Sub-Skill
+
+## Role
+Generate a brand-grounded creative brief for Stage 1 of the creative video pipeline.
+
+## Input
+- `brands/<client>/brand-kit.md` — brand constraints, audience, hooks, tone
+- `CREATIVE_STRATEGIST_HOME` (optional) — for 500-winning-hooks.csv reference
+- Client name + project name
+
+## Process
+1. Read `brands/<client>/brand-kit.md` in full
+2. Identify brand tone, audience, hook patterns, and platform format
+3. Populate `templates/pipeline-brief.md` — do not invent brand attributes
+4. Write output to `output/<client>/<project>/brief/pipeline-brief.md`
+5. Append Stage 1 completion entry to `.growthub-fork/project.md`
+6. Append `{"type":"stage-complete","stage":"brief","ts":"<iso>"}` to `trace.jsonl`
+
+## Output
+- `output/<client>/<project>/brief/pipeline-brief.md`
+- Updated `.growthub-fork/project.md`
+- Updated `trace.jsonl`

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/generative-execution/SKILL.md

@@ -0,0 +1,86 @@
+---
+id: creative-video-pipeline/generative-execution
+name: creative-video-pipeline-generative-execution
+description: Run Stage 2 generative execution through the selected adapter and write the generative manifest.
+version: 1.0.0
+triggers:
+  - "run generative stage"
+  - "stage 2 generate"
+  - "generate video"
+  - "execute pipeline generation"
+selfEval:
+  criteria:
+    - "Adapter selected from CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER env var"
+    - "growthub-pipeline path: DynamicRegistryPipeline JSON assembled from brief, growthub pipeline execute called directly"
+    - "byo-api-key path: VIDEO_MODEL_PROVIDER resolved, provider SDK called"
+    - "manifest.json written to output/<client>/<project>/generative/ with execution results"
+    - "project.md and trace.jsonl updated with Stage 2 completion"
+  maxRetries: 3
+helpers:
+  - "helpers/check-generative-adapter.sh"
+  - "helpers/run-pipeline.sh"
+---
+
+# Generative Execution Sub-Skill
+
+## Role
+Execute Stage 2 via the official growthub CLI + `@growthub/api-contract` SDK. No custom execution layer.
+
+## Adapter: growthub-pipeline (primary)
+
+```bash
+# Auth pre-flight
+growthub auth whoami --json || { echo "Run: growthub auth login"; exit 1; }
+
+# Assemble DynamicRegistryPipeline from the Stage 1 brief, then execute:
+growthub pipeline execute '<DynamicRegistryPipeline JSON>'
+```
+
+**`DynamicRegistryPipeline` shape (from `@growthub/api-contract`):**
+```json
+{
+  "pipelineId": "<uuid>",
+  "executionMode": "hosted",
+  "nodes": [
+    {
+      "nodeId": "video-gen-1",
+      "slug": "video-generation",
+      "bindings": {
+        "videoModel": "veo-3.1-generate-001",
+        "prompt": "<scene prompt from brief>",
+        "seconds": 8,
+        "aspectRatio": "9:16",
+        "creativeCount": 1,
+        "refs": [
+          { "name": "brand_reference", "dataUrl": "data:image/jpeg;base64,<base64>" }
+        ]
+      }
+    }
+  ]
+}
+```
+
+The CLI streams NDJSON `ExecutionEvent` objects typed by `@growthub/api-contract`. Use `isExecutionEvent()` to validate each line. The `complete` event signals success; the `error` event signals failure.
+
+## Adapter: byo-api-key (secondary)
+Resolve `VIDEO_MODEL_PROVIDER` (veo | fal | runway), call the provider SDK directly.
+
+## Output
+Write `output/<client>/<project>/generative/manifest.json`:
+```json
+{
+  "kitId": "growthub-creative-video-pipeline-v1",
+  "adapter": "growthub-pipeline",
+  "executionId": "<from complete event>",
+  "createdAt": "<iso>",
+  "artifacts": [/* urls/paths from execution output */]
+}
+```
+
+## Process
+1. Read `CREATIVE_VIDEO_PIPELINE_GENERATIVE_ADAPTER`
+2. Run `helpers/check-generative-adapter.sh`
+3. Assemble `DynamicRegistryPipeline` JSON from Stage 1 brief prompts and reference images
+4. Execute: `bash helpers/run-pipeline.sh '<payload>'`
+5. Write `manifest.json` from the execution result
+6. Append Stage 2 completion to `project.md` and `trace.jsonl`

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills/video-edit/SKILL.md

@@ -0,0 +1,41 @@
+---
+id: creative-video-pipeline/video-edit
+name: creative-video-pipeline-video-edit
+description: Prepare the Stage 3 edit handoff for the VIDEO_USE_HOME fork and collect final video output.
+version: 1.0.0
+triggers:
+  - "run edit stage"
+  - "stage 3 edit"
+  - "assemble final video"
+  - "video-use edit"
+selfEval:
+  criteria:
+    - "edit-plan.md written from generative manifest and brief"
+    - "VIDEO_USE_HOME is set and resolves to a cloned video-use fork"
+    - "Handoff to video-use fork executed — do not duplicate video-use pipeline logic"
+    - "final.mp4 copied to output/<client>/<project>/final/"
+    - "project.md and trace.jsonl updated with Stage 3 completion"
+  maxRetries: 3
+---
+
+# Video Edit Sub-Skill
+
+## Role
+Execute Stage 3: delegate edit to the `VIDEO_USE_HOME` video-use fork and collect final output.
+
+## Dependencies
+- `VIDEO_USE_HOME` — absolute path to video-use fork clone
+- `ELEVENLABS_API_KEY` — for ElevenLabs Scribe word-level transcription
+- `ffmpeg` — must be on PATH inside the video-use fork environment
+
+## Process
+1. Read `output/<client>/<project>/generative/manifest.json` to identify source clips
+2. Read `output/<client>/<project>/brief/pipeline-brief.md` for editing guidelines
+3. Write `output/<client>/<project>/edit-plan.md` from `templates/edit-plan.md`
+4. Delegate to video-use fork — do NOT inline video-use logic here
+5. Copy final rendered `final.mp4` to `output/<client>/<project>/final/final.mp4`
+6. Append Stage 3 completion to `project.md` and `trace.jsonl`
+
+## Handoff
+The video-use fork owns the full Scribe → word-boundary EDL → FFmpeg render pipeline.
+This sub-skill's only job is to form the `edit-plan.md` handoff and collect the output artifact.

package/assets/worker-kits/growthub-creative-video-pipeline-v1/skills.md

@@ -0,0 +1,302 @@
+# Creative Video Pipeline — Operator Runbook
+
+> **Who this is for:** Any agent operating inside `${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/` and running the three-stage creative video pipeline.
+> Read this file fully before starting. Every section is a required step.
+
+---
+
+## QUICK REFERENCE
+
+| What you need | Where to find it |
+|---|---|
+| This runbook | `skills.md` ← you are here |
+| Routing menu | `SKILL.md` |
+| Agent contract | `workers/creative-video-pipeline-operator/CLAUDE.md` |
+| Brief template | `templates/pipeline-brief.md` |
+| Brand kit template | `brands/_template/brand-kit.md` |
+| Generative plan template | `templates/generative-plan.md` |
+| Edit plan template | `templates/edit-plan.md` |
+| Session memory | `.growthub-fork/project.md` |
+| Output directory | `output/<client-slug>/<project-slug>/` |
+| Adapter contracts | `docs/adapter-contracts.md` |
+| Pipeline architecture | `docs/pipeline-architecture.md` |
+
+---
+
+## STAGE 0 — PREPARE
+
+### 0a. Environment check
+
+```bash
+bash setup/check-deps.sh
+node setup/verify-env.mjs
+```
+
+If deps fail, stop and return remediation only. Do not invent API keys or hardcode paths.
+
+### 0b. Verify generative adapter
+
+```bash
+bash helpers/check-generative-adapter.sh
+```
+
+Prints active adapter (`growthub-pipeline` or `byo-api-key`) and which keys are set.
+
+### 0c. Auth pre-flight (growthub-pipeline adapter only)
+
+```bash
+growthub auth whoami --json
+```
+
+If not authenticated, run `growthub auth login` before proceeding.
+
+### 0d. Create or load brand kit
+
+```bash
+# New client
+cp ${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/brands/_template/brand-kit.md \
+   ${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/brands/<client-slug>/brand-kit.md
+
+# Existing client
+cat ${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/brands/<client-slug>/brand-kit.md
+```
+
+Required fields: `client_name`, `slug`, `primary_service`, `tone`, `messaging_guardrails`, `cta_text`, `colors`.
+
+---
+
+## STAGE 1 — BRIEF
+
+Sub-skill: `skills/brief-generation/SKILL.md`
+
+### 1a. Build scene structure
+
+From the brand kit and campaign intent, produce a scene table:
+
+```
+Scene 1 — Hook          N variations (A–E), same creative concept
+Scene 2 — Problem       consistent across all hook variations
+Scene 3 — Solution      consistent across all hook variations
+Scene N — CTA           consistent across all hook variations
+```
+
+Hook sources (in priority order):
+1. `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/templates/hooks-library/500-winning-hooks.csv` — if the creative-strategist kit is installed
+2. Inline hook reasoning from brand kit tone and `approved_phrases`
+
+### 1b. Write the brief
+
+Fill `templates/pipeline-brief.md` and write the output to:
+
+```
+output/<client-slug>/<project-slug>/brief/pipeline-brief.md
+```
+
+Required sections:
+1. Brand constraints box — from `messaging_guardrails`
+2. Scene structure table
+3. Hook variations A–E for Scene 1
+4. Per-scene production notes (visual direction, VO, on-screen text)
+5. Editing guidelines
+6. Appendix: AI generation prompts (labeled OPTIONAL) — used in Stage 2
+
+### 1c. Append to session memory
+
+```bash
+# After completing Stage 1:
+# Append to .growthub-fork/project.md with: stage, client, brief path, hook count, scene count
+```
+
+**Self-eval unit for Stage 1:** The completed `pipeline-brief.md` for one creative concept.
+
+---
+
+## STAGE 2 — GENERATE
+
+Sub-skill: `skills/generative-execution/SKILL.md`
+
+### 2a. Resolve adapter
+
+```bash
+bash helpers/check-generative-adapter.sh
+```
+
+### 2b. Build generative plan
+
+Fill `templates/generative-plan.md` with:
+- Node bindings (which scenes become video clips, which become images)
+- Reference images (if any — as typed data URLs per `@growthub/api-contract` ref spec)
+- Provider model choice
+- Prompts from Stage 1 brief Appendix
+
+### 2c. Execute — growthub-pipeline path (primary)
+
+```bash
+bash helpers/run-pipeline.sh
+```
+
+Or directly:
+
+```bash
+# Auth pre-flight
+growthub auth whoami --json || { echo "Not authenticated. Run: growthub auth login"; exit 1; }
+
+# Execute
+growthub pipeline execute '<json-payload>'
+```
+
+Pipeline payload shape (`DynamicRegistryPipeline`):
+```json
+{
+  "pipelineId": "<uuid>",
+  "executionMode": "hosted",
+  "nodes": [
+    {
+      "nodeId": "video-gen-1",
+      "slug": "video-generation",
+      "bindings": {
+        "videoModel": "veo-3.1-generate-001",
+        "prompt": "<scene prompt from brief>",
+        "seconds": 8,
+        "aspectRatio": "9:16",
+        "creativeCount": 1,
+        "refs": [
+          { "name": "brand_reference", "dataUrl": "data:image/jpeg;base64,<base64>" }
+        ]
+      }
+    }
+  ]
+}
+```
+
+Parse streaming NDJSON output with `isExecutionEvent` from `@growthub/api-contract/events`.
+
+### 2d. Execute — byo-api-key path (secondary)
+
+Set `VIDEO_MODEL_PROVIDER` and the corresponding provider key in `.env`.
+The adapter in `lib/adapters/generative/index.js` routes to the correct provider SDK.
+
+### 2e. Write generative manifest
+
+After execution, write `output/<client>/<project>/generative/manifest.json` per `output-standards.md`.
+
+### 2f. Append to session memory
+
+Record: execution id, artifact count, provider used, artifact URLs.
+
+**Self-eval unit for Stage 2:** `manifest.json` with at least one artifact URL per scene in the brief.
+
+---
+
+## STAGE 3 — EDIT
+
+Sub-skill: `skills/video-edit/SKILL.md`
+
+### 3a. Verify video-use fork
+
+```bash
+ls "${VIDEO_USE_HOME:-$HOME/video-use}/skills.md" || {
+  echo "video-use fork not found. Run: bash setup/clone-fork.sh"
+  exit 1
+}
+```
+
+### 3b. Stage generated clips
+
+Copy/link generated clips from `output/<client>/<project>/generative/` into `${VIDEO_USE_HOME}/<project>/`.
+
+### 3c. Write edit plan
+
+Fill `templates/edit-plan.md` and write to `output/<client>/<project>/final/edit-plan.md`.
+
+Minimum contents:
+- Source clips list (from generative manifest)
+- Cut strategy aligned to scene structure from brief
+- Overlay plan (captions, on-screen text from brief scenes)
+- Music direction
+- Final duration target
+
+### 3d. Hand off to video-use agent
+
+The video-use agent reads from its `${VIDEO_USE_HOME}/skills.md` runbook. Pass:
+1. `output/<client>/<project>/brief/pipeline-brief.md` — scene + VO structure
+2. `output/<client>/<project>/final/edit-plan.md` — cut strategy
+
+The video-use fork pipeline:
+```
+inventory → transcribe (ElevenLabs Scribe) → pack phrase-level transcript
+         → EDL generation (word-boundary cuts)
+         → render (FFmpeg + overlays)
+         → self-eval (up to 3 iterations)
+         → final.mp4 at ${VIDEO_USE_HOME}/<project>/edit/final.mp4
+```
+
+### 3e. Copy final output
+
+```bash
+mkdir -p output/<client>/<project>/final
+cp "${VIDEO_USE_HOME}/<project>/edit/final.mp4" output/<client>/<project>/final/final.mp4
+```
+
+### 3f. Append to session memory
+
+Record: edit decision count, render duration, final.mp4 path, QA pass status.
+
+**Self-eval unit for Stage 3:** `final.mp4` exists, passes QA checklist, duration matches target.
+
+---
+
+## NON-NEGOTIABLE RULES
+
+1. Stage 1 brief must be sourced from `brand-kit.md` — no brand details from memory.
+2. Stage 2 generative execution goes through the adapter contract — never raw API calls outside it.
+3. Stage 3 edit delegates to `VIDEO_USE_HOME` fork — never duplicate its pipeline inline.
+4. `output/<client>/<project>/` is the single output root — no other write locations.
+5. Append to `.growthub-fork/project.md` at every stage boundary.
+6. `ELEVENLABS_API_KEY` never appears in any output artifact.
+7. Provider API keys never appear in any output artifact.
+8. Brief AI generation prompts live in the Appendix only — never inline in scene blocks.
+
+---
+
+## FOLDER STRUCTURE
+
+```
+${CREATIVE_VIDEO_PIPELINE_HOME:-$HOME/creative-video-pipeline}/
+├── skills.md                        ← this file — read first, every session
+├── SKILL.md                         ← routing menu — read before skills.md
+├── QUICKSTART.md
+├── .env.example
+├── workers/
+│   └── creative-video-pipeline-operator/CLAUDE.md
+├── brands/
+│   ├── _template/brand-kit.md
+│   ├── growthub/brand-kit.md
+│   └── NEW-CLIENT.md
+├── templates/
+│   ├── pipeline-brief.md
+│   ├── generative-plan.md
+│   └── edit-plan.md
+├── setup/
+│   ├── check-deps.sh
+│   ├── verify-env.mjs
+│   ├── clone-fork.sh
+│   └── install-skill.sh
+├── helpers/
+│   ├── run-pipeline.sh
+│   └── check-generative-adapter.sh
+├── skills/
+│   ├── brief-generation/SKILL.md
+│   ├── generative-execution/SKILL.md
+│   └── video-edit/SKILL.md
+├── docs/
+│   ├── adapter-contracts.md
+│   ├── pipeline-architecture.md
+│   ├── governed-workspace-primitives.md
+│   └── vercel-deployment.md
+├── output/
+│   └── <client-slug>/<project-slug>/{brief/,generative/,final/}
+├── studio/                          ← Vite local shell
+└── apps/
+    └── creative-video-pipeline/     ← Next.js / Vercel app
+```