@event4u/agent-config 2.23.0 → 2.25.0

package/docs/contracts/file-ownership-matrix.json

@@ -741,6 +741,36 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/commands/video.md": {
+      "kind": "command",
+      "rule_type": "orchestrator",
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/from-script.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/scene.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/stitch.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/storyboard.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/commands/work.md": {
       "kind": "command",
       "rule_type": null,
@@ -981,6 +1011,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/personas/ai-video-technical-director.md": {
+      "kind": "persona",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/personas/backend-architect.md": {
       "kind": "persona",
       "rule_type": null,
@@ -1047,6 +1083,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/personas/hollywood-director.md": {
+      "kind": "persona",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/personas/people-strategist.md": {
       "kind": "persona",
       "rule_type": null,
@@ -1403,6 +1445,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/rules/media-governance-routing.md": {
+      "kind": "rule",
+      "rule_type": "auto",
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/rules/minimal-safe-diff.md": {
       "kind": "rule",
       "rule_type": "auto",
@@ -1465,6 +1513,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/rules/persona-governance.md": {
+      "kind": "rule",
+      "rule_type": "auto",
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/rules/php-coding.md": {
       "kind": "rule",
       "rule_type": "auto",
@@ -1477,6 +1531,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/rules/provider-lifecycle-discipline.md": {
+      "kind": "rule",
+      "rule_type": "auto",
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/rules/reviewer-awareness.md": {
       "kind": "rule",
       "rule_type": "auto",
@@ -1740,6 +1800,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/character-consistency/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/check-refs/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2304,6 +2370,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/multi-tenancy/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2412,6 +2484,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/playwright-architect/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2646,6 +2724,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/scene-expander/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/script-writing/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2904,6 +2988,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/video-director/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/vision-articulation/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -5177,6 +5267,132 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/commands/video.md",
+      "target": ".agent-src.uncompressed/commands/video.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video.md",
+      "target": ".agent-src.uncompressed/rules/non-destructive-by-default.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/rules/non-destructive-by-default.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/stitch.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/stitch.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/stitch.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/commands/work.md",
       "target": ".agent-src.uncompressed/commands/commit.md",
@@ -5912,6 +6128,13 @@
       "via": "body_link",
       "depth": 1
     },
+    {
+      "source": ".agent-src.uncompressed/personas/README.md",
+      "target": ".agent-src.uncompressed/rules/persona-governance.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/personas/_template-specialist/persona.md",
       "target": ".agent-src.uncompressed/personas/_template-specialist/persona.md",
@@ -5961,6 +6184,13 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/personas/ai-video-technical-director.md",
+      "target": ".agent-src.uncompressed/personas/ai-video-technical-director.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/personas/backend-architect.md",
       "target": ".agent-src.uncompressed/personas/backend-architect.md",
@@ -6038,6 +6268,13 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/personas/hollywood-director.md",
+      "target": ".agent-src.uncompressed/personas/hollywood-director.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/personas/people-strategist.md",
       "target": ".agent-src.uncompressed/personas/people-strategist.md",
@@ -6892,6 +7129,13 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/rules/media-governance-routing.md",
+      "target": ".agent-src.uncompressed/rules/media-governance-routing.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/rules/minimal-safe-diff.md",
       "target": ".agent-src.uncompressed/rules/minimal-safe-diff.md",
@@ -7102,6 +7346,27 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/rules/persona-governance.md",
+      "target": ".agent-src.uncompressed/rules/persona-governance.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/rules/persona-governance.md",
+      "target": ".agent-src.uncompressed/rules/skill-quality.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/rules/persona-governance.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/rules/php-coding.md",
       "target": ".agent-src.uncompressed/rules/php-coding.md",
@@ -7116,6 +7381,27 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/rules/provider-lifecycle-discipline.md",
+      "target": ".agent-src.uncompressed/rules/ask-when-uncertain.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/rules/provider-lifecycle-discipline.md",
+      "target": ".agent-src.uncompressed/rules/media-governance-routing.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/rules/provider-lifecycle-discipline.md",
+      "target": ".agent-src.uncompressed/rules/provider-lifecycle-discipline.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/rules/reviewer-awareness.md",
       "target": ".agent-src.uncompressed/rules/reviewer-awareness.md",
@@ -7858,6 +8144,34 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/check-refs/SKILL.md",
       "target": ".agent-src.uncompressed/skills/check-refs/SKILL.md",
@@ -9790,6 +10104,20 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/multi-tenancy/SKILL.md",
       "target": ".agent-src.uncompressed/skills/multi-tenancy/SKILL.md",
@@ -10133,6 +10461,34 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/playwright-architect/SKILL.md",
       "target": ".agent-src.uncompressed/skills/mobile-e2e-strategy/SKILL.md",
@@ -11036,6 +11392,27 @@
       "via": "body_link",
       "depth": 1
     },
