.claude/marketing/ — Marketing Specialist data folder

Folder Layout

.claude/marketing/
│
├── briefs/                     # Campaign and content briefs (one file per initiative)
│
├── drafts/
│   ├── long/                   # Long-form drafts: blog posts, newsletter bodies, guides, press pitches
│   └── short/                  # Short-form drafts: social posts, ad copy, CTAs, push notifications
│
├── images/
│   └── specs/                  # image-spec.yaml files for every Canva brief or AI-gen request
│
├── seo/
│   ├── keywords/               # Keyword maps and long-tail target lists per topic cluster
│   ├── audits/                 # Monthly SEO + pre-publish scorecard reports
│   └── schemas/                # JSON-LD structured data snippets (MedicalWebPage, FAQPage, etc.)
│
├── newsletters/
│   ├── issues/                 # Drafted newsletter issues (one file per send)
│   └── sequences/              # Welcome series, drip, and nurture sequence briefs
│
├── campaigns/
│   └── <quarter>-<slug>/       # One subfolder per campaign e.g. 2026-q2-gp-clinic-drop/
│                               #   Contains: brief.md, assets/, performance-log.md
│
├── ads/
│   ├── creatives/              # Ad copy + image specs for Google, Meta, Reddit, LinkedIn
│   └── reports/                # Weekly spend + ROAS logs (weekly-report-YYYY-WNN.md)
│
├── research/
│   ├── brainstorms/            # YC-diagnostic outputs, idea dumps, what-if scenarios
│   ├── competitors/            # Competitor teardowns, pricing snapshots, feature matrices
│   └── market/                 # AU market sizing, audience research, channel analysis
│
├── voice/                      # Voice profile snapshots (v1.md, v2.md …); read by all writing skills
│
├── decisions/                  # Permanent decision log; one entry per non-trivial campaign decision
│                               #   Format: YYYY-MM-DD-<slug>.md; never overwrite existing entries
│
├── handoffs/                   # PM→marketing-specialist JSON contracts + completion records
│                               #   Handoff:    <task_id>.json
│                               #   Completion: <task_id>-completion.json
│
└── assets-shipped -> ../../../frontend/public/marketing/
                                # Symlink to frontend/public/marketing/ — final Gate-cleared assets
                                # served by the frontend. Write here only after §8B compliance gate.

Per-folder one-liner

Folder	How the agent uses it
briefs/	Source-of-truth brief per initiative; written before any copy or image work begins
drafts/long/	Long-form copy in progress; never publish from here — copy to assets-shipped/ after Gate
drafts/short/	Short-form copy units; frontmatter tracks channel, char limit, AHPRA check, A/B variant
images/specs/	image-spec.yaml files that Ops executes in Canva or AI-gen tools (§5.6 template)
seo/keywords/	Keyword maps per topic cluster; input to programmatic-seo and content calendar
seo/audits/	Monthly technical + pre-publish SEO scorecards from seo-audit skill
seo/schemas/	JSON-LD snippets ready to paste into <script type="application/ld+json">
newsletters/issues/	One .md per newsletter send; includes subject, preview text, body, footer
newsletters/sequences/	Multi-step drip/nurture briefs; references email-sequence skill
campaigns/<q>-<slug>/	Self-contained campaign folder: brief, assets, performance log
ads/creatives/	Ad copy + image specs per channel; includes UTM params and founder approval reference
ads/reports/	Weekly spend + ROAS reports; feed into campaign-analytics skill
research/brainstorms/	Raw idea output from superpowers:brainstorming and auto-claude-ideation-suite:ideation
research/competitors/	Competitor teardowns from apify-competitor-intelligence and competitive-teardown
research/market/	AU market research from everything-claude-code:market-research and apify-market-research
voice/	Durable voice profile; refresh only on explicit founder instruction; versioned v1, v2 …
decisions/	Permanent audit trail of every non-trivial campaign decision; never delete entries
handoffs/	PM↔marketing-specialist JSON contracts; compliance audit trail; never delete
assets-shipped/	Symlink → frontend/public/marketing/; Gate-cleared final assets only

Naming convention

All files use the format YYYY-MM-DD-<slug>.ext:

2026-05-05-gp-flyer-a4-en-zhtw.pdf
2026-05-05-newsletter-issue-001.md
2026-05-12-reddit-ama-prep.md
2026-q2-gp-clinic-drop/brief.md
weekly-report-2026-W19.md

• YYYY-MM-DD = AEDT date of creation (not publish date)
• <slug> = kebab-case descriptor; no spaces, no uppercase
• Campaign folders use <YYYY-q{N}>-<slug> to sort by quarter
• Decision logs must never be renamed after creation — they are the permanent record

This folder is the read/write data surface for the marketing-specialist agent (.claude/agents/marketing-specialist.md). The agent persists briefs, drafts, image specs, SEO maps, newsletter issues, voice profile snapshots, and campaign post-mortems here. Final shippable assets (PDFs, images, .ics files) go to frontend/public/marketing/ so the front-end can serve them.