brand-research

# 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`. ## Inputs - `brand` (required) — the brand, used as the pack's folder name, e.g. `amex`, `liquid-death`. - `product` (required) — the specific product / SKU / offer to research, e.g. "Platinum Card", "Sparkling Water". Disambiguates brands with many SKUs. - `brand_url` (optional) — canonical homepage. Strongly recommended to avoid wrong-entity confusion (e.g. Apple band vs. Apple Inc.). - `output_dir` (optional) — directory to write the brand pack into. Defaults to ...