observability-and-growth
Full instrumentation from day one. PostHog consolidates product analytics + feature flags + error tracking (one platform, one bill). GA4 via GTM (14-step automation, custom dimensions over events, server-side tagging). Sentry (deep error tracking + performance). Stripe (webhook-f
Install
npx skills add https://github.com/heymegabyte/agent-skills/tree/main/13-observability-and-growth
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install heymegabyte-agent-skills@llmmart
git clone https://github.com/heymegabyte/agent-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole heymegabyte/agent-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
13 — Observability and Growth
Tiered PostHog+Sentry+GA4 stacks wired from day one; feature flags, PLG patterns, incident auto-remediation.
Instrumentation tiers
Per _kernel/standards.md#integrations:
- Tier 1 (solo) — PostHog + Workers Tracing OTLP (2 vendors max, cookie-free, free tier covers <10k MAU)
- Tier 2 (enterprise) — + Sentry
@sentry/cloudflarev9 + GA4/GTM + Axiom - Tier 3 (LLM-heavy >10k calls/mo) — + AI Gateway
PostHog (Tier 1 cornerstone)
- Snippet on every HTML page w/
persistence:'memory'(cookie-free);capture_pageview+capture_pageleave+autocapture:true - Unified platform: product analytics + feature flags + session replay + error tracking
- CSP:
script-src+connect-srcfor posthog domain - Per-feature event naming:
<feature>:<action>(signup:complete,editor:save,share:copy)
Sentry (Tier 2)
@sentry/cloudflarev11 (stream trace lifecycle default since 11.0) +withSentrywrapper; project viamcp__sentry__create_project(org:megabyte-labs)SENTRY_DSNviawrangler secret put- Pattern:
withSentry(env => ({ dsn, tracesSampleRate: 1.0, sendDefaultPii: false }), worker) - Breadcrumbs before risky ops; capture exception w/ context tags (
worker|route|userId) - Release tracking via
SENTRY_RELEASEenv; Workers Tracing handles I/O spans
Workers Tracing (Tier 1 + 2) / GA4 + GTM (Tier 2) / AI Gateway (Tier 3)
- Workers Tracing:
[observability] enabled = trueinwrangler.jsonc— zero-config OTel I/O tracing; export to Axiom, Honeycomb, Grafana, Datadog via@opentelemetry/exporter-trace-otlp-http - GA4 + GTM: container snippet (head script + noscript iframe); CSP:
googletagmanager.com+google-analytics.com+analytics.google.com+region1.google-analytics.com; server-side tagging for EU; custom dimensions over custom events - AI Gateway:
env.AI.run()auto-routes; direct Anthropic:https://gateway.ai.cloudflare.com/v1/{account}/{gateway}/anthropic/v1/messages; caching + rate-limit + fallback + per-call logging
Stripe + Link (accept-money default, ALL flows — per rules/payments.md)
- Accept default w/ Link ON everywhere (Payment Element / Checkout / Payment Links); Instant Bank Payments on high-ticket + donation flows
- Webhook-first w/ idempotent processing (D1 dedupe table
payment_events(event_id, source, processed_at)UNIQUE) Stripe-SignatureHMAC + 5-min replay window- Mint products + prices via MCP (idempotent via
lookup_key); subscription state machine in D1 STRIPE_WEBHOOK_SECRETviaPOST /v1/webhook_endpoints
Square (on-request rail ONLY — per rules/payments.md)
- Only when the prompt names Square: Web Payments SDK card form + Apple Pay + Google Pay + Cash App Pay
Square-SignatureHMAC-SHA256 w/ 6-hr replay window;idempotency_keyUUID per request (24-hr dedupe)- No 501(c)(3) discount exists (verified 2026-10) — custom rates only ≥$250K/yr
Listmonk (newsletter — self-hosted on Coolify)
- Amazon SES SMTP relay (
LISTMONK_FROM_EMAIL);listmonkSendTx(env, { templateAlias, ... })via KV-cached alias→id map - Templates in
emails/*.htmlsynced viascripts/listmonk-sync.mjs - Auth:
Authorization: token <user>:<key>(Listmonk 3.x API-user pattern)
PLG 7-Layer Framework
- Discovery — SEO + AI search + word-of-mouth + paid
- Sign-up — passwordless preferred (Clerk M2M JWT)
- Activation — first-value-in-X-min metric (aha moment per
rules/feature-flags.mdinstrumentation) - Engagement — DAU/MAU ratio, session depth
- Retention — D1/D7/D30 cohort
- Revenue — upgrade trigger, expansion
- Referral — viral coefficient, two-sided rewards
Programmatic SEO (5 page types)
/integrations/{tool}·/compare/{a}-vs-{b}·/for/{audience}·/templates/{type}·/{city}-{service}- Each: unique H1 + meta desc + 800+ unique words + 1 unique image + 3+ internal links + 1+ outbound citation. Cap 200 pages per axis.
- Per
rules/copy-writing.md§ pSEO +rules/thin-source-amplification.md.
GEO / AI search
- Quotable answer blocks 40-60 words (LLM citation magnet); FAQPage schema highest AI-citation rate (ChatGPT / Perplexity / Google AI Overviews)
- JSON-LD facts MUST also appear as visible HTML body text; lead paragraphs answer query in <40 words
- EEAT: author bio +
Personschema +sameAs+ dated revision + ownership statement llms.txtat site root (DX-only, <0.3% adoption — not build gate)
Local-business conversions + CRO
Track per local-conversions.md: phone_click (tel:) · direction_click (Google Maps) · form_submit · booking_click (Calendly/Cal.com) · chat_click · review_click (Google Business/Yelp). Each fires PostHog + Sentry breadcrumb + (Tier 2) GA4 conversion event.
CRO: sticky CTA bar on mobile · scroll-progress bar (subtle) · exit-intent modal (cart/pricing only, not blogs) · social proof near every CTA · urgency without dark patterns ("3 spots left this week" if true) · trust strip above fold · single primary CTA per surface.
Incident auto-remediation
Sentry → Inngest pipeline: (1) Sentry webhook on event.alert.triggered → (2) Inngest dispatches incident-responder agent → (3) agent reads event, traces to source file, proposes fix, opens PR via gh MCP → (4) PR auto-merges if all CI gates pass per rules/ai-seniority.md.
See submodules: posthog, ga4-gtm, sentry, stripe-billing, square-payments, listmonk, plg-framework, programmatic-seo, incident-remediation, geo-ai-search, local-conversions.
Files (agent-skills)
-
activation-funnel.md 11 KB
Loading… -
analytics-configuration.md 7.2 KB
Loading… -
conversion-optimization.md 4.9 KB
Loading… -
email-marketing-and-listmonk.md 8.1 KB
Loading… -
feature-flags-and-experiments.md 6.6 KB
Loading… -
mcp-server-registry.md 15 KB
Loading… -
sentry-alert-rules.md 8.7 KB
Loading… -
SKILL.md 6.8 KB
--- name: "observability-and-growth" description: "Full instrumentation from day one. PostHog consolidates product analytics + feature flags + error tracking (one platform, one bill). GA4 via GTM (14-step automation, custom dimensions over events, server-side tagging). Sentry (deep error tracking + performance). Stripe (webhook-first with idempotent processing). Listmonk on Coolify (newsletters via Amazon SES SMTP relay). PLG 7-layer framework. Programmatic SEO (5 page types). Incident auto-remediation via Sentry→Inngest pipeline. AI search (GEO) awareness. Local business conversions (phone_click, direction_click, form_submit, booking_click) with CRO patterns for both SaaS and local." metadata: version: "2.1.0" updated: "2026-05-03" effort: "high" model: "sonnet" license: "Rutgers" compatibility: claude-code: ">=2.0.0" agentskills: ">=1.0.0" submodules: - analytics-configuration.md - conversion-optimization.md - email-marketing-and-listmonk.md - feature-flags-and-experiments.md - sentry-alert-rules.md - square-payments.md - stripe-billing.md - user-feedback-collection.md - workers-tracing-otlp.md priority: 2 pack: "backend" stage: stable triggers: - "posthog" - "sentry" - "analytics" - "stripe" - "growth" paths: - "concern:observability" --- # 13 — Observability and Growth Tiered PostHog+Sentry+GA4 stacks wired from day one; feature flags, PLG patterns, incident auto-remediation. ## Instrumentation tiers Per `_kernel/standards.md#integrations`: - **Tier 1 (solo)** — PostHog + Workers Tracing OTLP (2 vendors max, cookie-free, free tier covers <10k MAU) - **Tier 2 (enterprise)** — + Sentry `@sentry/cloudflare` v9 + GA4/GTM + Axiom - **Tier 3 (LLM-heavy >10k calls/mo)** — + AI Gateway ## PostHog (Tier 1 cornerstone) - Snippet on every HTML page w/ `persistence:'memory'` (cookie-free); `capture_pageview` + `capture_pageleave` + `autocapture:true` - Unified platform: product analytics + feature flags + session replay + error tracking - CSP: `script-src` + `connect-src` for posthog domain - Per-feature event naming: `<feature>:<action>` (`signup:complete`, `editor:save`, `share:copy`) ## Sentry (Tier 2) - `@sentry/cloudflare` v11 (stream trace lifecycle default since 11.0) + `withSentry` wrapper; project via `mcp__sentry__create_project` (org:`megabyte-labs`) - `SENTRY_DSN` via `wrangler secret put` - Pattern: `withSentry(env => ({ dsn, tracesSampleRate: 1.0, sendDefaultPii: false }), worker)` - Breadcrumbs before risky ops; capture exception w/ context tags (`worker` | `route` | `userId`) - Release tracking via `SENTRY_RELEASE` env; Workers Tracing handles I/O spans ## Workers Tracing (Tier 1 + 2) / GA4 + GTM (Tier 2) / AI Gateway (Tier 3) - Workers Tracing: `[observability] enabled = true` in `wrangler.jsonc` — zero-config OTel I/O tracing; export to Axiom, Honeycomb, Grafana, Datadog via `@opentelemetry/exporter-trace-otlp-http` - GA4 + GTM: container snippet (head script + noscript iframe); CSP: `googletagmanager.com` + `google-analytics.com` + `analytics.google.com` + `region1.google-analytics.com`; server-side tagging for EU; custom dimensions over custom events - AI Gateway: `env.AI.run()` auto-routes; direct Anthropic: `https://gateway.ai.cloudflare.com/v1/{account}/{gateway}/anthropic/v1/messages`; caching + rate-limit + fallback + per-call logging ## Stripe + Link (accept-money default, ALL flows — per `rules/payments.md`) - Accept default w/ Link ON everywhere (Payment Element / Checkout / Payment Links); Instant Bank Payments on high-ticket + donation flows - Webhook-first w/ idempotent processing (D1 dedupe table `payment_events(event_id, source, processed_at)` UNIQUE) - `Stripe-Signature` HMAC + 5-min replay window - Mint products + prices via MCP (idempotent via `lookup_key`); subscription state machine in D1 - `STRIPE_WEBHOOK_SECRET` via `POST /v1/webhook_endpoints` ## Square (on-request rail ONLY — per `rules/payments.md`) - Only when the prompt names Square: Web Payments SDK card form + Apple Pay + Google Pay + Cash App Pay - `Square-Signature` HMAC-SHA256 w/ 6-hr replay window; `idempotency_key` UUID per request (24-hr dedupe) - No 501(c)(3) discount exists (verified 2026-10) — custom rates only ≥$250K/yr ## Listmonk (newsletter — self-hosted on Coolify) - Amazon SES SMTP relay (`LISTMONK_FROM_EMAIL`); `listmonkSendTx(env, { templateAlias, ... })` via KV-cached alias→id map - Templates in `emails/*.html` synced via `scripts/listmonk-sync.mjs` - Auth: `Authorization: token <user>:<key>` (Listmonk 3.x API-user pattern) ## PLG 7-Layer Framework 1. **Discovery** — SEO + AI search + word-of-mouth + paid 2. **Sign-up** — passwordless preferred (Clerk M2M JWT) 3. **Activation** — first-value-in-X-min metric (aha moment per `rules/feature-flags.md` instrumentation) 4. **Engagement** — DAU/MAU ratio, session depth 5. **Retention** — D1/D7/D30 cohort 6. **Revenue** — upgrade trigger, expansion 7. **Referral** — viral coefficient, two-sided rewards ## Programmatic SEO (5 page types) - `/integrations/{tool}` · `/compare/{a}-vs-{b}` · `/for/{audience}` · `/templates/{type}` · `/{city}-{service}` - Each: unique H1 + meta desc + 800+ unique words + 1 unique image + 3+ internal links + 1+ outbound citation. Cap 200 pages per axis. - Per `rules/copy-writing.md` § pSEO + `rules/thin-source-amplification.md`. ## GEO / AI search - Quotable answer blocks 40-60 words (LLM citation magnet); FAQPage schema highest AI-citation rate (ChatGPT / Perplexity / Google AI Overviews) - JSON-LD facts MUST also appear as visible HTML body text; lead paragraphs answer query in <40 words - EEAT: author bio + `Person` schema + `sameAs` + dated revision + ownership statement - `llms.txt` at site root (DX-only, <0.3% adoption — not build gate) ## Local-business conversions + CRO Track per `local-conversions.md`: `phone_click` (`tel:`) · `direction_click` (Google Maps) · `form_submit` · `booking_click` (Calendly/Cal.com) · `chat_click` · `review_click` (Google Business/Yelp). Each fires PostHog + Sentry breadcrumb + (Tier 2) GA4 conversion event. CRO: sticky CTA bar on mobile · scroll-progress bar (subtle) · exit-intent modal (cart/pricing only, not blogs) · social proof near every CTA · urgency without dark patterns ("3 spots left this week" if true) · trust strip above fold · single primary CTA per surface. ## Incident auto-remediation Sentry → Inngest pipeline: (1) Sentry webhook on `event.alert.triggered` → (2) Inngest dispatches `incident-responder` agent → (3) agent reads event, traces to source file, proposes fix, opens PR via gh MCP → (4) PR auto-merges if all CI gates pass per `rules/ai-seniority.md`. ## See submodules: posthog, ga4-gtm, sentry, stripe-billing, square-payments, listmonk, plg-framework, programmatic-seo, incident-remediation, geo-ai-search, local-conversions. -
square-payments.md 13.3 KB
Loading… -
stripe-billing.md 9.8 KB
Loading… -
user-feedback-collection.md 8.9 KB
Loading… -
workers-tracing-otlp.md 3 KB
Loading…
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.