editorbrain 0.18.0 → 0.26.0

package/skill/editorbrain-motion/references/generated-motion.md

@@ -0,0 +1,48 @@
+# Generated motion with consistent material and identity
+
+Read when a shot needs generated motion or assets. Start from the current member's verified tool/model access, effective media preferences and the task's authorized spending. Follow the provider's actual skill/schema; this guide adds no generation command or implicit permission.
+
+## Separate the controls
+
+Use four distinct layers of intent:
+
+1. **Graphic identity:** resolved customer colors, fonts and brand restrictions for authored graphic layers.
+2. **Representation:** the selected material, surface, dimensionality, edges, lighting, depth and permitted physical behavior of generated assets.
+3. **Asset identity:** stable person/object/location attributes, approved references and continuity-critical details.
+4. **Shot direction:** the scene's action, camera, staging, entry/exit state and timing.
+
+Reference images can inform representation without donating their palette, face, subject or branding. Preserve authentic footage/product/logo colors unless intentionally changed by the approved direction. Do not force all customers into the material treatment of a demonstration. If references conflict, narrow the treatment or state the conflict; do not invent a professional style name to imply coherence.
+
+For scenes sharing a treatment, save a compact, versioned representation block locally. Include only consequential constraints:
+
+```text
+Treatment version and relevant project/style IDs:
+Material, surface and dimensionality:
+Edges, lighting, depth and rendering behavior:
+Permitted deformation and movement:
+Identity references and stable attributes:
+Continuity constraints / forbidden changes:
+Graphic layers reserved for controlled composition:
+```
+
+This is a planning/prompt aid, not a new portable schema. Reuse the same block within that version while changing each shot's action and composition. Revise it deliberately when evidence shows a defect; preserve the prior version. Save reusable treatment rules into the user's style only when the task requests that scope, following [style creator](../../editorbrain/references/style-creator.md).
+
+Inspect the actual reference assets before generating motion. A video model may inherit unwanted volume, texture, colors or anatomy already present in its inputs. Correct the input or account for it in the plan; prompt wording alone cannot guarantee removal.
+
+## Give the shot a testable action
+
+Describe the message, visible start, essential action, expected finish, camera behavior and usable hold. Include constraints needed for overlays, continuity and the requested ratio. Use the provider's supported reference roles and controls; verify model/format availability instead of assuming it from the provider's name.
+
+Prefer controlled composition for exact text, data, logos and interface states. When named objects must persist, move to exact positions or follow a strict sequence, retain their identities and positions in editable layers, tracked composites or another verified control mechanism. Generative scenery/character movement can support those layers. If generation cannot meet the required action, redesign that shot or use a feasible controlled method; an attractive final pose cannot compensate for an incorrect intermediate step.
+
+A short representative test is useful when material, identity or action is uncertain. Its size follows the risk and available evidence, not a required reference count, duration or provider. Reuse task approval. Do not multiply failed generations indefinitely: after a demonstrated repeated failure, change the input, simplify the shot or choose a different feasible mechanism within authorization.
+
+## Inspect the generated result
+
+Review the output itself, not the submitted prompt or provider's success status. Check that identity, material and required props persist through movement, including occlusion, handoffs, crossings, cuts and fast changes. Inspect dense neighboring states around suspect intervals; matching start/end frames do not establish continuity.
+
+Compare the actual usable duration and action with the shot plan. Trim only when the retained interval still communicates the intended event; do not label a still-image fallback as inspected footage. Keep provider-generated audio separate from verified sound decisions, and listen before judging it. Report audio unverified when unavailable.
+
+Then review the assembled export and every delivered ratio with the shared [production review](../../editorbrain/references/production-and-review.md). Record output hash, relevant source/reference hashes, model and settings actually used, prompt/block version, accepted interval and localized deviations. Keep complete prompts and review samples private locally; carry only the necessary decisions into `direction.md`.
+
+A stable block guides generation but does not guarantee object persistence, identity fidelity or physical continuity. Describe observed success and remaining defects with time evidence; distinguish this generation's review from transfer testing on other scenes and human approval.