@event4u/agent-config 2.23.0 → 2.24.0

package/.agent-src/skills/scene-expander/scene-blueprint.schema.yaml

@@ -0,0 +1,108 @@
+# Scene Blueprint Schema (v1)
+#
+# Maps the 12 labeled blocks emitted by `scene-expander` to the
+# adapter-contract JSON consumed by every adapter under
+# `scripts/ai-video/adapters/`. Validation lives in
+# `scripts/ai-video/lib/parse-blueprint.sh`.
+#
+# Source format: plain-text, one labeled block per line OR per
+# heading. Labels are case-insensitive; whitespace around `:` is
+# tolerated. Block order is the canonical order below — out-of-order
+# blocks are accepted but logged as a warning.
+
+version: 1
+
+blocks:
+  STYLE:
+    required: true
+    target: prompt.style
+    description: "Film stock + decade (live-action) or film title + year (animated)."
+
+  SUBJECT:
+    required: true
+    target: prompt.subject
+    description: "Character read. Verbatim from character.json when locked."
+
+  ENVIRONMENT:
+    required: true
+    target: prompt.environment
+    description: "Location, time-of-day, weather, era; world reaction."
+
+  ACTION:
+    required: true
+    target: prompt.action
+    description: "Anticipation / action / reaction with beat counts."
+
+  CAMERA:
+    required: true
+    target: prompt.camera
+    description: "Position, height, distance, move."
+
+  LENS:
+    required: true
+    target: prompt.lens
+    description: "Focal length in mm + aperture intent (live-action). Animated runs may emit 'n/a' but the block must be present."
+
+  LIGHTING:
+    required: true
+    target: prompt.lighting
+    description: "Key / fill / back / practical with direction."
+
+  MOOD:
+    required: true
+    target: prompt.mood
+    description: "Single emotional read."
+
+  DIALOGUE:
+    required: false
+    target: audio.dialogue
+    description: "Optional. Marks audio.native requirement when present."
+    null_when_absent: true
+
+  AMBIENT SOUND:
+    required: false
+    target: audio.ambient
+    description: "Optional ambient layer list."
+    null_when_absent: true
+
+  DURATION:
+    required: true
+    target: duration
+    type: number
+    description: "Seconds. Integer or one decimal."
+
+  NEGATIVE:
+    required: true
+    target: negative
+    description: "Clichés to reject, load-bearing top-first."
+
+# Adapter-contract JSON shape produced by parse-blueprint.sh
+output_shape: |
+  {
+    "prompt": {
+      "style": "...",
+      "subject": "...",
+      "environment": "...",
+      "action": "...",
+      "camera": "...",
+      "lens": "...",
+      "lighting": "...",
+      "mood": "..."
+    },
+    "audio": {
+      "dialogue": [...] | null,
+      "ambient": [...] | null,
+      "enable_native_audio": true | false
+    },
+    "duration": 5.0,
+    "negative": ["...", "..."],
+    "requires": {
+      "audio_native": true | false
+    }
+  }
+
+# `enable_native_audio` derives from: DIALOGUE present OR AMBIENT SOUND present.
+# Orchestrator uses `requires.audio_native` to pick an adapter with
+# `audio: native` capability (Phase 4 Step 1). When no native adapter
+# is available the orchestrator routes audio.* to ffmpeg mux at
+# stitch time (Phase 4 Step 7) and clears `enable_native_audio`.

package/.agent-src/skills/subagent-orchestration/SKILL.md

@@ -56,7 +56,7 @@ model pairing. Defaults come from
 Descriptive, not enforced. Documents the **expected agent-to-agent
 communication topology** so consumers can predict latency, failure
 modes, and where consensus is required. Cited from
-[`external-findings.md § 2`](../../../agents/audit-2026-05-14-north-star/external-findings.md)
+[`external-findings.md § 2`](../../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md) <!-- council-ref-allowed: ADR decision trace for topology anti-drift defaults -->
 row 7 (Ruflo's `hierarchical, 6–8 agents, raft consensus` anti-drift
 default).
 
@@ -72,8 +72,8 @@ default).
 
 **Anti-drift default** (Ruflo convention, descriptive only):
 `hierarchical, 6–8 agents, raft consensus`. Consumers free to
-override per orchestration — table is **starting point**, not a
-constraint. Topology is metadata for capacity planning, not
+override per orchestration — the table is the **starting point**,
+not a constraint. Topology is metadata for capacity planning, not
 runtime-enforced.
 
 **Glossary:**
@@ -81,7 +81,7 @@ runtime-enforced.
 - `mesh` — agents see each other's outputs (e.g. competing diffs).
 - `hierarchical-mesh` — peer debate followed by hub reconciliation.
 - `ring` — output of step N feeds input of step N+1 in order.
-- `star` — N agents fan out from single hub; no peer comms.
+- `star` — N agents fan out from a single hub; no peer comms.
 - `adaptive` — topology shifts per step; outer chain remains hub.
 
 ### 1. do-and-judge
@@ -193,17 +193,19 @@ step is under ~30 minutes. The branch-creation, context-switch, and
 worktree-cleanup cost dominates. Stick with mode 1 (do-and-judge)
 or mode 3 (do-in-steps) for those.
 
