Client Ad Brain

A Claude Code "brain" that turns one folder into an ad shop for any ecommerce brand.

You give it a store URL. It reads the store, writes the brand file, researches how ads actually run in that niche, builds a grid of angles, then produces static ads, a 30 second video ad, and a client-facing delivery page. The generation runs on the Wireflow canvas, so every image and video node is something you can open, inspect and rerun by hand.

This repo is the shell. It ships the process, the skill docs and the templates. The client/ folder starts empty and gets filled in per brand.

Quick start

1. Clone this repo and open the folder in Claude Code.

   git clone https://github.com/a1adams/client-ad-brain.git
   cd client-ad-brain
   claude
   

2. Get a Wireflow API key from your account settings at wireflow.ai.

3. Copy .env.example to .env and paste the key in:

   WIREFLOW_API_KEY=your_key_here
   

4. In Claude Code, say:

   new client: https://theirstore.com
   

That is the whole entry point. Claude reads CLAUDE.md, follows the new-client flow, and comes back with a brand file and a research pack for you to check before anything is generated.

The five steps

1. Brand research. Claude fetches the store, pulls out the product line, prices, voice, palette and the exact wording printed on the packaging, and writes client/BRAND.md.
2. Niche research. It looks at what actually runs in that category, writes client/research/niche-ads.md, and builds client/research/angle-matrix.md: five angles across three awareness stages, one hook line per cell.
3. Static ads. One generation run per ad. The real product cutout goes in as the image reference, the prompt is the whole scene, the headline is rendered in the generation. Four gates before anything counts as an output.
4. Video ad. A 30 second vertical hybrid. An AI creator carries the talking, real product footage carries every reaction and every touch of the product.
5. Delivery. One showcase page per batch. The client gets a link, never a folder of files.

You can stop after any step. Step 1 and 2 cost nothing.

What gets generated

client/
  BRAND.md                  product line, prices, ICP, voice, palette, claims rules
  research/
    niche-ads.md            category teardown, patterns and what they mean for this brand
    angle-matrix.md         5 angles x 3 awareness stages, one hook per cell
  assets/                   product cutout and any real photography you drop in
  ads/                      finished statics at feed size and at 500px
  video/                    beat clips and the assembled cut
  delivery/                 the showcase page for each batch
  run-ledger.md             every run, its credits and its outputs

What it costs

Reading a store, writing the brand file and building the research pack are free. So is building a flow on the canvas. Only executing a flow spends Wireflow credits.

Claude is told to check the credit balance, run one test generation, show you the result, and wait for your go before any batch. Every run gets a ledger row written before it executes, so you can see the spend building rather than reading a receipt afterwards.

Requirements

• Claude Code
• A Wireflow account and API key
• Node 18+ if you want to run the local review server for delivery pages
• ffmpeg if you are assembling video ads

License

MIT. See LICENSE.