@acedatacloud/skills 2026.817.4 → 2026.818.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@acedatacloud/skills",
3
- "version": "2026.817.4",
3
+ "version": "2026.818.0",
4
4
  "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
5
5
  "keywords": [
6
6
  "agent-skills",
@@ -1,225 +1,189 @@
1
1
  ---
2
2
  name: capability-spotlight-video
3
- description: Produce a recurring Ace Data Cloud Capability Spotlight series. Each run selects one live, evidence-rich platform capability, creates a representative demo that proves its unique strength, and hands a branded, non-repetitive production kit to Maestro. Use for scheduled Ace Data Cloud product videos that must rotate across image, video, chat/agent, CAPTCHA, audio, web/data, identity, and end-to-end production capabilities.
3
+ description: Plan and submit a recurring series of diverse, premium Ace Data Cloud sales films. Each run discovers live capabilities, proves a real buyer outcome, assembles a rich provenance-bound material set, chooses a structurally distinct creative genome, and routes a freeform Pro production through Maestro general-video.
4
4
  license: Apache-2.0
5
5
  metadata:
6
6
  author: acedatacloud
7
- version: "1.0"
7
+ version: "4.0"
8
8
  connections: [acedatacloud/acedatacloud]
9
- compatibility: Requires the AceDataCloud connector, AceDataCloud and Maestro MCP servers, and whichever capability MCP is selected for the current spotlight.
9
+ compatibility: Requires the AceDataCloud connector, Maestro MCP, and only the capability MCPs authorized for the selected campaign.
10
10
  ---
11
11
 
12
- # Ace Data Cloud Capability Spotlight
12
+ # Ace Data Cloud Campaign Film Director
13
13
 
14
- Create **one deep, evidence-led capability video per run**. Do not make a broad platform montage and do not default to Image APIs.
14
+ Create one **premium, product-specific sales film** per production run. The series must vary in subject, visual world, film structure, camera language, rhythm, transitions, sound, voice, and material mix—not merely palette or labels.
15
15
 
16
- Read before acting:
16
+ Read first:
17
17
 
18
18
  - [brand kit](references/brand-kit.md)
19
19
  - [topic registry](references/topic-registry.md)
20
20
 
21
21
  ## 1. Discover live truth
22
22
 
23
- Load the AceDataCloud MCP and verify candidates with the public catalog—not memory:
23
+ Load the AceDataCloud MCP and verify candidates from live public sources:
24
24
 
25
- 1. `acedatacloud_list_services(private=false, limit=300)` / `acedatacloud_get_service` — enumerate the complete current public service catalog, not a hand-maintained shortlist;
26
- 2. `acedatacloud_list_apis` / `acedatacloud_get_api_spec`
27
- 3. `acedatacloud_search_docs` / `acedatacloud_get_doc`
28
- 4. `acedatacloud_list_model_catalog` when the topic names a model
25
+ 1. `acedatacloud_list_services(private=false, limit=300)` and `acedatacloud_get_service`;
26
+ 2. `acedatacloud_list_apis` and `acedatacloud_get_api_spec`;
27
+ 3. `acedatacloud_search_docs` and `acedatacloud_get_doc`;
28
+ 4. `acedatacloud_list_model_catalog` when models matter.
29
29
 
30
- A candidate is eligible only when its service/API is live, public documentation is readable, and this run can produce or capture its required evidence. Never expose provider routing, supplier names, private IDs, signed URLs, account data, or real credentials.
30
+ A candidate is eligible only when the public service/API/docs are live and this run can execute or reuse every material required for a convincing film. Never expose private routing/source details, private IDs, signed URLs, account data, or credentials.
31
31
 
32
- ## 2. Select a non-repeating spotlight
32
+ ## 2. Generate candidates and maximize creative distance
33
33
 
34
- Read `{{run_count}}`, `{{date_iso}}`, and `{{last_output}}`. Call `maestro_list_tasks(limit=30)` and inspect recent Capability Spotlight artifact markers when available.
34
+ Read `{{run_count}}`, `{{date_iso}}`, `{{last_output}}`, `{{creative_policy}}`, and `{{format}}`. Call `maestro_list_tasks(limit=30)` and inspect recent `ADC-SPOTLIGHT:v1` artifact summaries when available.
35
35
 
36
- Extract the last 12 runs' fields:
36
+ Build at least one eligible candidate in every mode before choosing:
37
37
 
38
- `FAMILY_ID TOPIC_ID DEMO_ID STYLE_ID LAYOUT_ID PALETTE_ID VOICE_ID ASSET_HASHES EXECUTED_APIS EVIDENCE_URLS`
38
+ 1. **Single Capability** — one product/model, one distinctive buyer outcome;
39
+ 2. **Workflow Campaign** — 2–4 services producing one visible outcome;
40
+ 3. **Platform Story** — platform value proved through real cross-modal results or product lifecycles.
39
41
 
40
- Do not select from the registry as a closed menu: its anchors are examples, not an allowlist. Build at least one candidate in each mode before choosing:
42
+ For each candidate write a complete Creative Genome:
41
43
 
42
- 1. **Single Capability** — one service/model, one distinctive hero result;
43
- 2. **Workflow Campaign** — 2–4 services that produce one visible buyer outcome;
44
- 3. **Platform Story** — unified auth, catalog, SDK, tasks, billing, Agent, or automation proved by real calls/results.
44
+ `CAMPAIGN_MODE FILM_ARCHETYPE VISUAL_WORLD SHOT_GRAMMAR RHYTHM_PATTERN OPENING_DEVICE CLIMAX_DEVICE TRANSITION_SYSTEM BRAND_BEHAVIOR VOICE_ID SOUND_WORLD PALETTE_FAMILY TYPE_SYSTEM MATERIAL_MIX`
45
45
 
46
- Score every candidate on live truth, unique sales value, hero evidence, executable authorization, compatible assets, price evidence, and recent-history diversity. The highest-scoring eligible candidate wins; do not default to Image or to the easiest service.
46
+ Score live truth, sales specificity, hero strength, authorization, price proof, material richness, and **creative distance**. Apply these exclusions from the last 12 artifacts:
47
47
 
48
- Apply these exclusions:
48
+ - no recent 8 `TOPIC_ID`, buyer job, or `HERO_CASE_ID` repeat;
49
+ - no recent 6 `FILM_ARCHETYPE` or `OPENING_DEVICE` repeat;
50
+ - no recent 5 visual-world or shot-grammar repeat;
51
+ - no recent 4 campaign-mode, climax-device, or rhythm-pattern repeat;
52
+ - no recent 3 transition-system, voice-family, sound-world, or palette-family repeat;
53
+ - a returning service must change at least four of buyer, job, hero, archetype, visual world, and offer.
49
54
 
50
- - no `TOPIC_ID` from the last 8 runs for a single-capability episode;
51
- - no `DEMO_ID` or `HERO_CASE_ID` from the last 12 runs;
52
- - no recent 6 `WORKFLOW_ID` repeats;
53
- - avoid the recent 4 `CAMPAIGN_MODE`, `HOOK_ID`, and climax grammar;
54
- - avoid the last 3 voice families and palettes;
55
- - the same service may return only with a different buyer, job, hero, and offer;
56
- - derive a reproducible tiebreaker from `{{date_iso}}:{{run_count}}`; do not use unconstrained randomness;
57
- - stop when history, authorization, live pricing, or hero evidence is unavailable—never fall back to a generic showcase.
55
+ Use `date_iso:run_count` only as a deterministic tiebreaker; do not use unconstrained randomness. `creative_policy` influences scoring but never becomes a fixed shot template:
58
56
 
59
- Write the selected campaign mode and all marker IDs before generating anything.
57
+ - `auto-diverse`: maximize distance from recent work;
58
+ - `brand-anthem`: prefer platform desire and brand-led payoff;
59
+ - `product-cinematic`: prefer one product and sensorial/cinematic proof;
60
+ - `workflow-story`: prefer a visible multi-step transformation.
60
61
 
61
- ## 3. Build and prove the capability graph
62
+ Stop rather than fall back to a generic showcase when history, authorization, real hero evidence, pricing, or rich materials are unavailable.
62
63
 
63
- For a workflow candidate, build a small runtime capability graph before calling any generation tool.
64
+ ## 3. Prove workflow edges and real outcomes
64
65
 
65
- **Node contract:** service/model, input modality, output modality, sync/async lifecycle, poll API, supported reference roles, authorized MCP/Skill, price payload, and accepted asset.
66
+ For workflow candidates, build a runtime capability graph before generation.
66
67
 
67
- **Edge contract:** connect nodes only when an actual output can legally become the next input. Prove every edge from an OpenAPI input/output field or an already executed request. Valid patterns include public image URL→image edit/reference video, public video URL→remix/caption/Maestro, text/research→brief/script/voice, audio URL→reference-audio video/production, and tool trace→artifact/automation evidence. Never connect services because their names merely sound compatible.
68
+ **Node contract:** service/model, input/output modality, sync/async lifecycle, poll API, reference roles, authorized MCP, price payload, and accepted asset.
68
69
 
69
- A workflow uses **2–4 services** and sells one final outcome, not a logo parade. Each step must contribute to the same hero result and carry request/task/result evidence. A platform story needs at least two real cross-modal calls/results; a catalog card alone is not a hero.
70
+ **Edge contract:** every output must legally become the next input, proved by OpenAPI or an executed request. Never combine services because their names sound compatible. A workflow uses 2–4 services and sells one outcome, not a logo parade. A platform story requires at least three real results or product surfaces across three modalities/lifecycles; catalog cards alone are forbidden.
70
71
 
71
- aichat2 supports dynamic `load_mcp_server`, but unattended authorization is bounded. Load only the selected **2–4 MCP servers** from the current authorized pool; do not preload every schema or claim an unconnected service executed. A service outside the execution pool is eligible only when a real accepted public artifact already exists and its provenance is explicit.
72
+ Load only the selected 2–4 MCP servers from the authorized pool. A capability outside that pool is eligible only when a public accepted artifact already exists with explicit provenance.
72
73
 
73
- ## 4. Prove the unique advantage
74
+ ## 4. Reuse tasks before spending
74
75
 
75
- Load only the selected capability MCPs/Skills. Execute or reuse the selected hero recipe and inspect every final asset at full resolution.
76
+ For generated hero media, the first capability-specific call MUST be the provider's `list_tasks`/batch list with a 24-hour `created_at_min` window or closest equivalent. Do not generate before this lookup.
76
77
 
77
- The result must prove the topic's distinctive value from pixels, motion, UI, or a real task trace:
78
+ - reuse a matching completed request and accepted public URL;
79
+ - resume a matching pending task by ID;
80
+ - create only when no match exists or the match terminal-failed;
81
+ - with no list tool, resume only a `SOURCE_TASK` from this task's `last_output`.
78
82
 
79
- - generated media topics MUST execute the selected live capability and use its actual accepted output URL/MP4 as the primary visual evidence; an authored mock, illustrative example, prompt-only panel, or "not executed" disclosure can be supporting context but never satisfies the hero proof;
80
- - product topics use faithful live screenshots or real interaction evidence;
81
- - API panels are authored HTML, never screenshots of docs;
82
- - full `safe_request_json` stays evidence-only;
83
- - on-screen `display_request_json` is valid, minimal 4–7-line JSON with `Bearer $ACEDATACLOUD_API_KEY` only;
84
- - one video teaches one primary capability plus at most two supporting proofs.
83
+ Poll according to the returned interval until terminal. For activation/source preparation, reserve up to two minutes (for example eight 15-second polls). If still pending, record one `ADC-SPOTLIGHT-SOURCE:v1` draft artifact with task ID and fingerprint, make no completion claim, and end without Maestro.
85
84
 
86
- Do not accept a generic beautiful image/clip when the registry calls for typography, editing fidelity, reference consistency, multimodal control, agent tools, memory, scheduling, solving lifecycle, or review workflow.
85
+ Inspect every selected asset at full resolution. Generated media MUST use a real accepted result. Product/Agent/deployment stories use faithful, sanitized screenshots or lifecycle evidence. Full request JSON is evidence-only; customer-facing frames never contain internal review or provenance language.
87
86
 
88
- ### Async hero evidence
87
+ ## 5. Require a rich material plan
89
88
 
90
- Before creating generated hero media, the first capability-specific tool call MUST be that provider's `list_tasks`/batch-list tool with a 24-hour `created_at_min` window (or the closest supported recent-task filter). Do not call generate/create before this lookup. Compare each candidate's stored request fields—model, prompt, size/resolution, quality, count/duration, input/reference URLs, and action—against the normalized request fingerprint for the selected `TOPIC_ID` and `DEMO_ID`.
89
+ Record provenance privately, but never place labels such as `accepted output`, `decoded proof`, `evidence bundle`, task hash, or review gate in the film.
91
90
 
92
- - reuse a matching completed task's accepted URL/MP4 and do not call generate/create;
93
- - resume a matching pending task by ID instead of creating a duplicate;
94
- - create a new task only when the list call proves no match exists or the prior match is terminal-failed;
95
- - if the provider has no list tool, use a `SOURCE_TASK` ID from the current task's `last_output`; do not pretend artifacts from other scheduled tasks are visible.
91
+ ### Single Capability
96
92
 
97
- After submission, follow the MCP's returned poll interval and poll until terminal. Do not poll once and give up. For activation tests, reserve up to two minutes (for example eight 15-second polls) for hero evidence. If it is still pending after that lease, record one `ADC-SPOTLIGHT-SOURCE:v1` draft artifact containing the provider task ID, IDs/fingerprint, and no completion claim; end without Maestro. The next run must resume that task. A completed source-prep run does not count as a published Spotlight episode or consume its topic/demo diversity slot.
93
+ Require at least four useful visual roles: real input/before, accepted hero, two real details/alternates/decoded derivatives, and optionally product context/UI/brand environment. One unchanged still may not be stretched through the film. If the material cannot support varied compositions, choose another candidate.
98
94
 
99
- ## 4. Write the sales blueprint before Maestro
95
+ ### Workflow Campaign
100
96
 
101
- This is a **product sales video**, not an API walkthrough or an internal evidence reel. Before loading Maestro, write the complete human-readable plan below. Do not call Maestro until the complete blueprint passes the preflight at the end of this section.
97
+ Require 5–8 roles covering 2–4 real stages. Every stage has real input/output/task evidence and pushes the same final outcome. The final result is the hero.
102
98
 
103
- ```text
104
- SPOTLIGHT-SALES-BLUEPRINT:v2
105
- CAMPAIGN_MODE: single | workflow | platform
106
- PRODUCTS: <1–4 service/model ids>
107
- FINAL_OUTCOME: <one thing the buyer gets>
108
- AUDIENCE: <specific buyer in a specific work context>
109
- ONE-LINE VALUE: <the outcome they are buying>
110
- PAIN: <one concrete current frustration>
111
- HOOK: <the first spoken and on-screen line>
112
- BASIC_INTRO: <what it is, for whom, and the outcome>
113
- HERO CASE: <one real representative accepted example>
114
- UNIQUE ADVANTAGE: <the visibly provable reason to choose this capability/workflow/platform>
115
- WORKFLOW: <ordered service/input/output/evidence edges, or N/A>
116
- PRICE: <real quote(s), unit, source, request payload, and verification time>
117
- OFFER: <what is easy or valuable about starting now>
118
- CTA: <action plus destination>
119
- TONE: <emotional arc>
120
- VOICE: <voice id plus performance direction>
121
- ```
99
+ ### Platform Story
122
100
 
123
- Then write a scene-by-scene storyboard. Every scene includes its time range, sales purpose, exact asset role/URL, on-screen copy, verbatim narration, transition/pacing, and the claim its pixels prove.
101
+ Require at least three distinct modalities or product surfaces and three real results. At least one role must contain real motion or a real UI/task lifecycle. A catalog-only slideshow is forbidden.
124
102
 
125
- Use this 30-second persuasion sequence:
103
+ ### Audio, Agent, and Deployment
126
104
 
127
- - **0–3 seconds — Hook:** Ace Data Cloud is visible immediately while a concrete pain, desire, or striking real result earns attention. Never use a slow logo intro or open by reading the product name.
128
- - **3–7 seconds — Basic introduction:** one sentence says what the product is, who it is for, and the outcome it creates. Do not read a feature menu.
129
- - **7–17 seconds — Hero case:** the real accepted output dominates the frame and creates the visual climax. Show input→result, ordinary→distinctive, or blocked→completed according to the topic playbook.
130
- - **17–22 seconds — Three advantages:** at most three short, concrete benefits supported by the hero pixels or real workflow.
131
- - **22–26 seconds — Integration and price:** show one minimal call or one-token workflow plus one understandable live price anchor.
132
- - **26–30 seconds — Offer and CTA:** give a specific action and destination; the voice finishes with an action verb rather than reading URLs.
105
+ - audio: real audio/result, waveform or timing data, cover/lyrics/context, and an audio-reactive visual world;
106
+ - Agent: real tool trace, delivered artifact/result, and memory/schedule lifecycle—never fake chat bubbles;
107
+ - deployment: real sanitized configuration/status/lifecycle screens; without them the candidate is ineligible.
133
108
 
134
- The complete narration is **65–80 English words**, written before submission. Use short sentences, pauses, and emphasis. Its emotional arc is pain/recognition → discovery → excited reveal → confident price → decisive action. Never say `accepted output`, `decoded-pixel proof`, `evidence bundle`, or other internal review language in customer-facing copy. Do not stretch neutral documentation prose across the runtime.
109
+ ## 6. Write Sales Blueprint v3
135
110
 
136
- Map every supplied URL so Maestro never guesses:
111
+ Before Maestro, write:
137
112
 
138
113
  ```text
139
- ASSET 1 — PAIN / BEFORE — <real URL, or explicitly AUTHOR-RENDERED PAIN with no fake product/UI claim>
140
- ASSET 2 — HERO ACCEPTED OUTPUT — <mandatory accepted URL and why it proves the advantage>
141
- ASSET 3 — DETAIL / COMPARISON — <real URL or declared decoded derivative with exact crop/state>
114
+ ACE-DATA-CLOUD-SALES-BLUEPRINT:v3
115
+ CAMPAIGN_MODE: single | workflow | platform
116
+ PRODUCTS: <1–4 services/models>
117
+ FINAL_OUTCOME: <one buyer result>
118
+ AUDIENCE: <specific buyer/context>
119
+ PAIN: <concrete frustration>
120
+ PROMISE: <the outcome being sold>
121
+ HERO_CASE: <real representative result>
122
+ UNIQUE_ADVANTAGE: <visible differentiator>
123
+ WORKFLOW: <ordered proven edges, or N/A>
124
+ PRICE: <payload-bound live proof>
125
+ OFFER: <why start now>
126
+ CTA: <action + destination>
127
+ FILM_ARCHETYPE / VISUAL_WORLD / SHOT_GRAMMAR / RHYTHM_PATTERN
128
+ OPENING_DEVICE / CLIMAX_DEVICE / TRANSITION_SYSTEM
129
+ MATERIAL_MIX: <role→URL map with private provenance>
130
+ BRAND_BEHAVIOR / VOICE / SOUND_WORLD / COLOR_LOGIC / TYPE_SYSTEM
131
+ FORBIDDEN_REPETITIONS / QUALITY_GATES
142
132
  ```
143
133
 
144
- Pricing is evidence, not ad-lib copy. Prefer the actual hero call's returned Credit cost. Otherwise evaluate the topic's explicit `PRICE_SCENARIOS` payload against live pricing. Convert Credits to USD only when the current package rate is available and recorded in the blueprint. If a dynamic price cannot be evaluated, display Credits or `See live pricing`; never guess dollars, a discount, or a competitor comparison.
145
-
146
- Preflight all nine questions before loading Maestro:
147
-
148
- 1. Does the first line create a concrete pain or desire within three seconds?
149
- 2. Does one sentence explain the product, buyer, and outcome?
150
- 3. Is the hero case distinctive to this service rather than generically attractive?
151
- 4. Is there one visible climax that works without narration?
152
- 5. Are all three advantages demonstrated by this case?
153
- 6. Is the price real, current, understandable, and bound to the demo request?
154
- 7. Does the CTA say what to do and where?
155
- 8. Does the narration sound like a sales performance rather than documentation?
156
- 9. Are hook, case, pacing, and voice visibly different from recent episodes?
157
-
158
- If any answer is no, revise the blueprint before Maestro. **No real hero evidence means no Maestro submission.** The exact Maestro prompt must begin with `ADC-SPOTLIGHT:v1` as its first line, with no title, explanation, or Markdown fence before it. Put the complete blueprint verbatim from the second line onward, and include it in the draft artifact metadata so the episode is auditable before asynchronous rendering.
159
-
160
- ## 5. Choose a distinct creative system
161
-
162
- Choose compatible IDs from the registry and recent-history exclusions.
163
-
164
- Voice families:
134
+ Do **not** write a fixed six-scene or fixed timestamp storyboard. Describe emotional beats, hero moments, material roles, and 3–6 measurable quality gates; the general-video Director owns scene count, timing, layouts, and transitions.
165
135
 
166
- - high-energy launch: `energetic-male`, `bright-female` — urgent hook, visible smile on reveal, decisive CTA;
167
- - premium product desire: `storyteller-male`, `warm-female` — intimate pain, sensory reveal, confident offer;
168
- - technical confidence: `clean-female`, `calm-male`, `anchor-female` — crisp mechanism, energized hero, slower price;
169
- - benchmark/news: `anchor-female`, `deep-male` — use only when a verified metric is the hook, never as the default documentary cadence.
136
+ The Blueprint must still answer: who buys, what changes, why this product is distinctive, which real result proves it, what it costs, and what to do next. Integration/price appears only when it advances the sale. Narration length follows the selected format and must finish before the CTA hold.
170
137
 
171
- Styles: `editorial`, `swiss`, `industrial`, `luxury`, `vibrant`, `retro`, `futuristic`.
138
+ ## 7. Choose a professional, product-derived creative world
172
139
 
173
- Layouts: `split-proof`, `timeline`, `comparison-field`, `ui-walkthrough`, `kinetic-type`, `full-bleed-case-study`.
140
+ The registry is an anchor library—examples, not an allowlist. Derive a concrete world from the product's meaning, not a generic cyan dashboard.
174
141
 
175
- Preserve source-media palettes. Brand consistency comes from the approved lockup, type scale, spacing, restrained cyan signature, and CTA—not recoloring every result cyan/indigo.
142
+ Film archetype vocabulary includes brand anthem, product reveal, workflow transformation, launch trailer, kinetic manifesto, cinematic UI demo, before/after case film, multi-modal montage, metric-to-human payoff, and visual poem.
176
143
 
177
- Generate narration only through Maestro's brokered Fish override. Verify the complete transcript, seven scene beats, final spoken CTA, proper-noun pronunciation, natural pace, and no missing tail. Do not stretch narration merely to fill runtime.
144
+ Shot grammar includes macro→wide, match cuts, continuous camera, split-screen convergence, kinetic-type slam, parallax editorial, UI depth flythrough, and object-led transitions.
178
145
 
179
- ## 6. Build the production kit
146
+ Rhythm includes cold-open burst, fast-fast-slow-climax, crescendo montage, tension→release, precision pulse, and luxury restraint.
180
147
 
181
- Use the brand kit exactly. The first decoded frame names Ace Data Cloud and the capability. The final frame returns to the lockup and approved URLs.
148
+ Preserve source-media palettes. Ace identity remains canonical, but its **behavior varies**: energy rail, mask, registration system, spatial frame, light, typographic cadence, or audio sting. Do not default to the same corner watermark, cyan UI frame, centered title card, evidence card, or proof checklist.
182
149
 
183
- The kit sent to Maestro contains:
150
+ ## 8. Route production through Maestro general-video
184
151
 
185
- - live facts and source URLs;
186
- - for workflow mode, every ordered step's service, input, output, API/task ID, accepted URL, and the OpenAPI/request proof for each edge;
187
- - for platform mode, at least two real cross-modal calls/results rather than catalog-only cards;
188
- - selected IDs and recent-history exclusions;
189
- - canonical brand source and authored wordmark rules;
190
- - exact evidence assets with service→asset mapping;
191
- - evidence-only request plus display request;
192
- - the complete `SPOTLIGHT-SALES-BLUEPRINT:v2`, including hook, pain, basic introduction, hero case, three advantages, price proof, offer, CTA, storyboard, and verbatim narration;
193
- - one clear viewer promise plus voice performance/style/layout IDs;
194
- - explicit forbidden defects;
195
- - a unique UUID task ID, used for exactly one Maestro submission.
152
+ The Maestro production prompt begins with the non-routing line:
196
153
 
197
- Load Maestro only after the kit is complete. Submit one Pro production matching the requested format/language. A controlled activation test may reduce only duration and SKU to a 30-second Standard draft; it MUST still use a real accepted capability output, run final-MP4 pixel/audio inspection, execute both the initial and final-byte confirmation reviews, and satisfy every brand/evidence gate. Never disable inner review or replace live hero evidence with a mock merely to make the test faster.
154
+ `ACE-DATA-CLOUD-BRAND-FILM:v1`
198
155
 
199
- Immediately after Maestro returns an accepted task, call `publish_artifact` **before any further inspection, waiting, polling, or narration**. The literal tool output `{'code': 'task_already_exists', 'task_id': '<same UUID>'}` is a successful exact-ID idempotent replay, even when the tool wrapper labels it as an error. In that case `<same UUID>` is the one accepted task: do not generate another UUID and do not call `maestro_create_video` again. The next and only allowed tool call is `publish_artifact`, referencing that exact task ID.
156
+ It MUST NOT contain `ADC-SPOTLIGHT:v1`; that marker is reserved for the outer artifact summary. Explicitly require:
200
157
 
201
- Record the accepted Maestro task as a draft. The artifact **summary itself** must begin verbatim with the complete marker below; putting IDs only in tags does not satisfy history evidence:
158
+ - `scenario=auto`, `quality=pro`, and route to `/general-video`;
159
+ - never use `spotlight_prepare.py`, `spotlight_renderer.py`, or the fixed six-scene Spotlight template;
160
+ - read general-video's `house-style.md` and `video-composition.md`;
161
+ - write a one-sentence concept angle, embedded font pairing, and foreground-density plan;
162
+ - run prompt expansion for multi-scene work;
163
+ - name the rhythm pattern and build hero layouts before animation;
164
+ - use modular sub-compositions for 3+ hard cuts and intentional transition recipes;
165
+ - use Fish narration timing and a product-appropriate real music/SFX world;
166
+ - honor the Blueprint's Creative Genome and material-role map without displaying private provenance.
202
167
 
203
- `ADC-SPOTLIGHT:v1 | FAMILY_ID=<id> | TOPIC_ID=<id> | DEMO_ID=<id> | STYLE_ID=<id> | LAYOUT_ID=<id> | PALETTE_ID=<id> | VOICE_ID=<id> | ASSET_HASHES=<hashes> | EXECUTED_APIS=<public paths> | EVIDENCE_URLS=<accepted URLs> | MAESTRO_TASK=<uuid> | SUBMISSION=accepted`
168
+ Formal production uses **Pro**, never Standard as a quality proxy. Choose format from `{{format}}`; `auto-diverse` must also avoid the recent three formats and fit the content/channel.
204
169
 
205
- Follow the marker with live docs/API references and service→asset mapping. The outer Producer must then end; it must not poll Maestro. Artifact recording is part of submission, not a post-production step.
170
+ Immediately after Maestro accepts the unique UUID task, call `publish_artifact` before waiting or polling. Exact-ID `task_already_exists` is a successful idempotent replay: do not generate another UUID or resubmit.
206
171
 
207
- ## 7. Time-boxed review and delivery
172
+ The artifact summary—not the Maestro prompt—begins:
208
173
 
209
- Use exactly 14 evidence frames from the final MP4: extract decoded frame 0 explicitly at `-ss 0`, scene midpoints, and one frame after every transition. Build one contact sheet and read each full-size frame once. Frame 0 must already show the complete approved lockup and topic without relying on an entrance animation. Every sampled midpoint and boundary must contain sharp, meaningful scene content—no black/near-black gap, blurred placeholder, empty panel, or source-loading frame.
174
+ `ADC-SPOTLIGHT:v1 | BLUEPRINT=v3 | FAMILY_ID=<id> | TOPIC_ID=<id> | DEMO_ID=<id> | WORKFLOW_ID=<id-or-na> | FILM_ARCHETYPE=<id> | VISUAL_WORLD=<id> | SHOT_GRAMMAR=<id> | RHYTHM_PATTERN=<id> | OPENING_DEVICE=<id> | CLIMAX_DEVICE=<id> | TRANSITION_SYSTEM=<id> | STYLE_ID=<id> | PALETTE_ID=<id> | VOICE_ID=<id> | SOUND_WORLD=<id> | FORMAT=<id> | ASSET_HASHES=<hashes> | EXECUTED_APIS=<paths> | EVIDENCE_URLS=<urls> | MAESTRO_TASK=<uuid> | SUBMISSION=accepted`
210
175
 
211
- Evidence paths passed to `/visual-review` must be **sandbox-root-qualified project paths** such as `<project>/review/current`, never paths relative to the nested project directory. Verify the manifest/contact sheet exists at that exact path before invoking review; a missing-path review is a failed preflight, not a reason to consume another render.
176
+ Follow it with the complete Blueprint and role→asset provenance. The outer task ends after `recorded=true`; it must not claim the asynchronous film is complete.
212
177
 
213
- Make an actual `Skill` call with `skill="visual-review"` and the absolute initial evidence directory. If it finds blockers, perform one concentrated same-project refinement covering all findings and rerender once. Then rebuild or verify evidence from the final MP4 bytes and make a second actual `Skill` call with the absolute confirmation evidence directory. The confirmation call is mandatory even when the initial review finds no blockers and the MP4 does not change. Never restart production routing after review and never render a third full version.
178
+ ## 9. Professional review contract
214
179
 
215
- Both reviews must answer:
180
+ The Blueprint defines archetype-specific gates plus these invariants:
216
181
 
217
- 1. Is the canonical A symbol aligned with authored `ACE DATA CLOUD`, without the legacy bitmap `ceData` wordmark?
218
- 2. Can viewers identify the brand and topic within three seconds?
219
- 3. Does the evidence visibly prove this capability's unique advantage rather than a generic result?
220
- 4. Are live API facts, minimal request, input, and result correctly mapped?
221
- 5. Is the topic/demo/style/layout/palette/voice distinct from recent runs?
222
- 6. Is narration complete, natural, correctly pronounced, and matched to the chosen tone?
223
- 7. Are CTA, URLs, safe framing, transitions, and audio technically clean?
182
+ - decoded frame 0 contains clear brand or product desire—not blank/loading/disclaimer;
183
+ - real hero material is visually dominant, not reduced to evidence cards;
184
+ - composition variety and pacing match this run's genome;
185
+ - no static material is dragged beyond the limit appropriate to the archetype;
186
+ - customer copy contains no internal review language, private sourcing facts or invented claims;
187
+ - narration/audio are complete and the CTA is readable.
224
188
 
225
- After confirmation passes, Maestro writes `output/result.json`; the worker alone uploads. The draft artifact was already recorded by the outer Producer immediately after accepted submission. Never defer artifact recording until Maestro finishes and never claim the asynchronous video is finished from the outer Producer run.
189
+ Make an actual `Skill` call with `skill="visual-review"` against complete initial evidence. Fix blockers in one concentrated pass. Rebuild evidence from the exact final MP4 bytes and make a second actual confirmation call even when no initial blocker exists. The Reviewer receives the Blueprint, Creative Genome, role map, and evidence and judges whether this film fulfilled **its chosen director language**, not whether it resembles previous episodes.
@@ -48,3 +48,15 @@ At frame 0 and CTA verify:
48
48
  4. gap and clear space are balanced at full resolution;
49
49
  5. neither element is stretched, cropped, blurred, or inside a source rectangle;
50
50
  6. the lockup is readable before any entrance animation; decoded frame 0 is authoritative.
51
+
52
+ ## Identity stays fixed; brand behavior rotates
53
+
54
+ The canonical symbol crop, authored `ACE DATA CLOUD`, clear space, and public URLs never change. The way the identity behaves in motion MUST change with the Creative Genome:
55
+
56
+ - it may become an energy rail, mask edge, registration grid, spatial portal, light source, typographic cadence, object transition, or audio sting;
57
+ - it may live on a sourced palette rather than forcing every scene to cyan/navy;
58
+ - frame 0 needs immediate brand/product desire, but not a repeated static logo card;
59
+ - the middle may use an active brand system rather than a tiny corner watermark;
60
+ - CTA composition must fit this film's archetype, not reuse the same centered button every episode.
61
+
62
+ Do not repeat the same brand entrance, corner placement, cyan frame, logo scale, CTA layout, or sound sting from the recent three films. Brand consistency is identity and craft—not template sameness.
@@ -27,6 +27,17 @@ For workflow mode, prove every service edge from OpenAPI fields or an executed r
27
27
 
28
28
  Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`, `DOC_QUERY`, `MCP`, `PROMISE`, sales fields, `DEMOS`, `EVIDENCE`, `CREATIVE`, `LIMITS`.
29
29
 
30
+ ## Creative opportunity fields
31
+
32
+ Every anchor below supplies product truth and sales angles, not a fixed film template. At planning time derive and record:
33
+
34
+ - `VISUAL_WORLDS`: at least two product-derived worlds;
35
+ - `FILM_ARCHETYPES`: at least two compatible structures;
36
+ - `MATERIAL_OPPORTUNITIES`: real visual/audio/UI roles that can make the film rich;
37
+ - `FORBIDDEN_REPETITION`: the recent visual grammar or lazy treatment that would make this topic feel generic.
38
+
39
+ When a topic block has no explicit values, derive them from its promise, hero cases, evidence, and limits before eligibility scoring. A palette or voice swap alone never counts as a different creative treatment.
40
+
30
41
  ## TOPIC gpt-image-2-craft
31
42
 
32
43
  - FAMILY: ai-image
@@ -51,6 +62,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
51
62
  - `gpt2-consistent-campaign`: edit one accepted hero into 2–3 placements while preserving product, typography, and brand geometry.
52
63
  - EVIDENCE: exact source(s), accepted full-resolution result, three-column before/after/change inventory, character/crop checklist, executed API path(s), accepted evidence URL(s), and authored API panel. `gpt2-faithful-composite` specifically requires `/openai/images/edits` in `EXECUTED_APIS` and its accepted output in `EVIDENCE_URLS`; the script, labels, and narration must all agree with the inventory.
53
64
  - CREATIVE: styles `editorial,vibrant,swiss`; layouts `kinetic-type,split-proof,comparison-field`; palettes must follow the chosen recipe; voices `energetic-male,bright-female,clean-female`.
65
+ - VISUAL_WORLDS: editorial print lab; kinetic campaign wall.
66
+ - FILM_ARCHETYPES: product reveal; kinetic manifesto; before/after case film.
67
+ - MATERIAL_OPPORTUNITIES: full poster; type macro; source/edit comparison; campaign applications.
68
+ - FORBIDDEN_REPETITION: generic prompt card→image→three proof labels.
54
69
  - LIMITS: maximum 3 image calls; typography failure gets one targeted replacement; never redraw the canonical logo.
55
70
 
56
71
  ## TOPIC nano-banana-consistency
@@ -76,6 +91,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
76
91
  - `nano-character-continuity`: one non-real fictional character across four narrative beats with stable face, clothing, and proportions.
77
92
  - EVIDENCE: full 2×2 result; per-quadrant consistency matrix; exact request/result mapping.
78
93
  - CREATIVE: styles `editorial,warm,pastel`; layouts `comparison-field,full-bleed-case-study`; voices `warm-female,storyteller-male,clean-female`.
94
+ - VISUAL_WORLDS: campaign world switcher; continuity control room.
95
+ - FILM_ARCHETYPES: workflow transformation; multi-modal montage; before/after case film.
96
+ - MATERIAL_OPPORTUNITIES: 2×2 consistency wall; subject crops; environment variants; edit lifecycle.
97
+ - FORBIDDEN_REPETITION: four unrelated pretty images in a static grid.
79
98
  - LIMITS: reject if geometry or identity drifts; environments must differ visibly.
80
99
 
81
100
  ## TOPIC seedream-commercial-detail
@@ -101,6 +120,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
101
120
  - `seedream-environmental-campaign`: a bright environmental product scene with useful copy space and precise material rendering.
102
121
  - EVIDENCE: full-resolution crop details plus full frame; exact model/size request.
103
122
  - CREATIVE: styles `luxury,warm,editorial`; layouts `full-bleed-case-study,split-proof`; voices `warm-female,calm-male,storyteller-male`.
123
+ - VISUAL_WORLDS: tactile product atelier; luminous material gallery.
124
+ - FILM_ARCHETYPES: product cinematic; luxury visual poem; sensorial reveal.
125
+ - MATERIAL_OPPORTUNITIES: campaign full frame; macro crops; copy-space pan; material/light alternates.
126
+ - FORBIDDEN_REPETITION: one still-life image stretched through the runtime.
104
127
  - LIMITS: do not reuse dark glass/prism studios; no fabricated brand marks.
105
128
 
106
129
  ## TOPIC minimax-h3-multimodal
@@ -127,6 +150,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
127
150
  - `h3-cinematic-t2v`: a camera-specific text-to-video recipe with observable motion, not a static beauty shot.
128
151
  - EVIDENCE: actual input references, real accepted MP4, start/middle/end frames, request and task lifecycle.
129
152
  - CREATIVE: styles `cinematic,industrial,futuristic`; layouts `timeline,split-proof,full-bleed-case-study`; voices `energetic-male,deep-male,bright-female`.
153
+ - VISUAL_WORLDS: cinematic transition chamber; performance stage.
154
+ - FILM_ARCHETYPES: launch trailer; continuous-camera reveal; visual poem.
155
+ - MATERIAL_OPPORTUNITIES: first frame; last frame; motion clip; reference audio/waveform; decoded beats.
156
+ - FORBIDDEN_REPETITION: generic clip with no visible source→motion relationship.
130
157
  - LIMITS: one H3 generation plus one bounded replacement; video is mandatory evidence.
131
158
 
132
159
  ## TOPIC seedance-2-reference-control
@@ -154,6 +181,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
154
181
  - `seedance-audio-reference`: pair a character image and safe reference audio; verify motion/audio result without identity claims about real people.
155
182
  - EVIDENCE: actual reference media at a provider-downloadable public HTTPS URL, accepted output MP4, frame/contact sheet, minimal multimodal request, task lifecycle. Remote video APIs must never receive `data:`, `blob:`, or local-file reference URLs; upload references first and verify HTTPS reachability.
156
183
  - CREATIVE: styles `cinematic,vibrant,futuristic`; layouts `timeline,comparison-field,full-bleed-case-study`; voices `bright-female,energetic-male,storyteller-male`.
184
+ - VISUAL_WORLDS: camera-control launch bay; spatial UI world.
185
+ - FILM_ARCHETYPES: cinematic UI demo; static→motion transformation; launch trailer.
186
+ - MATERIAL_OPPORTUNITIES: approved reference; full motion clip; start/middle/end frames; structure comparison.
187
+ - FORBIDDEN_REPETITION: replaying one five-second clip for most of the film.
157
188
  - LIMITS: never use private/celebrity identity; one generation plus one replacement; video required; reference media must be a public HTTPS URL and `return_last_frame` or other 2.5-only options require a Seedance 2.5 model.
158
189
 
159
190
  ## TOPIC acechat-agent-workspace
@@ -180,6 +211,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
180
211
  - `acechat-realtime-workspace`: demonstrate the real realtime/voice connection and one supported tool interaction without fabricated UI.
181
212
  - EVIDENCE: faithful live UI capture, sanitized tool trace, public API/docs, real artifact or scheduled run metadata.
182
213
  - CREATIVE: styles `swiss,industrial,editorial`; layouts `ui-walkthrough,timeline,split-proof`; voices `clean-female,calm-male,anchor-female`.
214
+ - VISUAL_WORLDS: living operations room; tool-to-artifact workspace.
215
+ - FILM_ARCHETYPES: cinematic UI journey; workflow transformation; metric-to-human payoff.
216
+ - MATERIAL_OPPORTUNITIES: real tool trace; artifact; schedule lifecycle; sanitized UI states.
217
+ - FORBIDDEN_REPETITION: fake chat bubbles and feature-menu cards.
183
218
  - LIMITS: no account data, tokens, private memory, fake chat messages, or invented UI.
184
219
 
185
220
  ## TOPIC captcha-solving-lifecycle
@@ -206,6 +241,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
206
241
  - `captcha-family-matrix`: compare hCaptcha/reCAPTCHA/Turnstile request shapes and one successful test result without targeting third-party accounts.
207
242
  - EVIDENCE: synthetic or owned challenge only, real task IDs redacted in public frames, terminal result, minimal request/lifecycle diagram.
208
243
  - CREATIVE: styles `industrial,swiss,futuristic`; layouts `timeline,comparison-field,ui-walkthrough`; voices `calm-male,clean-female,anchor-female`.
244
+ - VISUAL_WORLDS: precision task relay; timed operations tunnel.
245
+ - FILM_ARCHETYPES: precision-pulse explainer; blocked→completed case film.
246
+ - MATERIAL_OPPORTUNITIES: owned challenge; timer/status states; result lifecycle; safe metrics.
247
+ - FORBIDDEN_REPETITION: security-bypass framing or generic architecture diagram.
209
248
  - LIMITS: authorized test use only; no bypass of third-party controls, credential collection, or private site data.
210
249
 
211
250
  ## TOPIC maestro-agent-production
@@ -232,6 +271,10 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
232
271
  - `maestro-remix`: use a safe prior task to demonstrate a targeted edit/remix with before/after evidence.
233
272
  - EVIDENCE: real sanitized progress, review frames, result manifest, final MP4, actual duration/codec; no self-referential fake process UI.
234
273
  - CREATIVE: styles `editorial,swiss,futuristic`; layouts `timeline,ui-walkthrough,comparison-field`; voices `storyteller-male,anchor-female,deep-male`.
274
+ - VISUAL_WORLDS: director room; production pipeline stage.
275
+ - FILM_ARCHETYPES: workflow transformation; behind-the-film brand piece; launch trailer.
276
+ - MATERIAL_OPPORTUNITIES: brief; real assets; composition; review frames; final MP4.
277
+ - FORBIDDEN_REPETITION: self-referential proof checklist without an emotional final film.
235
278
  - LIMITS: one parent Maestro task per Spotlight; avoid recursive unbounded video production.
236
279
 
237
280
  ## TOPIC platform-unified-api
@@ -257,4 +300,8 @@ Every anchor topic block keeps this schema: `TOPIC`, `FAMILY`, `SERVICE`, `APIS`
257
300
  - `platform-one-token-workflow`: explain one safe credential pattern across chat/image/video/search without showing private values.
258
301
  - EVIDENCE: live catalog responses, model modalities, public docs, authored architecture; no unsupported model-count claims.
259
302
  - CREATIVE: styles `swiss,editorial,industrial`; layouts `comparison-field,timeline,ui-walkthrough`; voices `anchor-female,calm-male,energetic-male`.
303
+ - VISUAL_WORLDS: multi-modal launch system; one-token creative universe.
304
+ - FILM_ARCHETYPES: brand anthem; multi-modal montage; workflow transformation.
305
+ - MATERIAL_OPPORTUNITIES: at least three real results/surfaces; one motion role; platform payoff.
306
+ - FORBIDDEN_REPETITION: catalog-card slideshow or repeated cyan dashboard.
260
307
  - LIMITS: use only live catalog facts; this is an occasional platform overview, not the default fallback.