+    {
+      "source": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/skills/script-writing/SKILL.md",
       "target": ".agent-src.uncompressed/contexts/contracts/frugality-charter.md",
@@ -12037,6 +12414,34 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/skills/vision-articulation/SKILL.md",
       "target": ".agent-src.uncompressed/skills/competitive-moat-analysis/SKILL.md",

package/docs/contracts/provider-lifecycle.md

@@ -0,0 +1,122 @@
+---
+stability: beta
+keep-beta-until: 2026-08-15
+---
+
+# Provider Lifecycle — AI Video / Image / Audio Adapter Tiers
+
+> **Status:** active · **Stability:** beta · **Owner:** universal-platform-refinement Phase 3
+> · **Linter:** none (declarative contract; enforced agent-in-the-loop via [`provider-lifecycle-discipline`](../../.agent-src/rules/provider-lifecycle-discipline.md))
+> · **Source-of-truth template:** [`agents/.ai-video.xml.example`](../../agents/.ai-video.xml.example)
+
+Locks the lifecycle tagging used on every adapter under
+`scripts/ai-video/adapters/` (and future `scripts/ai-image/`,
+`scripts/ai-audio/` peers). The tag is declarative — it tells the
+agent what the maintainer's confidence in the adapter is, so the
+agent can refuse to *default* to an under-validated provider without
+the human noticing.
+
+## § 1 — Tiers
+
+| Tier | Meaning | Default-eligibility |
+|---|---|---|
+| `stable` | Maintainer-validated against a real API run at least once; dry-run output matches the documented contract; secret-redaction confirmed on a live response | **Yes** — `/video:*` / `/image:*` / `/audio:*` commands may default to a `stable` adapter |
+| `experimental` | Adapter shipped; structural shape matches the contract; **no real-API smoke run by a maintainer yet** | **No** — must be invoked explicitly (`--provider <id>`), never silently the default |
+| `deprecated` | Replaced by a successor; kept for one release window so consumer scripts can migrate | **No** — refusal-and-surface: the agent names the successor before running |
+| `community` | Contributed externally; maintained on a best-effort basis; behaviour outside the maintainer's smoke-test matrix | **No** — explicit opt-in only; the agent surfaces "community-tier provider" in the run summary |
+
+## § 2 — Promotion path
+
+`experimental → stable` requires three checkmarks on the same commit
+(or on a tightly-scoped follow-up commit referencing the original):
+
+1. **Real-API smoke run** — at least one live `submit / poll / fetch`
+   cycle (or `run` for sync adapters) against the documented
+   `default-model`, captured under
+   `agents/ai-video/smoke-traces/<provider>.md` with timestamp,
+   model id, and **redacted** response shape.
+2. **Secret-redaction confirmation** — the captured trace, re-read
+   through `scripts/ai-video/lib/redact.sh`, shows zero residual
+   key fragments.
+3. **Contract conformance** — the adapter's four-method shell
+   surface (`submit / poll / fetch / dry-run` *or* `run / dry-run`)
+   matches `scripts/ai-video/lib/adapter-contract.md` verbatim.
+
+A maintainer flipping the tier in `agents/.ai-video.xml.example`
+**and** the adapter header comment is the promotion event. There is
+no separate registry — the example file is the registry.
+
+## § 3 — Demotion criteria
+
+`stable → experimental` (or `stable → deprecated`) on any of:
+
+- **Provider API contract drift** that breaks the adapter against
+  the documented `default-model` for ≥ 7 calendar days without a
+  maintainer fix.
+- **Auth-flow change** that invalidates the redaction matchers in
+  `lib/redact.sh` until the matchers are extended.
+- **Successor adapter declared** (use `deprecated`, not
+  `experimental`, and record the successor in the header comment).
+
+Demotion is the maintainer's call; the rule does not auto-demote.
+
+## § 4 — Agent obligations
+
+When the agent picks a provider for a `/video:*` / `/image:*` /
+`/audio:*` run, it MUST:
+
+1. **Read** the `provider_lifecycle` tag from the adapter's header
+   comment **and** the matching `<provider id="…">` block in
+   `agents/.ai-video.xml.example` (or the operator's
+   `agents/.ai-video.xml`).
+2. **Refuse-and-surface** if the operator's resolved default is a
+   non-`stable` tier — name the tier and the path to this contract
+   document, then emit one clarifying question (per
+   [`ask-when-uncertain`](../../.augment/rules/ask-when-uncertain.md)):
+   either pick a `stable` provider, or confirm the non-stable run.
+3. **Record** in the run summary which tier the chosen adapter
+   carries — this is the audit log entry the agent-in-the-loop
+   model rests on.
+
+The agent never picks `deprecated` silently. If a successor is
+declared, the agent surfaces "X is deprecated; successor: Y" before
+running.
+
+## § 5 — Day-one assignment
+
+The five shipped adapters carry the following tiers on the day
+this contract lands (PR `universal-platform-refinement`):
+
+| Adapter | Kind | Tier | Rationale |
+|---|---|---|---|
+| `openai-images` | image | `experimental` | Structural shape conformant; no maintainer real-API smoke captured yet |
+| `gemini-veo` | video | `experimental` | Default video provider; no real-API smoke captured yet |
+| `kling` | video | `experimental` | Async contract conformant; no maintainer real-API smoke captured yet |
+| `higgsfield` | image+video | `experimental` | Capability-discovery path conformant; no real-API smoke captured yet |
+| `sora` | video | `experimental` | Structural-prompt path conformant; no real-API smoke captured yet |
+
+**All five start as `experimental` on day one.** The promotion to
+`stable` happens per-adapter, on the commit that records the first
+real-API smoke trace. This is conservative by construction: a
+`/video:*` run today resolves to a default that is `experimental`,
+so the agent surfaces the tier and asks before proceeding — the
+human is the policy decision point.
+
+The `<default-image-provider>` and `<default-video-provider>`
+entries in `agents/.ai-video.xml.example` remain unchanged
+(`openai-images` and `gemini-veo`). The tier tag does not change
+defaults; it changes whether the agent silently honours them.
+
+## § 6 — Versioning
+
+Tier rename or new tier is breaking (linter and adapter headers
+both flip); promotion / demotion of an individual adapter is not
+breaking. The Day-One Assignment table above is the per-release
+snapshot — older snapshots live in git history, not in this file.
+
+## See also
+
+- [`provider-lifecycle-discipline`](../../.agent-src/rules/provider-lifecycle-discipline.md) — the tier-2 routing rule that surfaces this contract when a provider is touched.
+- [`scripts/ai-video/lib/adapter-contract.md`](../../scripts/ai-video/lib/adapter-contract.md) — the four-method shell contract every adapter implements.
+- [`agents/.ai-video.xml.example`](../../agents/.ai-video.xml.example) — operator-facing provider configuration template (carries the tier tag inline).
+- [`agents/policies/media/README.md`](../../agents/policies/media/README.md) — the agent-in-the-loop enforcement model this contract participates in.