ai-analyst

Every agent `.md` file MUST begin with a CONTRACT block -- a YAML declaration

| Variable | Value | Used in |

Generate a single styled chart from data and a chart specification, applying SWD visualization standards for theme, color, typography, and annotation. Context: Invoked as part of the analytical pipeline when chart-maker is applicable. user: "[Request analysis involving chart-maker]" assistant: "I'll use the chart-maker agent to [perform specific analysis]." commentary: This agent is appropriate when [context for usage].

Perform cohort analysis -- retention curves, cohort comparison, vintage analysis, and cohort LTV -- to reveal how user behavior evolves over time. Context: Invoked as part of the analytical pipeline when cohort-analysis is applicable. user: "[Request analysis involving cohort-analysis]" assistant: "I'll use the cohort-analysis agent to [perform specific analysis]." commentary: This agent is appropriate when [context for usage].

Draft stakeholder communications from completed analysis results, adapting format and tone to user preferences and audience. Context: Invoked as part of the analytical pipeline when comms-drafter is applicable. user: "[Request analysis involving comms-drafter]" assistant: "I'll use the comms-drafter agent to [perform specific analysis]." commentary: This agent is appropriate when [context for usage].

EMBEDDED — Establishes a clear analysis plan before writing queries. This functionality is built into the ask-question and run-analysis skill. Do NOT invoke analysis-design-spec separately — use ask-question and run-analysis instead, which includes these instructions inline.

EMBEDDED — Retrieves proven SQL patterns and reusable CTEs. This functionality is built into the ask-question and run-analysis skill. Do NOT invoke archaeology separately — use ask-question and run-analysis instead, which includes these instructions inline.

Run the multi-persona planning methodology to produce a master plan for a new project or feature. Triggered when users say "architect", "plan this", "design the system", or invoke `/architect`.

EMBEDDED — Saves completed analysis to the knowledge archive. This functionality is built into the run-analysis skill. Do NOT invoke archive-analysis separately — use run-analysis instead, which includes these instructions inline.

USE THIS SKILL for ANY data question, analytical request, or metric inquiry. This is the MANDATORY entry point whenever a user asks about data, metrics, trends, churn, revenue, conversion, retention, segments, cohorts, funnels, KPIs, or any quantitative question — even casual ones like 'how are we doing' or 'what happened last month.' Also use when user says 'analyze', 'compare', 'why did X change', 'show me', 'what's driving', 'break down', or asks for any chart or visualization. If the user has a connected dataset and asks ANYTHING about their data, use this skill. Do NOT attempt to answer data questions without this skill — it contains critical charting standards, validation steps, and knowledge loading that produce professional-quality outputs.