-**Competitive variant — per-candidate isolation.** Mode 5
-(`do-competitively`) + worktrees: each candidate runs in its own
-worktree (no cross-candidate state leak). Selection rules:
-
-- **No auto-merge.** Orchestrator never merges candidate branches.
-  Hard Floor per [`non-destructive-by-default`](../../rules/non-destructive-by-default.md) —
-  applies even under standing autonomy. ADR-005 records reasoning.
-- **Ranked presentation.** Judge ranks 1..N with one-line
-  justifications; user picks winner.
-- **Loser worktrees stay.** Orchestrator does not auto-delete losing
-  worktrees — user keeps option to harvest a partial idea before cleanup.
+**Competitive variant — per-candidate isolation.** When mode 5
+(`do-competitively`) is combined with worktrees, each candidate
+implementer runs in its own worktree (so candidates cannot read each
+other's open files or branch state). Selection rules:
+
+- **No auto-merge.** The orchestrator never merges a candidate
+  branch. Hard Floor per [`non-destructive-by-default`](../../rules/non-destructive-by-default.md) —
+  applies even under standing autonomy. ADR-005 records the reasoning.
+- **Ranked presentation.** Judge ranks candidates (1..N) with a
+  one-line justification per rank; user picks the winner.
+- **Loser worktrees stay.** The orchestrator does not delete losing
+  worktrees automatically — the user keeps the option to harvest a
+  partial idea before cleanup.
 
 ## Status taxonomy — every subagent return uses one envelope
 

package/.agent-src/skills/video-director/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: video-director
+description: "Use when turning a scene idea into the 11-block cinematic prompt for live-action AI video — lens, lighting, blocking, motion, negatives. Triggers 'cinematic prompt', 'film-grade scene'."
+personas:
+  - hollywood-director
+source: package
+domain: product
+---
+
+# video-director
+
+> Turn a scene idea into the **11-block cinematic prompt** the
+> `hollywood-director` persona ships. Output is provider-agnostic
+> prose; provider-specific tuning is handed off to
+> [`motion-choreographer`](../motion-choreographer/SKILL.md).
+
+## When to use
+
+- A scene idea, beat, or script line needs to become a cinematic
+  prompt ready to feed an image+video pipeline.
+- A draft prompt reads as "AI video" — flat, centered, generic
+  golden-hour — and needs directorial choices on the page.
+- Live-action / photoreal scenes. For animation acting beats, route
+  to [`pixar-storyteller`](../pixar-storyteller/SKILL.md).
+
+Do NOT use when:
+
+- The deliverable is a still graphic or poster → `canvas-design`.
+- The work is provider-specific token tuning →
+  `motion-choreographer` after this skill has produced the blocks.
+- A character identity must be re-used across scenes → run
+  [`character-consistency`](../character-consistency/SKILL.md) first
+  to lock identity tokens, then call this skill.
+
+## Procedure
+
+### Step 0: Inspect
+
+1. Confirm the input is a live-action / photoreal beat (not animation).
+2. If a `character.json` exists under `agents/ai-video/<project>/characters/`,
+   read the identity tokens — they are reused verbatim.
+3. Read the scene's intent in one sentence — what is the camera
+   witnessing, and why now?
+
+### Step 1: Draft the 11 blocks
+
+Emit each block on its own labeled line. Blocks are mandatory and
+in this order:
+
+1. **SCENE** — location, time-of-day, weather, era.
+2. **CHARACTER** — verbatim identity tokens from `character.json`
+   when present; otherwise silhouette + wardrobe + signature prop.
+3. **ACTION** — verbs and beats. Anticipation → action → reaction
+   named separately. No "doing things" prose.
+4. **CAMERA** — position, height, distance, move (lock-off, dolly,
+   handheld, push, pull). Off-axis when on-axis is the AI default.
+5. **LENS** — focal length in mm (24 / 35 / 50 / 85 / 200) and
+   aperture intent (deep / shallow). "Cinematic" alone fails.
+6. **LIGHTING** — key, fill, back, practical sources named. "Golden
+   hour" requires an angle (low-east 15°, etc.).
+7. **ENVIRONMENT MOTION** — what the world does (wind, water,
+   crowd, traffic) and on which beat.
+8. **SECONDARY MOTION** — hair, cloth, dust, breath. Names the
+   reactive layer that sells the primary action.
+9. **MOOD** — one emotional read; no compound moods.
+10. **DURATION** — seconds. Integer or one decimal.
+11. **NEGATIVE CONSTRAINTS** — clichés to reject, in load-bearing
+    order (top survives truncation). Always names: centered framing,
+    symmetric composition, generic "cinematic", soap-opera contrast.
+
+### Step 2: Self-review
+
+1. Lens length present? "Cinematic" without mm → fail.
+2. Lighting direction present? "Golden hour" without angle → fail.
+3. ACTION names beats, not adjectives?
+4. NEGATIVE block has at least 4 entries, load-bearing on top?
+5. CHARACTER block reuses identity tokens verbatim when a lock exists?
+
+Any "no" → revise that block before handing off.
+
+### Step 3: Validate
+
+1. Output is plain text, one labeled block per line, ready for
+   `scripts/ai-video/lib/parse-blueprint.sh` (Phase 3 Step 5).
+2. No provider tokens (no `--aspect`, no `--model`). That is
+   `motion-choreographer`'s job.
+
+## Output format
+
+1. **`scenes/<id>/prompt.txt`** — 11 labeled blocks, one per line,
+   ready for the blueprint parser.
+2. **`scenes/<id>/review.md`** — one-paragraph rationale per
+   non-obvious directorial choice (lens, light angle, camera move).
+
+## Gotcha
+
+- The model defaults to centered, on-axis, symmetric — name an
+  off-axis or rule-of-thirds camera or it will silently center.
+- "Golden hour" alone reads as a sunset GIF; require a sun angle.
+- ACTION written as a paragraph of adjectives ("dynamically", "powerfully")
+  fails — adapters need verbs with beat counts.
+- When `character.json` exists, paraphrasing identity tokens breaks
+  Character Lock — copy them verbatim.
+- Negative constraints in the truncated tail get dropped — load-
+  bearing ones go first.
+
+## Do NOT
+
+- Do NOT emit provider-specific tokens (aspect ratio, model id,
+  duration flags) — that is `motion-choreographer`'s scope.
+- Do NOT collapse anticipation / action / reaction into one verb.
+- Do NOT use "cinematic" without lens + lighting + camera move.
+- Do NOT invent character details when a `character.json` exists.

package/.agent-src/templates/agent-settings.md

@@ -217,6 +217,23 @@ roadmap:
   # mandatory before any "roadmap complete" claim, regardless of cadence.
   quality_cadence: end_of_roadmap
 
+# --- Quality / CI execution ---
+quality:
+  # Run local quality / CI tasks and tests autonomously (true, false)
+  # true  = agent runs the quality pipeline whenever work is ready
+  #         for verification, without asking (default)
+  # false = agent asks before running quality tools / tests locally
+  # Carve-out: NEW CI gates / smoke tests / test files MUST run
+  # locally regardless of this flag — without execution the gate is
+  # unverified evidence. Iron Law `verify-before-complete` still applies.
+  local_auto_run: true
+
+  # Wait for remote CI to finish on the PR / pipeline (true, false)
+  # true  = poll GitHub check-runs / pipeline after push and report
+  #         green / red before handing back
+  # false = push and hand back immediately (default)
+  wait_for_remote_ci: false
+
 # --- Subagent orchestration ---
 subagents:
   # Model for implementer subagents (empty = same tier as the session model)
@@ -447,6 +464,8 @@ the canonical narrative lives in
 | `hooks.chat_history.script` | path | `scripts/chat_history.py` | Override path to the chat-history CLI. Set only when the script lives outside the standard location. |
 | `pipelines.skill_improvement` | `true`, `false` | `true` | When `true`: propose learning capture after meaningful tasks. When `false`: silent. Included in every profile except `custom`. |
 | `roadmap.quality_cadence` | `end_of_roadmap`, `per_phase`, `per_step` | `end_of_roadmap` | When `/roadmap:process-step|phase|full` runs the project's quality pipeline. Default skips per-step / per-phase runs and gates only the final archival. `per_phase` runs once after every phase; `per_step` is the legacy verbose mode. Step checkboxes and the dashboard are always updated regardless. `verify-before-complete` still requires fresh output before any "roadmap complete" claim. |
+| `quality.local_auto_run` | `true`, `false` | `true` | When `true`: agent runs the project's quality pipeline (`task ci`, `make test`, `npm run check`, PHPStan, ECS, Rector, test suites) autonomously when work is ready for verification. When `false`: agent asks before running locally. **Carve-out**: NEW CI gates / smoke tests / test files MUST run locally regardless of this flag — without execution the new gate is unverified evidence. Iron Law `verify-before-complete` still applies; suppressed runs require the agent to surface the gap before claiming completion. |
+| `quality.wait_for_remote_ci` | `true`, `false` | `false` | When `true`: after `git push`, the agent polls GitHub check-runs / pipeline status on the PR and reports green / red before handing back. When `false`: agent pushes and hands back immediately; the user inspects CI themselves (default — saves agent runtime and tokens). |
 | `subagents.implementer_model` | model alias or empty | _(empty)_ | Model for implementer subagents. Empty = same tier as session model. See [subagent-configuration](../contexts/subagent-configuration.md). |
 | `subagents.judge_model` | model alias or empty | _(empty)_ | Model for judge subagents. Empty = one tier above implementer (opus if sonnet, sonnet if haiku). |
 | `subagents.max_parallel` | integer | `3` | Maximum parallel subagent invocations. `1` serializes. |

package/.agent-src/templates/agents/agent-project-settings.example.yml

@@ -39,7 +39,7 @@ schema_version: 1
 # CI guard: a release bump of `package.json` must update this value
 # in lockstep — see scripts/check_template_pin_drift.py (road-to-
 # portable-runtime-and-update-check P3.3).
-agent_config_version: "2.21.0"
+agent_config_version: "2.23.0"
 
 # --- Project identity ---
 project:

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "2.23.0",
+    "version": "2.24.0",
     "keywords": [
       "agent-config",
       "skills",
@@ -85,6 +85,7 @@
         "./.claude/skills/chat-history-import",
         "./.claude/skills/chat-history-learn",
         "./.claude/skills/chat-history-show",
+        "./.claude/skills/character-consistency",
         "./.claude/skills/check-current-md",
         "./.claude/skills/check-refs",
         "./.claude/skills/churn-prevention",
@@ -236,6 +237,7 @@
         "./.claude/skills/module-create",
         "./.claude/skills/module-explore",
         "./.claude/skills/module-management",
+        "./.claude/skills/motion-choreographer",
         "./.claude/skills/multi-tenancy",
         "./.claude/skills/nextjs-patterns",
         "./.claude/skills/okr-tree-modeling",
@@ -267,6 +269,7 @@
         "./.claude/skills/php-debugging",
         "./.claude/skills/php-service",
         "./.claude/skills/pipeline-strategy",
+        "./.claude/skills/pixar-storyteller",
         "./.claude/skills/playwright-architect",
         "./.claude/skills/playwright-testing",
         "./.claude/skills/po-discovery",
@@ -324,6 +327,7 @@
         "./.claude/skills/rule-writing",
         "./.claude/skills/runway-cognition",
         "./.claude/skills/scenario-modeling",
+        "./.claude/skills/scene-expander",
         "./.claude/skills/script-writing",
         "./.claude/skills/secrets-management",
         "./.claude/skills/security",
@@ -367,6 +371,12 @@
         "./.claude/skills/using-git-worktrees",
         "./.claude/skills/validate-feature-fit",
         "./.claude/skills/verify-completion-evidence",
+        "./.claude/skills/video",
+        "./.claude/skills/video-director",
+        "./.claude/skills/video-from-script",
+        "./.claude/skills/video-scene",
+        "./.claude/skills/video-stitch",
+        "./.claude/skills/video-storyboard",
         "./.claude/skills/vision-articulation",
         "./.claude/skills/voc-extract",
         "./.claude/skills/voice-and-tone-design",

package/CHANGELOG.md

@@ -702,6 +702,28 @@ our recommendation order, not its support status.
 > that forces a new era split (`# Era: 2.21.x`, etc.) — see
 > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
 
+## [2.24.0](https://github.com/event4u-app/agent-config/compare/2.23.0...2.24.0) (2026-05-17)
+
+### Features
+
+* **settings:** add quality.local_auto_run / wait_for_remote_ci ([a463bf1](https://github.com/event4u-app/agent-config/commit/a463bf1925a7fb192707a80c696740ba73c30ff9))
+* **ai-video:** banana-arc reference project + shared prompt library ([f3afc6d](https://github.com/event4u-app/agent-config/commit/f3afc6dddff8d70cc17572d43a4839a157d62296))
+* **ai-video:** /video:* command cluster (from-script, scene, storyboard, stitch) ([272f2ec](https://github.com/event4u-app/agent-config/commit/272f2ec82539e58a0b8d14c63bf0806618d88c88))
+* **ai-video:** 3 specialist personas (hollywood-director, pixar-storyboard-artist, ai-video-technical-director) ([b16fb50](https://github.com/event4u-app/agent-config/commit/b16fb50c47336da6d0ad6d3864f9aaf489f91f68))
+* **ai-video:** 5 specialist skills + scene-blueprint schema ([b77ecd9](https://github.com/event4u-app/agent-config/commit/b77ecd9df6d894826f172739d534db54969f9818))
+* **ai-video:** adapter contract + 5 provider adapters + smoke test ([b86f1e5](https://github.com/event4u-app/agent-config/commit/b86f1e53661d6ff0e2a7154eee0136fe77ed6d24))
+
+### Bug Fixes
+
+* **schema:** trim ai-video-technical-director persona description to 148 chars ([b1afbb1](https://github.com/event4u-app/agent-config/commit/b1afbb1d8d94b62cb49e306d104ae33d84d06f09))
+
+### Chores
+
+* **ai-video:** wire pipeline into docs, ownership, schemas, marketplace ([18a98fa](https://github.com/event4u-app/agent-config/commit/18a98fa9098d9cc7a07782e9a6a07cf47e63d842))
+* move council audit ([54074f1](https://github.com/event4u-app/agent-config/commit/54074f18db69682f656719b4de231ea8b1cbd152))
+
+Tests: 4569 (+10 since 2.23.0)
+
 ## [2.23.0](https://github.com/event4u-app/agent-config/compare/2.21.0...2.23.0) (2026-05-17)
 
 ### Features

package/README.md

@@ -2,11 +2,11 @@
 
 # Agent Config — Universal AI Agent OS
 
-[![Skills](https://img.shields.io/badge/Skills-211-1f6feb?style=flat-square)](.augment/skills/) [![Rules](https://img.shields.io/badge/Rules-79-d73a49?style=flat-square)](.augment/rules/) [![Commands](https://img.shields.io/badge/Commands-124-2da44e?style=flat-square)](.augment/commands/) [![Guidelines](https://img.shields.io/badge/Guidelines-73-8957e5?style=flat-square)](docs/guidelines/) [![Personas](https://img.shields.io/badge/Personas-22-bf8700?style=flat-square)](docs/personas.md) [![Advisors](https://img.shields.io/badge/Advisors-5-fb8500?style=flat-square)](docs/profiles.md) [![AI Tools](https://img.shields.io/badge/AI%20Tools-8-1abc9c?style=flat-square)](docs/architecture.md) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
+[![Skills](https://img.shields.io/badge/Skills-216-1f6feb?style=flat-square)](.augment/skills/) [![Rules](https://img.shields.io/badge/Rules-79-d73a49?style=flat-square)](.augment/rules/) [![Commands](https://img.shields.io/badge/Commands-129-2da44e?style=flat-square)](.augment/commands/) [![Guidelines](https://img.shields.io/badge/Guidelines-73-8957e5?style=flat-square)](docs/guidelines/) [![Personas](https://img.shields.io/badge/Personas-25-bf8700?style=flat-square)](docs/personas.md) [![Advisors](https://img.shields.io/badge/Advisors-5-fb8500?style=flat-square)](docs/profiles.md) [![AI Tools](https://img.shields.io/badge/AI%20Tools-8-1abc9c?style=flat-square)](docs/architecture.md) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
 
 > **A deterministic orchestration contract for AI agents — audited skills, governance rules, replayable state — usable by developers, founders, and creators alike.**
 
-Give your AI agents an audit-disciplined execution layer: **210 skills**, **79 governance rules**, **124 commands**, and a replayable state machine that turns any host agent (Claude Code, Augment, Cursor, Copilot, Windsurf) into a reliable team member.
+Give your AI agents an audit-disciplined execution layer: **210 skills**, **79 governance rules**, **129 commands**, and a replayable state machine that turns any host agent (Claude Code, Augment, Cursor, Copilot, Windsurf) into a reliable team member.
 
 ### Pick your profile — six entry paths
 
@@ -543,7 +543,7 @@ Deep version of the profile table above (audience · first commands ·
 first skills · preset default per profile):
 [`docs/profiles.md`](docs/profiles.md). Curated featured-commands
 subset: [`docs/featured-commands.md`](docs/featured-commands.md).
-[Browse all 124 active commands](.agent-src/commands/) · full catalog:
+[Browse all 129 active commands](.agent-src/commands/) · full catalog:
 [`docs/catalog.md`](docs/catalog.md) ·
 [skills only](docs/skills-catalog.md) · [`llms.txt`](llms.txt).
 
@@ -577,7 +577,7 @@ slash-commands)   📌 = informational marker only (no auto-discovery
 or manual wiring required)
 
 > **What this means in practice:** Claude Code gets the full project-scoped
-> package (rules + 211 skills + 124 native commands); Augment Code gets the
+> package (rules + 216 skills + 129 native commands); Augment Code gets the
 > same content but only from a single global install at `~/.augment/`.
 > Cursor, Cline, Windsurf, Gemini CLI, GitHub Copilot, Roo Code, Codex CLI,
 > and Continue.dev only get the **rules** natively; skills and commands are

package/config/agent-settings.template.yml

@@ -225,6 +225,34 @@ roadmap:
   # only if your team genuinely commits work on a calendar plate.
   horizon_weeks: 0
 
+# --- Quality / CI execution ---
+#
+# Controls whether the agent runs the project's quality pipeline
+# (`task ci`, `make test`, `npm run check`, PHPStan, ECS, Rector,
+# test suites) and whether it waits on remote CI after pushing.
+# Iron Law `verify-before-complete` still applies — when these
+# toggles suppress automatic runs, the agent MUST surface that and
+# ask before claiming completion rather than silently skipping
+# verification.
+quality:
+  # Run local quality / CI tasks and tests autonomously (true, false)
+  # true  = agent runs the quality pipeline whenever work is ready
+  #         for verification, without asking (default)
+  # false = agent asks before running quality tools / tests locally
+  #
+  # Carve-out (always runs regardless of this flag): when the change
+  # introduces a NEW CI gate, smoke test, or test file, the agent
+  # MUST execute it locally to prove the gate works. Without that
+  # execution the new gate is unverified evidence.
+  local_auto_run: true
+
+  # Wait for remote CI to finish on the PR / pipeline (true, false)
+  # true  = after push, poll GitHub check-runs / pipeline status and
+  #         report green / red before handing back
+  # false = push and hand back immediately; user inspects CI
+  #         themselves (default — saves agent runtime and tokens)
+  wait_for_remote_ci: false
+
 # --- Subagent orchestration ---
 #
 # Controls model selection and parallelism for subagent-based workflows

package/docs/adrs/caveman/0001-default-off-until-bench.md

@@ -12,7 +12,7 @@ grammar for tokens. The dialect is documented in
 the question this ADR records is **whether the dialect should default
 ON for all consumers**.
 
-The North-Star council ([`council-synthesis.md` § 7](../../../agents/audit-2026-05-14-north-star/council-synthesis.md))
+The North-Star council ([`council-synthesis.md` § 7](../../../agents/council-sessions/audit-2026-05-14-north-star/council-synthesis.md))
 landed split: two voices (token-efficiency, ops) argued default-ON
 saves 40 %+ tokens on long sessions; two voices (UX, governance)
 argued default-ON degrades novice readability and locks in a dialect
@@ -89,5 +89,5 @@ either ships default-on or gets deprecated. No middle state.
 - [`docs/contracts/compression-default-kill-criterion.md`](../../contracts/compression-default-kill-criterion.md) — kill-criterion contract.
 - [`.agent-src.uncompressed/rules/caveman-speak.md`](../../../.agent-src.uncompressed/rules/caveman-speak.md) — dialect definition.
 - [`agents/roadmaps/step-4-measurement-and-benchmark.md`](../../../agents/roadmaps/step-4-measurement-and-benchmark.md) — bench owner.
-- [`agents/audit-2026-05-14-north-star/council-synthesis.md`](../../../agents/audit-2026-05-14-north-star/council-synthesis.md) § 7 — council split.
+- [`agents/audit-2026-05-14-north-star/council-synthesis.md`](../../../agents/council-sessions/audit-2026-05-14-north-star/council-synthesis.md) § 7 — council split.
 - [`agents/roadmaps/step-11-ruflo-parity.md`](../../../agents/roadmaps/step-11-ruflo-parity.md) Phase 4 Step 3 — origin.

package/docs/adrs/cost/0001-hard-stop-hook.md

@@ -111,4 +111,4 @@ governance-layer charter.
 - [`scripts/cost/budget.mjs`](../../../scripts/cost/budget.mjs) — evaluator.
 - [`scripts/cost/preflight.mjs`](../../../scripts/cost/preflight.mjs) — this hook.
 - [`agents/roadmaps/step-11-ruflo-parity.md`](../../../agents/roadmaps/step-11-ruflo-parity.md) Phase 2 Step 3 — origin.
-- [`agents/audit-2026-05-14-north-star/external-findings.md`](../../../agents/audit-2026-05-14-north-star/external-findings.md) § 2 row "hard stop" — upstream Ruflo pattern this absorbs.
+- [`agents/audit-2026-05-14-north-star/external-findings.md`](../../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md) § 2 row "hard stop" — upstream Ruflo pattern this absorbs.

package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md

@@ -7,7 +7,7 @@
 ## Context
 
 The North-Star audit
-([`external-findings.md § 5`](../../../agents/audit-2026-05-14-north-star/external-findings.md))
+([`external-findings.md § 5`](../../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md))
 flagged "smoke contracts" as an absorbed Ruflo pattern: every
 high-traffic tier needs a fast, deterministic, measurable check that
 runs in CI and surfaces regressions before they reach the rules /
@@ -95,5 +95,5 @@ baseline, CI-dispatched on path-trigger.
 - [`scripts/smoke/`](../../../scripts/smoke/) — four scripts.
 - [`.github/workflows/smoke.yml`](../../../.github/workflows/smoke.yml) — CI dispatch.
 - [`taskfiles/engine.yml`](../../../taskfiles/engine.yml) — local aggregator.
-- [`agents/audit-2026-05-14-north-star/external-findings.md`](../../../agents/audit-2026-05-14-north-star/external-findings.md) § 5 — origin pattern.
+- [`agents/audit-2026-05-14-north-star/external-findings.md`](../../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md) § 5 — origin pattern.
 - [`agents/roadmaps/step-11-ruflo-parity.md`](../../../agents/roadmaps/step-11-ruflo-parity.md) Phase 3 (delivery) + Phase 4 Step 3 (this ADR).

package/docs/architecture.md

@@ -141,9 +141,9 @@ note, package-internal path-swap, description budget, and the
 
 | Layer | Count | Purpose |
 |---|---|---|
-| **Skills** | 211 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
+| **Skills** | 216 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
 | **Rules** | 79 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
-| **Commands** | 124 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
+| **Commands** | 129 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
 | **Guidelines** | 73 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
 | **Templates** | 7 | Scaffolds for features, roadmaps, contexts, skills, overrides |
 | **Contexts** | 5 | Shared knowledge about the system itself |

package/docs/catalog.md

@@ -1,20 +1,20 @@
 # agent-config — Public Catalog
 
-Consumer-facing catalog of all **484 public artefacts** shipped by
+Consumer-facing catalog of all **494 public artefacts** shipped by
 this package. Internal package-maintenance rules and deprecation shims
 are excluded.
 
 > **Regenerate:** `python3 scripts/generate_index.py`
 > Auto-generated — do not edit manually.
 
-## Skills (211)
+## Skills (216)
 
 | kind | name | extra | description |
 |---|---|---|---|
 | skill | [`accessibility-auditor`](../.agent-src/skills/accessibility-auditor/SKILL.md) |  | Use when reviewing UI for accessibility — WCAG 2.2 AA, keyboard nav, focus, ARIA, contrast, screen-reader semantics — even on 'is this a11y-OK?' or 'mach das barrierefrei'. |
 | skill | [`activation-design`](../.agent-src/skills/activation-design/SKILL.md) |  | Use when defining or auditing the activation event — aha-moment selection, retention correlation, falsifiable definition. Triggers on 'what is our aha moment', 'redefine activation'. |
 | skill | [`adr-create`](../.agent-src/skills/adr-create/SKILL.md) |  | Use when capturing an architectural decision — naming the file, picking the next ADR number, filling Status / Context / Decision / Consequences, and regenerating the index — even without saying 'ADR'. |
-| skill | [`adversarial-review`](../.agent-src/skills/adversarial-review/SKILL.md) |  | ONLY when user explicitly requests adversarial review, devil's advocate analysis, stress-testing a plan, or 'poke holes in this' — NOT for regular code review or design feedback. |
+| skill | [`adversarial-review`](../.agent-src/skills/adversarial-review/SKILL.md) |  | ONLY when user requests adversarial review, devil's advocate, stress-test, OR honest critique of finished work ('poke holes', 'be brutal', 'was hältst du davon') — NOT for routine code/design review. |
 | skill | [`agent-docs-writing`](../.agent-src/skills/agent-docs-writing/SKILL.md) |  | Use when reading, creating, or updating agent documentation, module docs, roadmaps, or AGENTS.md. Understands the full .augment/, agents/, and copilot-instructions structure. |
 | skill | [`agents-md-thin-root`](../.agent-src/skills/agents-md-thin-root/SKILL.md) |  | Use when editing AGENTS.md (package root) or templates/AGENTS.md (consumer) — enforces Thin-Root contract: hard char ceilings, ≥40% pointer ratio, mandatory emergency-triage block. |
 | skill | [`ai-council`](../.agent-src/skills/ai-council/SKILL.md) |  | Use when polling external AIs (OpenAI, Anthropic) outside the host session for a neutral second opinion on a roadmap, diff, prompt, or file set — or 'cross-check with another model'. |
@@ -33,6 +33,7 @@ are excluded.
 | skill | [`bug-analyzer`](../.agent-src/skills/bug-analyzer/SKILL.md) |  | Use when the user shares a Sentry error, Jira bug ticket, or error description and wants root cause analysis. Also for proactive bug hunting and code audits for hidden bugs. |
 | skill | [`build-buy-partner`](../.agent-src/skills/build-buy-partner/SKILL.md) |  | Use when deciding insource vs outsource vs acquire — integration-cost analysis, dependency-risk, optionality preservation. Triggers on 'should we build', 'buy vs partner'. |
 | skill | [`canvas-design`](../.agent-src/skills/canvas-design/SKILL.md) |  | Use when creating static visual art — posters, marketing visuals, brand assets, PDF/PNG design pieces — even if the user just says 'design a poster' or 'mach uns ein Visual'. |
+| skill | [`character-consistency`](../.agent-src/skills/character-consistency/SKILL.md) |  | Use when a character must stay visually identical across AI video scenes — locks identity tokens (silhouette, palette, wardrobe, prop) in JSON. Triggers 'character lock', 'same character'. |
 | skill | [`check-refs`](../.agent-src/skills/check-refs/SKILL.md) |  | Use when verifying cross-references between skills, rules, commands, guidelines, and context documents are not broken after edits, renames, or deletions. |
 | skill | [`churn-prevention`](../.agent-src/skills/churn-prevention/SKILL.md) |  | Use when designing churn defence — health-score signals, churn-cause split (involuntary / value / relationship / fit), early-warning loop. Triggers on 'why are accounts leaving'. |
 | skill | [`code-refactoring`](../.agent-src/skills/code-refactoring/SKILL.md) |  | Use when the user says "refactor this", "rename class", or "move method". Safely refactors PHP code — finds all callers, updates downstream dependencies, and verifies with quality tools. |
@@ -127,6 +128,7 @@ are excluded.
 | skill | [`migration-creator`](../.agent-src/skills/migration-creator/SKILL.md) |  | Use when the user says "create migration", "add column", or "new table". Creates migrations with correct table prefixes, column naming, and multi-tenant awareness. |
 | skill | [`mobile-e2e-strategy`](../.agent-src/skills/mobile-e2e-strategy/SKILL.md) |  | Use when picking a mobile E2E framework — Detox / Appium / Maestro / XCUITest / Espresso — or planning iOS Simulator / Android Emulator coverage in CI for RN, Expo, or native apps. |
 | skill | [`module-management`](../.agent-src/skills/module-management/SKILL.md) |  | Use when the user says "create module", "explore module", or works within app/Modules/. Understands module structure, auto-loading, route registration, and namespace conventions. |
+| skill | [`motion-choreographer`](../.agent-src/skills/motion-choreographer/SKILL.md) |  | Use when turning a locked still + blueprint into a provider-tuned motion prompt — camera, primary + secondary motion, physics, native-audio sync. Triggers 'motion prompt for Veo/Kling/Sora'. |
 | skill | [`multi-tenancy`](../.agent-src/skills/multi-tenancy/SKILL.md) |  | Use when working with the multi-tenant architecture — customer DB switching, FQDN routing, tenant isolation, or cross-tenant operations. |
 | skill | [`nextjs-patterns`](../.agent-src/skills/nextjs-patterns/SKILL.md) |  | Writes Next.js App Router code — Server Components, Server Actions, RSC boundaries, route handlers, caching, and streaming — matching framework conventions and project architecture. |
 | skill | [`okr-tree-modeling`](../.agent-src/skills/okr-tree-modeling/SKILL.md) |  | Use when decomposing a company objective into team OKRs, auditing a draft OKR tree, or stress-testing an existing one for measurability and laddering. |
@@ -145,6 +147,7 @@ are excluded.
 | skill | [`php-debugging`](../.agent-src/skills/php-debugging/SKILL.md) |  | Use when debugging PHP with Xdebug — breakpoints, step-through, dual-container setup, IDE configuration, header-based routing — even when the user just says 'why does this blow up on request X'. |
 | skill | [`php-service`](../.agent-src/skills/php-service/SKILL.md) |  | Use when the user says 'create service', 'new service class', or needs a PHP service following SOLID principles with proper DI and repository usage. |
 | skill | [`pipeline-strategy`](../.agent-src/skills/pipeline-strategy/SKILL.md) |  | Use when designing or auditing a sales pipeline — stage exit criteria, per-cell conversion, coverage reasoning, leak detection. Triggers on 'tighten our pipeline', 'where is the leak'. |
+| skill | [`pixar-storyteller`](../.agent-src/skills/pixar-storyteller/SKILL.md) |  | Use when turning an idea into a Pixar-style animation prompt — character sheet, scene, image, video — anchored in emotional beat, want, obstacle. Triggers 'Pixar prompt', 'animated scene'. |
 | skill | [`playwright-architect`](../.agent-src/skills/playwright-architect/SKILL.md) |  | Use when shaping a Playwright suite — locator strategy, Page Object boundaries, fixture composition, flake-prevention architecture, CI-vs-local split — even on 'design our E2E tests'. |
 | skill | [`playwright-testing`](../.agent-src/skills/playwright-testing/SKILL.md) |  | Use when writing Playwright E2E tests — browser automation, visual regression testing, Page Objects, fixtures, and reliable test patterns. |
 | skill | [`po-discovery`](../.agent-src/skills/po-discovery/SKILL.md) |  | Use when shaping a fuzzy product ask into a refined backlog item — problem framing, user-story rewrite, AC tightening — even if the user just says 'help me write this ticket'. |
@@ -184,6 +187,7 @@ are excluded.
 | skill | [`rule-writing`](../.agent-src/skills/rule-writing/SKILL.md) |  | Use when creating or editing a rule in .agent-src.uncompressed/rules/ — trigger wording, always vs auto classification, size budget — even when the user just says 'add a rule for X'. |
 | skill | [`runway-cognition`](../.agent-src/skills/runway-cognition/SKILL.md) |  | Use when reasoning about cash runway — burn shape, fundraise triggers, layoff-vs-cut-vs-grow decisions. Triggers on 'how long do we have', 'should we raise', 'cut or grow'. |
 | skill | [`scenario-modeling`](../.agent-src/skills/scenario-modeling/SKILL.md) |  | Use when constructing base / upside / downside scenarios — three-statement modeling, sensitivity analysis, optionality reasoning. Triggers on 'model the scenarios', 'what if growth halves'. |
+| skill | [`scene-expander`](../.agent-src/skills/scene-expander/SKILL.md) |  | Use when expanding a one-line idea into the 12-block Cinematic Scene Blueprint — provider-agnostic, includes optional dialogue + ambient. Triggers 'expand this scene', 'blueprint for X'. |
 | skill | [`script-writing`](../.agent-src/skills/script-writing/SKILL.md) |  | Use when adding or editing any script under `scripts/` — `--quiet` flag, `_lib/script_output` helpers, silent Taskfile wiring, Iron-Law carve-outs — even when you just say 'add a check script for X'. |
 | skill | [`secrets-management`](../.agent-src/skills/secrets-management/SKILL.md) |  | Use when picking a secrets store, designing rotation, or wiring scanning gates — multi-cloud (Vault, AWS, Azure, GCP), CI, and Kubernetes — decision framework, provider deep-dives externalized. |
 | skill | [`security`](../.agent-src/skills/security/SKILL.md) |  | Use when applying security best practices — authentication, authorization via Policies, CSRF protection, input sanitization, rate limiting, or secure coding. |
@@ -218,6 +222,7 @@ are excluded.
 | skill | [`using-git-worktrees`](../.agent-src/skills/using-git-worktrees/SKILL.md) |  | Use when starting parallel work in isolation from the current branch — spawn a git worktree with ignore-safety checks and a clean test baseline — even when the user says 'try this on the side'. |
 | skill | [`validate-feature-fit`](../.agent-src/skills/validate-feature-fit/SKILL.md) |  | Validate whether a feature request fits the existing codebase — check for duplicates, contradictions, scope creep, and architectural misfit |
 | skill | [`verify-completion-evidence`](../.agent-src/skills/verify-completion-evidence/SKILL.md) |  | Use when claiming 'done', suggesting a commit, push, or PR — runs the evidence gate so completion claims come from fresh output in this message, not memory or earlier runs. |
+| skill | [`video-director`](../.agent-src/skills/video-director/SKILL.md) |  | Use when turning a scene idea into the 11-block cinematic prompt for live-action AI video — lens, lighting, blocking, motion, negatives. Triggers 'cinematic prompt', 'film-grade scene'. |
 | skill | [`vision-articulation`](../.agent-src/skills/vision-articulation/SKILL.md) |  | Use when articulating internal vision — where we're going / why now / why us, founder-mode anchor, distinct from fundraising pitch. Triggers on 'what's our vision', 'why are we doing this'. |
 | skill | [`voc-extract`](../.agent-src/skills/voc-extract/SKILL.md) |  | Use when extracting Voice-of-Customer themes from existing artefacts — GH issues, PR threads, Sentry patterns. Triggers on 'what are users saying', 'recurring complaints', 'top themes'. |
 | skill | [`voice-and-tone-design`](../.agent-src/skills/voice-and-tone-design/SKILL.md) |  | Use when shaping brand voice — voice attributes, tone-by-context matrix, consistency review. Triggers on 'define our voice', 'why does our copy sound different on every surface'. |
@@ -304,7 +309,7 @@ are excluded.
 | rule | [`user-interaction`](../.agent-src/rules/user-interaction.md) | auto | Asking the user a question, presenting options, or summarizing progress — numbered-options Iron Law, single-recommendation rule, progress indicators |
 | rule | [`verify-before-complete`](../.agent-src/rules/verify-before-complete.md) | always | Verify before completion — run tests and quality tools before claiming done |
 
-## Commands (124)
+## Commands (129)
 
 | kind | name | cluster | description |
 |---|---|---|---|
@@ -431,6 +436,11 @@ are excluded.
 | command | [`threat-model`](../.agent-src/commands/threat-model.md) |  | Run a pre-implementation threat model on a proposed change — enumerates abuse cases, trust boundaries, and authorization gaps before the first line of code is written |
 | command | [`update-form-request-messages`](../.agent-src/commands/update-form-request-messages.md) |  | Sync the messages() method of a FormRequest class — add missing entries, link them to language keys, and clean up stale ones |
 | command | [`upstream-contribute`](../.agent-src/commands/upstream-contribute.md) |  | Contribute a learning, skill, rule, or fix from a consumer project back to the shared agent-config package |
+| command | [`video:from-script`](../.agent-src/commands/video/from-script.md) | cluster: video | Drive a script end-to-end through the AI video pipeline — scenes → blueprint → image → operator pick → motion → video → stitch. Dry-run default; network calls require explicit per-turn confirmation. |
+| command | [`video:scene`](../.agent-src/commands/video/scene.md) | cluster: video | Render a single scene from a one-line idea — scene-expander → blueprint → image → operator pick → motion → video. Dry-run default; live calls require explicit per-turn confirmation. |
+| command | [`video:stitch`](../.agent-src/commands/video/stitch.md) | cluster: video | Re-stitch existing clips in `<project>/scenes/*/` after operator edits — no re-render. ffmpeg concat driven by manifest.json. |
+| command | [`video:storyboard`](../.agent-src/commands/video/storyboard.md) | cluster: video | Image-only storyboard — script → scenes → blueprint → image render → contact-sheet PNG via ffmpeg montage. No video calls. |
+| command | [`video`](../.agent-src/commands/video.md) | cluster: video | Video-creation orchestrator — Hollywood-level AI video pipeline. Routes to from-script, scene, storyboard, stitch. |
 | command | [`work`](../.agent-src/commands/work.md) |  | Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, confidence-band gated, no auto-git. |
 
 ## Guidelines (73)