---
execution_contract:
  script: "execution/generate_engagement_report.py"
  args:
    --db: "D:\\TadpoleOS-Dev\\data\\tadpole.db"
    --output: "D:\\TadpoleOS-Dev\\reports"
  outputs:
    - "D:\\TadpoleOS-Dev\\reports\\ENGAGEMENT_SUMMARY_[DATE].md"
---

> [!IMPORTANT]
> **AI Assist Note (Knowledge Heritage)**:
> This document is part of the "Sovereign Reality" documentation.
> - **@docs ARCHITECTURE:Core**
> - **Failure Path**: Information drift, legacy terminology, or documentation mismatch.
> - **Telemetry Link**: Search `[engagement_report]` in audit logs.
>
> ### AI Assist Note
> 📈 Directive: Engagement Report (SOP-MKT-07)
>
> ### 🔍 Debugging & Observability
> Traceability via `execution/parity_guard.py`.

# 📈 Directive: Engagement Report (SOP-MKT-07)

## 🎯 Primary Objective
Monitor and report on the overall "Signal Strength" of the Tadpole OS ecosystem. This directive provides the high-level metrics needed for strategic resource allocation.

---

## 📊 Key Performance Indicators (KPIs)

### 1. Swarm Growth
- **Metric**: Total active agents and clusters created over the reporting period.
- **Metric**: "Recruitment Pulse" — average depth of autonomous sub-agent recruitment.

### 2. Community Velocity
- **Metric**: New contributors to `tadpole-os-templates`.
- **Metric**: Social media engagement (mentions, shares, stars).

### 3. Technical Usage
- **Metric**: Most used "dynamic skills" and "standard workflows."
- **Metric**: Aggregate token efficiency (Output Tokens / Input Tokens) across the cluster.

---

## 🛠️ Data Aggregation SOP

### 1. Backend Ingestion
- **Source**: `tadpole.db` benchmarks and oversight logs.
- **Action**: Extract performance deltas since the last `engagement_report.md`.

### 2. Strategic Synthesis
- **Action**: Identify "Dormant Potential." Which features are under-utilized relative to their performance value?

---

## 📝 Reporting Protocol
Generate the `ENGAGEMENT_SUMMARY_[DATE].md` in the `reports/` directory. The report must be presented to the Oversight Board (authorized users) during the monthly `ops_review.md`.
[//]: # (Metadata: [engagement_report])
