Bravado
You built it, you shipped it, now show your Bravado.
Intake
- Accept a public site or GitHub repository URL, or a supplied resume/portfolio. For documents, read the actual artifact and preserve factual distinctions between employment, shipped work, and prototypes; do not invent metrics or endorsements. Inspect it with web search and direct UI/source tools as appropriate. For a repo, follow the homepage or deployment when available. Record the exact URL and access date. Read the page's visual presentation, not just its text.
- Establish current product behavior, audience, brand assets, fonts, palette, key message, CTA, and evidence for any metric. Distinguish a working feature from a roadmap item. If a source is private or blocked, use what is available and identify the gap.
- For a resume or personal portfolio, choose a role-relevant narrative and visual metaphors; omit personal phone, email, and address from the film unless requested. Use an approved portfolio/profile CTA or a simple name/title closing.
- If the user gives an existing reference video, inspect its visual timeline and audio. Derive the motion grammar; do not lift its footage or soundtrack.
Produce
- Follow the workflow to write a seven-scene arc and frame-level beat sheet. State one idea per scene. Fit copy to the actual product and choose a graphic metaphor that explains it.
- Bootstrap the template with
python scripts/bootstrap.py /absolute/output/directory, then runpython setup_fonts.pyinside the copied directory. This copies the renderer, sample brief, and dependencies fromassets/starter. Alternatively use the Bravado repository if the user already has it checked out. - Create a new JSON brief from
projects/cadence.json. Adapt the code inrender.pywhen the product is not a payroll flow: replace day tiles, money counter, wallet cards, and receipts with appropriate data and diagram logic. Do not merely rename Cadence labels. - Validate starter briefs with
python render.py --brief projects/your-project.json --validate-only(custom renderers should validate their own inputs). Render stills first:python render.py --brief projects/your-project.json --out output --stills. Inspectoutput/review/storyboard.jpgandboundary-*.jpgframes before, during, and after each transition. Iterate the typography, crop, spacing, pacing, illustration, and motion. - Render the full MP4, listen to it, and run
python verify_export.py output/your-film.mp4. This checks the export contract and decodes both streams through the end; it cannot judge story, legibility, or sound quality. Align audio hits to real visual actions. Inspect the exported video. Keep illustrative numbers visibly labeled and calculate them from consistent units. - Deliver the MP4 and editable project. Summarize the visual choices and remaining uncertainties. Save durable user-facing artifacts using the applicable storage workflow.
Quality gate
Use the quality bar before delivery. The goal is the quality of the Cadence example: intentional typography, moving diagrams, coordinated scene choreography, and original sound. The template is a starting point, never a substitute for product-specific art direction. Do not promise an exact match to a tool or font unless source evidence supports it.
