Account health audit

Reference file

Setup & Customization Checklist

setup-customization-checklist.md

Setup & Customization Checklist

1. Data access

The audit is only as good as Step 1. Before the first run, confirm the agent can actually pull each source:

  • {{USAGE_DATA_SOURCE}} — workflows/automations with execution counts and enabled state, connected senders and integrations, registered users with last-login dates, and feature-level usage/spend for the past {{LOOKBACK_DAYS}} days. If you can't get execution counts, Section 1's dead-workflow check degrades to guesswork — fix access first.
  • {{CRM}} — company activity feed: notes, calls, emails, deal stage history.
  • {{CALL_LIBRARY}} — transcript search by account domain. Optional but strongly recommended; it anchors "what are they solving for."
  • Account notes/memory — wherever your team records goals and context.

2. Placeholders

  • {{USAGE_DATA_SOURCE}}, {{CRM}}, {{CALL_LIBRARY}}, {{TIER_LABELS}}, {{ALERT_DESTINATIONS}}, {{SCORING_WORKFLOW}}, {{VOICE_GOVERNANCE}}, {{STALE_DAYS}}, {{LOOKBACK_DAYS}} — all filled.
  • Map {{TIER_LABELS}} to your actual tier names. The 3-tier minimum in Section 2 is the judgment rule; the labels are cosmetic.
  • Set {{STALE_DAYS}} to match your product's activity rhythm. Default 5 assumes daily-cadence workflows; weekly-cadence products should use 10–14 or every audit will cry wolf.
  • Point {{SCORING_WORKFLOW}} and {{VOICE_GOVERNANCE}} at the account's central workflows, not your org's — the audit inspects the customer's configuration.

3. Policy decisions

  • Character caps (750 / 1,000 / 500 per section) — these are the skill's core discipline, forcing signal over narrative. Adjust only if your team consistently needs more; never remove them.
  • The 30-account cross-reference before flagging spend waste — decide your sample size (30+ is the tested floor). Flagging waste from raw spend percentages is the most common false alarm this rule exists to prevent.
  • Interventions in Section 6 — review the failure-to-intervention map and swap in your own playbook actions (e.g., your onboarding session format, your champion check-in motion) while keeping the one-intervention-per-flag rule.
  • Decide who receives the report and where it lands (doc, channel, CRM note). The skill produces the report; routing is yours.

4. Behavioral invariants (do not remove)

  • All Step 1 data gathered before any section is written — sections produced from partial data are worthless.
  • No "likely," "probably," or "seems" anywhere in the output.
  • Tier persistence checked by comparing two counts (tagged vs. sequenced), never by eyeballing tags alone — partial persistence is the failure mode this catches.
  • Spend flagged as waste only after the per-account cross-reference, or when no qualification gate exists at all.
  • Messaging judged from workflow instructions read word-for-word — never from titles, descriptions, or usage counts.
  • Section 3 stops at notification coverage; sequence/outreach state belongs to Section 4. Scope bleed is how audits balloon.
  • Zero saved message examples for a connected sender is a hard flag.
  • Every flagged finding in Section 6 pairs with exactly one concrete intervention.