Coordinator — Profile Stats & Evolution
Close the loop between how workflows are actually used and which profiles exist.
Procedure
- Read
.work-state/coordinator/<project-slug>/profile-usage.jsonl(append-only, written by theprofile-usagePostToolUse hook). Each line:{ts, workflow, type, complexity, stage, branch}. Empty/missing → report "no telemetry yet" and stop. - Aggregate:
- activations per
workflow, type × complexityfrequency,- stage reach (which stages run vs. are skipped),
- recent trend (last N vs. prior).
- activations per
- Write/update
profile-stats.mdwith the rollup (tables, dated). - Propose (never auto-create) new named profiles for recurring shapes the current profiles serve awkwardly — include a concrete stage sketch and the evidence (counts) for each proposal.
Guardrails
- Only writes
profile-stats.md. Never edits the shippedworkflows/*.json. - Adopting a proposal is a deliberate, separate step by the user.
See also: commands/coordinator-stats.md, hooks/profile-usage.sh.