brand-research

Purpose

Given a brand (name and/or URL) and a product, produce the full creative-prep package for it: research the product, analyze the brand's running ads, measure their editorial DNA, source logos and reference photos, generate brand-anchored product + lifestyle imagery, and write the brand-context documents a downstream ad/video pipeline consumes.

The output is a brand-context pack — a self-contained set of artifacts:

• brand-summary, visual-identity, competitors, audience — the core brand context.
• existing-ads — what the brand's running ads reveal that web research misses.
• brand-grammar — the brand's editorial DNA (archetype, pacing, caption style).
• an asset manifest cataloging every sourced + generated asset with its kind, name, and usage note, plus the binary assets themselves (logos, reference photos, generated stills).
• a concept brief of brand-level ad concept seeds.

Everything is written into a single brand-pack directory under output_dir.