ai-film-production-ledger
Record append-only AI-film prompt, asset, model, output, review, selection, and retry lineage for multi-shot production without making creative or generation decisions.
SKILL.mdskills/ai-film-production-ledger/SKILL.md
GitHubAI Film Production Ledger
Authority: record_only.
Use this Skill when a multi-shot project needs a reproducible record of the final generation candidate, submitted prompt, exact asset versions, model surface/settings, output evidence, review, selection, and retry ancestry.
Ownership
- DIRcreative remains the project, story, shot, continuity, asset, approval, and final-state owner.
- This Skill records lineage only. It is never a story owner, director, generation adapter, approval authority, or delivery authority.
- Runtime state remains the canonical project truth. Ledger entries reference its IDs and hashes rather than creating a second project state.
Deterministic contract
Validate with:
docs/film-preproduction/schemas/ai-film-production-ledger.schema.json- first snapshot:
python3 scripts/ai_film_production_ledger.py validate <ledger> --initial-ledger [--artifact-root <root>] - append:
python3 scripts/ai_film_production_ledger.py validate <ledger> --previous <snapshot> [--artifact-root <root>]
The generation-candidate envelope is immutable; output and review collections
may only append. A retry binds its parent, one primary delta, preserved
successes, exact prompt hash, real asset bytes/version hashes, model
surface/settings, expected visible proof, and optional verified cost. State
changes are separate append-only events. --initial-ledger accepts only one
genesis attempt plus one planned event; subsequent snapshots require
--previous and preserve ledger_id plus genesis_sha256.
The baseline flag is mandatory: omitting --previous cannot silently reset the
append-only boundary. Verified generation, review, selection, and delivery also
require project-relative receipt-manifest files and output bytes whose hashes
resolve beneath --artifact-root. Verified receipts are signed and their
authority keys must already be pinned in DIRcreative's host-owned review trust
registry; the generic CLI cannot introduce a key. Media-provider, human-review,
and delivery authority scopes are separate and cannot sign for one another.
State boundaries
Keep planned, attached, executed, observed_unverified,
generated_verified, selected, and delivered distinct.
- Early drafts are not attempts; record only the final candidate actually queued
for generation, or a clearly
plannedcandidate when execution is not authorized. generated_verifiedanddeliveredrequire external verified evidence.selectedrequires independent or human review evidence.verifiedcost/credits require a signed billing-provider receipt bound to the exact attempt and amount/currency; otherwise cost remainsunverified.- A failed/rejected parent is preserved; never overwrite it with a retry.
- Output paths stay project-relative, output hashes cannot be reused across
attempts,
output_idis ledger-global, and credentials, authorization headers, bearer values, cookies, and session material never enter the ledger.
The optional timeline field is a reservation for a later editorial system; this Skill does not perform editing, grading, mixing, mastering, or delivery.