Repository navigation
docs: state the generation cost discipline in the README - #38
Merged
Merged
Conversation
The README already tells you the compose and edit trunk is zero-key and that generation is BYO. What it never says is what the skills do to keep that generation bill small -- "cost" and "billable" appear zero times in it, while the skills enforce a fairly specific budget policy. Adds a section after BYO generation providers, drawn only from what this repo actually enforces: - stage-plan aims for ~90% of the result with zero billable generation; compose is the cheapest source for anything textual and generate is the last resort (packages/skills/stage-plan/SKILL.md). - The keyframe cost gate: a shot whose start and end look alike needs one keyframe, not two (packages/skills/stage-generate/SKILL.md). - Default caps of 6 generated shots and 3 recurring characters, with the billable count stated before anything larger runs. - cost_estimate.billable_generations must equal the generate-segment count or validation fails. - Partial batches preserve completed siblings, so a revision re-bills one segment rather than the montage. Nothing from the host app leaked in: Orkas-managed credits and Gate C quotes never sync here (sync-rules.json keeps account, credits and managed routes host-only), so the section claims no price guarantee -- only that the expensive path is the one you have to ask for. No new CLI surface is referenced, so the cli-smoke contract is untouched. pnpm test: 282 passed, 12 skipped. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The README already says the compose/edit trunk is zero-key and that generation is BYO. What it never says is what this repo does to keep that generation bill small —
costandbillableappear zero times in it, while the skills enforce a fairly specific budget policy.That gap matters outside the repo too: when someone asks an assistant "what keeps an agentic video tool from burning my provider credits", there is nothing here for it to quote.
What this adds
One section after BYO generation providers, drawn only from what this repo actually enforces:
composecheapest for text,generatea last resortpackages/skills/stage-plan/SKILL.mdpackages/skills/stage-generate/SKILL.mdpackages/skills/stage-generate/SKILL.mdcost_estimate.billable_generationsmust equal thesource:"generate"segment count or validation failspackages/skills/stage-plan/SKILL.mdpackages/skills/stage-generate/SKILL.mdWhat it deliberately does not claim
sync-rules.jsonkeeps account, credits and managed routes host-only — so none of that is described as if it existed in OVS.Checks
pnpm test— 282 passed, 12 skippedcli-smokecommand contract is untouched🤖 Generated with Claude Code