ai-adoption-reportlisted

# Skill: ai-adoption-report A read-only workflow skill that consumes one or more `flow-metrics` JSON outputs and renders a comparison report. It has three modes — `baseline`, `cohort`, `program` — all sharing one pairing-and-delta engine. The skill is deliberately boring: pair files, subtract numbers, render a table. It encodes no judgment about what the deltas mean and emits no flags; interpretation belongs to the reader. ## When to use - **`baseline`** — compare a single scope across two windows (pre-AI vs current). Two `flow-metrics` JSONs in, deltas out. - **`cohort`** — surface the within-window AI-cohort vs control split that `flow-metrics` already computed via `--cohort-jql`. One JSON in, deltas out. - **`program`** — roll up many scopes for a single window. N JSONs in, per-scope rows + aggregates out. - **Do NOT** use this skill for live metric computation — that's the `flow-metrics` skill's job. This skill consumes `flow-metrics`' outputs; it never recomputes them and never reads Jira. ## Invocation Two equivalent forms (both call the same `ai_adoption_report.main`): ```bash # Installed package — exposes an `ai-adoption-report` shim on PATH: ai-adoption-report baseline --baseline A.json --current B.json --output report.md # Or any environment where the package is on PYTHONPATH: python -m ai_adoption_report baseline --baseline A.json --current B.json --output report.md ``` From a working copy of this pack, add the package to PYTHONPATH first: ```b