peec-content-intel

Peec Content Intel

Role

For one Peec prompt that the brand is losing, produce one publish-ready content brief: sub-queries, verbatim buyer pains, competitor breakdown, outline, focus keywords, and outreach targets.

Input

• project_id — Peec project (read from setup_state.json per pre-flight; do not re-resolve)
• prompt_id — the target prompt (must have ≥24h of data)
• optional date_range — default last 28 days
• language — read from setup_state.json (prompt_language); user can override per-run, but never default to en silently
• target_country — read from setup_state.json; drives forum source picks (DE→reddit/r/de+gutefrage+t3n, AT→reddit+derstandard, US→reddit+quora, CH→reddit/r/de+r/fr) and SERP/GSC market filters
• page_type — required. Must be one of the values in setup_state.page_type_taxonomy. If the user doesn't pass it, the skill infers the best fit from the funnel stage of the target prompt + competitor top-url classifications, then ASKS the user to confirm ("Suggested page_type: landing_page (Decision-stage, competitors use PRODUCT_PAGE). OK? [y/n/override]"). Never guess silently — a brief with the wrong page_type is a wasted publish cycle.
• business_type — read from setup_state.json. Used to validate page_type selection against the allowed taxonomy matrix.
• audience — read from setup_state.json. audience.primary and audience.pain_points feed the brief's "Why this page wins" + "Voice / tonality" sections directly; do not restate them in the brief prose, USE them.

Output

One markdown brief per prompt, saved at briefs/<YYYY-MM-DD>_<prompt-slug>/brief.md, plus the raw data next to it (competitor-urls.json, forum-pains.json, scoring.json). No dashboards.

Every brief starts with a front-matter block that downstream skills (peec-report, peec-learn) consume for attribution:

---
brief_id:      <YYYY-MM-DD>_<prompt-slug>
prompt_id:     pr_xxxxxx
business_type: b2b-service
page_type:     landing_page           # MUST be in setup_state.page_type_taxonomy
target_url:    /seo-retainer          # planned publish path
funnel_stage:  Decision                # from the prompt's topic
audience:
  primary:     "Shop-Owner DACH, 3-20 MA, Shopify"
  pain_hook:   "3 Agenturen gewechselt, keine Ergebnisse"
success_metric_4w:
  prompt_visibility: "0% → ≥15%"
  zone_visibility:   "4% → ≥20%"
---