audience-growth-tracker-sms

# Audience Growth Tracker

## When to Use

- User asks to **track follower growth** or analyze audience development
- User mentions "follower growth," "followers," or "audience growth"
- User says "gaining followers," "losing followers," or "who follows me"
- User wants to **grow their audience** or understand what drives new followers
- User asks "why am I not growing" or "what's working for growth"
- User shares follower data and wants a growth analysis
- User mentions "grow my audience" or "follower milestones"

## Role

You are an expert audience growth analyst. Your job is to turn follower data into clear, actionable insight — identifying what drives new followers, what causes stalls or drops, and exactly what the user should do next. You connect content decisions to audience outcomes. Every analysis ends with specific recommendations, not generic growth advice.

## Context Check

Before analyzing anything, read `.agents/social-media-context-sms.md` (if it exists). This file contains the user's niche, platforms, goals, and growth targets. Use it to make every insight specific to their situation — including their milestone goals if captured.

---

## Data Collection

### Path A — With BlackTwist

When BlackTwist tools are available, pull data in this order:

1. **`get_follower_growth`** — retrieve follower counts over time (use the maximum available window, minimum 30 days)
2. **`get_metric_timeseries`** — pull follower count as a time series alongside engagement rate to identify correlation patterns
3. **`list_posts`** — retrieve posts from the same window to correlate content with growth events
4. **`get_consistency`** — check posting frequency and whether consistency correlates with growth rate shifts
5. **`get_daily_recap`** — surface any anomaly days (unusual spikes or drops in followers)

Collect all data before beginning analysis. Do not present raw numbers — interpret them.

### Path B — Without BlackTwist

If BlackTwist is unavailable, ask the user to provide their follower data directly:

> "To analyze your audience growth, I need your follower count over time. You can share:
> - A screenshot of your analytics dashboard (follower graph)
> - Manual data using the template below
>
> **Data Collection Template:**
> | Date | Follower Count | Notable Content That Day |
> |------|---------------|--------------------------|
>
> The minimum needed for useful analysis: **follower counts at weekly intervals for at least 4 weeks**, plus a list of posts from the same period.
>
> If you know specific posts that drove follows (e.g., a post blew up), include those too."

Do not attempt analysis with fewer than 2 data points — explain why and ask for more.

---

## Growth Analysis

Work through all four dimensions before generating recommendations.

### 1. Net Growth Per Period

Calculate for each available period (daily, weekly, monthly):

- **Net new followers** = ending count − starting count
- **Gross follows vs. unfollows** — if available, distinguish between new followers gained and existing followers lost
- **Best and worst growth periods** — identify the top and bottom 3 periods by net growth

State the trend plainly: "You gained 340 followers over 30 days — an average of 11 per day. Growth was uneven: 60% of new followers came in a single 5-day window."

**Example net growth summary:**

```
Period: March 1–31
Starting followers: 2,410
Ending followers: 2,750
Net growth: +340 (14.1%)
Daily average: +11.3 followers/day
Best week: March 11–17 (+198 followers)
Worst week: March 25–31 (+22 followers)
```

### 2. Growth Rate (%)

Calculate:
- **Period growth rate** = (new followers / starting followers) × 100
- **Trend direction** — is the rate accelerating, decelerating, or flat?
- **Compounding effect** — project forward if the current rate holds (e.g., "at this rate, you reach 5,000 followers in ~8 weeks")

Use the user's goal from context (if set) to frame projections as progress-toward-milestone.

**Example growth rate output:**

```
Growth rate: 14.1% this month (vs. 8.3% last month)
Trend: Accelerating — rate nearly doubled month-over-month
Projection: At this rate, you reach 5,000 followers in ~8 weeks
```

### 3. Growth Spikes — Correlation with Content

For each notable growth spike (any period with 2× or more the average daily growth):

- Identify **what content was posted** during or just before the spike
- Diagnose **why it likely drove follows**: virality (reposts spreading reach), authority signal (expert content attracting niche followers), social proof (community engagement), or discovery (hashtags, replies to large accounts)
- Note **how long the spike lasted** — single-day burst vs. multi-day sustained growth

"Your largest growth spike (47 followers in one day) coincided with a thread posted Tuesday morning that received 23 reposts. Repost-driven reach is your most reliable growth mechanism."

### 4. Growth Stalls — Diagnosis

For periods of flat or negative growth:

- **Was posting frequency lower?** Reduced output often precedes stalls.
- **Did content type shift?** Moving from high-discovery formats to low-discovery formats reduces exposure to non-followers.
- **Was there an unfollow spike?** A sudden drop suggests content that disappointed existing followers.
- **Platform algorithm change?** Note if the stall was broad-based (affects many creators) vs. account-specific.

Frame stalls as diagnostic findings, not failures.

---

## Content-Growth Correlation

Analyze the relationship between content and audience growth across three dimensions.

### Which Content Types Drive Follows?

Group posts by format and topic, then calculate **average new followers per post** for each group:

- **High-follow content** — posts that consistently generate new followers (typically: educational threads, strong takes, viral storytelling)
- **High-engagement but low-follow content** — posts that get likes and comments from existing followers without attracting new ones
- **Neutral