@growthub/cli 0.14.5 → 0.14.6

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

@@ -1,61 +0,0 @@
-# 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

@@ -1,63 +0,0 @@
-#!/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

@@ -1,18 +0,0 @@
-#!/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

@@ -1,10 +0,0 @@
-#!/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

@@ -1,50 +0,0 @@
-#!/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

@@ -1,11 +0,0 @@
-# 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

@@ -1,42 +0,0 @@
----
-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

@@ -1,86 +0,0 @@
----
-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

@@ -1,41 +0,0 @@
----
-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

@@ -1,302 +0,0 @@
-# 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
-```