peec-report

Growth Loop Reporter

Role

Close the loop. Three questions per cycle, answered in ≤400 words:

1. What moved? — visibility trend per prompt, cluster, zone
2. Why? — which specific investment caused which lift
3. What next? — 3 prioritized actions, at least 1 stop-doing

Output is a short narrative + actions, not a dashboard. Fifteen charts don't get read. 400 words do.

Input

• project_id — Peec project
• reporting_window — weekly | monthly | quarterly
• optional baseline_date — default 28 / 90 / 180 days back
• optional include_clusters — auto-detected via zone:* tags if peec-cluster has run

Output

• One narrative at <project>/growth_loop/YYYY-MM-DD_report.md (schema below)
• One learnings.json with winners / losers / surprises / next_actions / stop_doing — consumed by the next peec-cluster and peec-outreach runs as priors

When to use

• Weekly for active projects with running content + outreach
• Monthly for retainer projects in maintenance
• Quarterly as strategy review — feeds the next peec-cluster run
• After a launch, publication, or new zone going live

Do not use when:

• Project has <4 weeks of history (too little signal)
• No content or outreach actions in the window (nothing to learn)

---

Pipeline

0. Pre-flight — setup state required

Per _shared/SETUP_STATE.md, this skill refuses to run without a completed setup:

Read <project>/growth_loop/setup_state.json
If missing OR completed_at missing OR phases_completed lacks
   {competitors, prompts, topics, tags}:
     STOP. Output:
       "No Peec setup state found at <project>/growth_loop/setup_state.json.
        Run /peec-setup first."
If completed_at older than 90 days: WARN once, continue.
Use peec_project_id from state — don't re-resolve via list_projects.

1. Pull time-series of core metrics

# Overall brand visibility trend
mcp__peec-ai__get_brand_report(
  project_id, start_date=baseline, end_date=now,
  dimensions=["date"],
  filters=[{field: "brand_id", operator: "in", values: [own_brand_id]}]
)

# Per prompt (top-N by weight)
mcp__peec-ai__get_brand_report(
  project_id, start_date=baseline, end_date=now,
  dimensions=["prompt_id", "date"],
  filters=[{field: "brand_id", operator: "in", values: [own_brand_id]}]
)

# Per zone (if zone:* tags exist)
for each zone_tag:
  mcp__peec-ai__get_brand_report(
    project_id, start_date=baseline, end_date=now,
    dimensions=["tag_id", "date"],
    filters=[{field: "tag_id", values: [zone_tag_id]}]
  )