Skip to main content

Agency Business Unit

Document: Agency Overview
Status: Active
Last Updated: 2025-12-18

Purpose

Agency delivers Trending Engine intelligence as a managed service. While Platform offers self-serve SaaS, Agency provides hands-on implementation, custom builds, and ongoing support for clients who want results without managing the technology themselves.
┌─────────────────────────────────────────────────────────────────────────────┐
│                      AGENCY SERVICE MODEL                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│   AUDIT ────► PACKAGE ────► RETAINER ────► ENTERPRISE                       │
│   $1.5K        $3-15K        $2.5K+/mo       Custom                          │
│                                                                              │
│   Discovery   Fixed scope   Ongoing         Dedicated team                   │
│   Analysis    Deliverables  Support         + strategy                       │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Services Flow

Automation Audit ($1,500)

Custom Build (Package or Project)

Managed Service (Retainer)

Training & Handoff (Optional)

Service Types

ServiceDescriptionDelivery
AuditAssess current state, identify opportunities1-week report
PackageProductized automation with fixed scope2-6 weeks
ProjectCustom build with defined deliverablesVariable
RetainerOngoing support and developmentMonthly
TrainingKnowledge transfer and enablementSessions

Database Tables

Core Tables (from SCHEMA.md)

TablePurpose
agency_clientsClient companies and contacts
agency_projectsEngagements with budget/timeline
agency_deliverablesWork products with approval workflow
agency_retainersRecurring billing arrangements

Extended Tables (documented in deep-dives)

TablePurposeDocumented In
agency_packagesProductized service catalogautomation-packages.md
agency_package_purchasesPackage sales trackingautomation-packages.md
agency_credentialsSecure client credential storageclient-lifecycle.md
agency_deliverable_versionsRevision historydeliverables.md
agency_deliverable_feedbackClient feedback trackingdeliverables.md
agency_reportsGenerated reportsreporting.md
agency_report_metricsROI tracking datareporting.md
agency_automation_logsExecution logs for metricsreporting.md

Deep-Dive Documents

DocumentWhat It Covers
client-lifecycle.mdProspect → Qualified → Proposal → Onboarding → Active → Expansion
deliverables.mdWork products, templates, approval workflows, file management
automation-packages.mdProductized services, pricing tiers, Shopify integration
reporting.mdClient dashboards, ROI tracking, automated reports

Integration Points

With Platform

  • Agency delivers Platform intelligence as managed service
  • High-usage Platform users → Agency upsell targets
  • Agency-built automations → Platform templates

With Publisher

  • Publisher patterns → Agency service offerings
  • Agency dogfoods Publisher infrastructure
  • Client content needs → Publisher vertical expansion

With Store

  • Packages sold via Shopify products
  • Service purchases → auto-create agency_projects
  • Add-ons as line item properties

With Linear

  • Projects tracked as Linear projects
  • Deliverables map to Linear issues
  • Labels route work (delegate:cursor, etc.)

Economics

Revenue Model

Service TypeAvg PriceMarginVolume Target
Audit$1,50080%10/month
Starter Package$3,50070%8/month
Growth Package$8,00068%4/month
Scale Package$15,00065%2/month
Retainer$5,000/mo60%20 active

Cost Structure

Per Engagement:
├── Labor (25-35%)
│   └── PM time + execution
├── AI/Tools (5-10%)
│   └── API costs, temporary subscriptions
├── Overhead (10%)
│   └── Systems, support infrastructure
└── Margin (50-60%)
    └── Profit + reinvestment

Key Workflows

Client Acquisition

Inbound Lead → Discovery Call → Proposal → Close → Onboarding

Project Delivery

Kickoff → Build → Review → Revise → Approve → Deliver → Support

Retainer Management

Monthly Planning → Execution → Reporting → Review → Renewal

Success Metrics

MetricTargetCurrent
Client NPS> 50-
Project on-time delivery> 90%-
Retainer retention (6mo)> 80%-
Package → Retainer conversion> 40%-
Client LTV> $25,000-
Gross margin> 60%-

DocumentLocation
SCHEMA.md/SCHEMA.md
SCHEMA_CONCEPTS.md/SCHEMA_CONCEPTS.md
AI Agent Workersai-agent-workers.md
Publisher Overview/docs/publisher/OVERVIEW.md
Platform Overview/docs/platform/OVERVIEW.md