/analytics

name: sw/analytics
description: "Analytics and metrics for SpecWeave usage — token consumption, cache efficiency, agent spawn counts."
version: 1.0.0
allowed-tools: Read, Bash

Tool-Use Rationale

• **Read**: Load metrics snapshots, increment history, and config to compute analytics.
• **Bash**: Run `specweave metrics` CLI commands to gather live telemetry data.

Usage

sw:analytics [--cache-stats] [--spawn-count] [--token-usage]

--cache-stats

Displays prompt cache hit rates per skill for the current session.

**Output format**:

Cache Statistics (current session)
───────────────────────────────────
sw/grill         hit rate: 78% (1,240 tokens from cache)
sw/judge-llm     hit rate: 65% (980 tokens from cache)
sw/code-reviewer hit rate: 82% (1,560 tokens from cache)
───────────────────────────────────
Overall:         hit rate: 75%

**Requirements**:

• Cache must be enabled (`cache.staticContextFiles` non-empty in config)
• Minimum 2 invocations per skill for meaningful hit rate

**Enable persistent metrics**: Set `analytics.cacheMetrics.enabled: true` in `.specweave/config.json`.

--spawn-count

Reports agent spawn counts per team session. Use to verify that Opus 4.7 fan-out reduction is working (target: ≤ 50% of pre-1.1.0 baseline).

--token-usage

Reports total token consumption per skill across the session.