# Meta Ads Agent — Knowledge Library Index

This library contains the Meta Ads Agent's master instructions plus 9 companion guides, forming a complete enterprise operating system for planning, building, auditing, diagnosing, optimising, testing, QA-ing, and reporting Meta advertising.

| File | Guide | Description |
|---|---|---|
| `agent-instructions.md` | Master Instructions | Meta Ads Agent v1.0 — portable system instructions covering agent identity, mission, system boundary, operating principles, all campaign modules (Sales, Leads, Awareness, Engagement, App, Catalogue, Messaging), audience and creative frameworks, QA, reporting, and installation steps. |
| `guide-01-setup-activation.md` | Setup & Activation | Account structure, campaign build standards, event setup, and launch-readiness QA for new Meta activity. |
| `guide-02-measurement.md` | Measurement | Pixel, Conversions API, app events, CRM feedback, offline conversions, event quality, and deduplication governance. |
| `guide-03-attribution-incrementality.md` | Attribution & Incrementality | Attribution settings, conversion windows, Conversion Lift, Brand Lift, geo experiments, and causal-evidence discipline. |
| `guide-04-optimization.md` | Optimization | Budget, bidding, Advantage+ decisions, scaling logic, and marginal-return governance. |
| `guide-05-signal-quality-identity.md` | Signal Quality & Identity | Event taxonomy, identity and matching, consent, data governance, and a 100-item signal diagnosis library. |
| `guide-06-troubleshooting.md` | Troubleshooting & Root Cause | 12 decision trees and a 100-scenario root-cause registry spanning measurement, performance, delivery, and business issues. |
| `guide-07-reporting.md` | Reporting & Insights | Source-of-truth selection, KPI hierarchy, insight construction, a 150-pattern diagnostic library, and a 40-item expanded diagnosis set. |
| `guide-08-reach-frequency.md` | Reach & Frequency | Reach, frequency distribution, saturation, incremental reach, and cross-channel duplication frameworks. |
| `guide-09-testing-experimentation.md` | Testing & Experimentation | Hypothesis design, control/treatment isolation, result classification, rollout/rollback governance, and a 40-item test root-cause library. |

## Usage Notes

1. Upload `agent-instructions.md` as the system prompt / primary instructions for your Meta Ads Agent workspace.
2. Upload all 9 companion guides above as knowledge-base files in the same workspace.
3. Start a new chat for each major audit, build, diagnosis, optimisation, test, or report to keep context focused.
4. The agent will state its working mode (Plan, Build Specification, Audit, Performance Diagnosis, Optimise, Report, Experiment, QA) at the start of every response and separate facts, calculations, assumptions, unknowns, and recommendations throughout.