MountainUnicorn · MountainUnicorn · Apr 27, 2026 · Apr 26, 2026 · Apr 26, 2026 · Apr 26, 2026
@@ -28,11 +28,13 @@ Hotfix. Fixes three findings from the plugin-family release-hardening review bef
 ### Changed
 
 - **`jq` declared as a documented runtime dependency (F-017).** The "zero runtime dependencies" claim in `README.md`, `CONTRIBUTING.md`, `docs/prd.md`, and `.claude-plugin/marketplace.json` was technically inaccurate — runtime hook scripts shipped since v0.7 invoke `jq`. Each of those four prose sites is now qualified ("zero agent-side runtime dependencies; `jq` required for hook scripts") and links to a new canonical reference doc. Hook code is unchanged — Strategy A from [`specs/jq-dependency-declaration.md`](specs/jq-dependency-declaration.md). Historical text in `docs/milestones/`, prior `CHANGELOG.md` entries, and earlier specs is preserved untouched.
+- **Telemetry per-skill reference sweep (F-013).** Every `core/skills/*/SKILL.md` now declares `rules/telemetry.md` in its `references:` frontmatter array via the PR #6 mechanism (Path A). Closes Swarm F's M3-deferred sweep — the contract in `core/rules/telemetry.md` is now discoverable from any individual SKILL.md, and `tests/telemetry-sweep/test-skill-reference-coverage.sh` gates against future skills shipping without the reference. 17 skills got a fresh `references:` entry; 10 skills (cycle, verify, deploy, docs, retro, tdd-cycle, infographic, dashboard, brand-update, ux) had `rules/telemetry.md` appended to existing lists. No body changes; no behavior changes; no schema changes. Spec: `specs/telemetry-skill-reference-sweep.md`.
 
 ### Added
 
 - **`docs/runtime-dependencies.md`** — canonical reference for runtime dependencies. Documents `jq`'s role across the six hook invocation sites, install commands for macOS, Debian/Ubuntu, Fedora/RHEL, Arch, Alpine, openSUSE, Windows (Chocolatey + scoop + WSL), and Nix, the verification one-liner, and the per-site degradation behavior when `jq` is absent (2 hard-fail sites, 3 soft-fail sites).
 - **`tests/jq-dependency/test-jq-claim-qualified.sh`** — fixture-based regression guard. Greps the four in-scope prose files for the bare claim, asserts `docs/runtime-dependencies.md` exists and is referenced from each claim site, and verifies historical text was preserved untouched.
+- **`tests/telemetry-sweep/test-skill-reference-coverage.sh`** — gates against future skills shipping without the `rules/telemetry.md` reference.
 - **Dependency-claim guard** in `.github/workflows/guardrails.yml` — runs the new test on every PR / `main` push so the bare phrasing cannot regress silently.
 
 ## [0.9.2] — 2026-04-26

@@ -2,6 +2,7 @@
 description: "[ADD v0.8.0] Generate or sync a portable AGENTS.md from ADD project state — writes, checks drift, or merges with hand-curated content"
 argument-hint: "[--write|--check|--merge|--import] [--dry-run]"
 allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD AGENTS.md Skill v0.8.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Declare absence — get autonomous work plan for the duration"
 argument-hint: "[duration, e.g. '4 hours', '30 minutes', 'end of day']"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Away Command v0.6.0

@@ -1,6 +1,7 @@
 ---
 description: "[ADD v0.6.0] Return from absence — get briefing on autonomous work"
 allowed-tools: [Read, Glob, Grep, Bash, TodoWrite]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -1,7 +1,7 @@
 ---
 description: "[ADD v0.6.0] Update project branding — new colors, fonts, tone, audit artifacts"
 allowed-tools: [Read, Write, Edit, Glob, Grep, AskUserQuestion]
-references: ["design-system.md"]
+references: ["design-system.md", "rules/telemetry.md"]
 ---
 
 # ADD Brand Update Command v0.6.0

@@ -1,6 +1,7 @@
 ---
 description: "[ADD v0.6.0] View project branding — accent color, palette, drift detection, image gen status"
 allowed-tools: [Read, Glob, Grep, AskUserQuestion]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Brand Command v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Generate or refresh CHANGELOG.md from conventional commits"
 argument-hint: "[--from-scratch]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Plan and execute a work cycle — select features, assess parallelism, define validation"
 argument-hint: "[--plan | --status | --complete | --milestone] [milestone M{N}]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
-references: ["learning-reference.md", "swarm-protocol.md"]
+references: ["learning-reference.md", "swarm-protocol.md", "rules/telemetry.md"]
 ---
 
 # ADD Cycle Command v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Generate a visual HTML project dashboard from .add/ project files"
 argument-hint: "[--open]"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
-references: ["design-system.md"]
+references: ["design-system.md", "rules/telemetry.md"]
 ---
 
 # ADD Dashboard Command v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Environment-aware commit, push, and deploy workflow"
 argument-hint: "[--env local|dev|staging|production] [--skip-verify]"
 allowed-tools: [Read, Glob, Grep, Bash, TodoWrite]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD Deploy Skill v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Generate and sync project documentation — architecture diagrams, API docs, README"
 argument-hint: "[--scope all|api|diagrams|readme] [--check] [--discover]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, Agent]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD Docs Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Write minimal implementation to pass tests (TDD GREEN phase)"
 argument-hint: "specs/{feature}.md [--ac AC-001,AC-002]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Implementer Skill v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Generate project infographic — SVG from PRD + config with branding"
 argument-hint: "[--update]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
-references: ["design-system.md", "image-gen-detection.md"]
+references: ["design-system.md", "image-gen-detection.md", "rules/telemetry.md"]
 ---
 
 # ADD Infographic Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Initialize Agent Driven Development — PRD interview + project setup"
 argument-hint: "[--reconfigure] [--quick] [--sync-registry]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -2,6 +2,7 @@
 description: "[ADD v0.7.3] Manage learnings — generate active views, archive old entries, show stats"
 argument-hint: "[migrate|archive|stats] [--dry-run]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Learnings Skill v0.7.3

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Manage milestones — list, switch, split, rescope, create"
 argument-hint: "[--list | --switch <id> | --split <id> | --rescope <id> | --create]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Milestone Command v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Performance optimization pass — identify and fix bottlenecks"
 argument-hint: "[--scope backend|frontend|full] [--profile-first]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, Task]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Optimize Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Create implementation plan from a feature spec"
 argument-hint: "specs/{feature}.md"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Plan Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Maturity promotion — gap analysis and level-up workflow"
 argument-hint: "[--check | --execute] [--target poc|alpha|beta|ga]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Promote Command v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Run a retrospective — context-aware, data-driven review with pre-populated tables"
 argument-hint: "[--agent-summary] [--since YYYY-MM-DD] [--scope feature|sprint|session] [--dry-run]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, TodoWrite]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD Retro Command v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Review code for spec compliance and quality — produces review report"
 argument-hint: "specs/{feature}.md [--scope backend|frontend|full]"
 allowed-tools: [Read, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Reviewer Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] View and manage project roadmap — milestones, horizons, reordering"
 argument-hint: "[--view | --edit | --reorder]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Roadmap Command v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Create a feature specification through structured interview"
 argument-hint: "[feature-name] [--from-prd-section N]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Spec Command v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Execute complete TDD cycle — RED → GREEN → REFACTOR → VERIFY against a spec"
 argument-hint: "specs/{feature}.md [--ac AC-001,AC-002] [--parallel] [--allow-test-rewrite]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, Task, TodoWrite]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD TDD Cycle Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.6.0] Write failing tests from spec (TDD RED phase)"
 argument-hint: "specs/{feature}.md [--ac AC-001,AC-002] [--type unit|integration|e2e]"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Test Writer Skill v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Iterate on UI/UX design before implementation — wireframes, flow validation, and design sign-off"
 argument-hint: "<spec-file> [--figma <url-or-frame-id>]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
-references: ["design-system.md"]
+references: ["design-system.md", "rules/telemetry.md"]
 ---
 
 # ADD UX Command v0.6.0

@@ -2,7 +2,7 @@
 description: "[ADD v0.6.0] Run quality gates — lint, types, tests, coverage, spec compliance"
 argument-hint: "[--level local|ci|deploy|smoke] [--fix]"
 allowed-tools: [Read, Glob, Grep, Bash, TodoWrite]
-references: ["learning-reference.md", "quality-checks-matrix.md"]
+references: ["learning-reference.md", "quality-checks-matrix.md", "rules/telemetry.md"]
 ---
 
 # ADD Verify Skill v0.6.0

@@ -2,6 +2,7 @@
 description: "[ADD v0.7.3] Show installed version, project version, and upgrade status"
 argument-hint: "[--check]"
 allowed-tools: [Read, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Generate or sync a portable AGENTS.md from ADD project state — writes, checks drift, or merges with hand-curated content"
 argument-hint: "[--write|--check|--merge|--import] [--dry-run]"
 allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD AGENTS.md Skill v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Declare absence — get autonomous work plan for the duration"
 argument-hint: "[duration, e.g. '4 hours', '30 minutes', 'end of day']"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Away Command v0.9.2

@@ -1,6 +1,7 @@
 ---
 description: "[ADD v0.9.2] Return from absence — get briefing on autonomous work"
 allowed-tools: [Read, Glob, Grep, Bash, TodoWrite]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -1,7 +1,7 @@
 ---
 description: "[ADD v0.9.2] Update project branding — new colors, fonts, tone, audit artifacts"
 allowed-tools: [Read, Write, Edit, Glob, Grep, AskUserQuestion]
-references: ["design-system.md"]
+references: ["design-system.md", "rules/telemetry.md"]
 ---
 
 # ADD Brand Update Command v0.9.2

@@ -1,6 +1,7 @@
 ---
 description: "[ADD v0.9.2] View project branding — accent color, palette, drift detection, image gen status"
 allowed-tools: [Read, Glob, Grep, AskUserQuestion]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Brand Command v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Generate or refresh CHANGELOG.md from conventional commits"
 argument-hint: "[--from-scratch]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -2,7 +2,7 @@
 description: "[ADD v0.9.2] Plan and execute a work cycle — select features, assess parallelism, define validation"
 argument-hint: "[--plan | --status | --complete | --milestone] [milestone M{N}]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
-references: ["learning-reference.md", "swarm-protocol.md"]
+references: ["learning-reference.md", "swarm-protocol.md", "rules/telemetry.md"]
 ---
 
 # ADD Cycle Command v0.9.2

@@ -2,7 +2,7 @@
 description: "[ADD v0.9.2] Generate a visual HTML project dashboard from .add/ project files"
 argument-hint: "[--open]"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
-references: ["design-system.md"]
+references: ["design-system.md", "rules/telemetry.md"]
 ---
 
 # ADD Dashboard Command v0.9.2

@@ -2,7 +2,7 @@
 description: "[ADD v0.9.2] Environment-aware commit, push, and deploy workflow"
 argument-hint: "[--env local|dev|staging|production] [--skip-verify]"
 allowed-tools: [Read, Glob, Grep, Bash, TodoWrite]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD Deploy Skill v0.9.2

@@ -2,7 +2,7 @@
 description: "[ADD v0.9.2] Generate and sync project documentation — architecture diagrams, API docs, README"
 argument-hint: "[--scope all|api|diagrams|readme] [--check] [--discover]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, Agent]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD Docs Skill v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Write minimal implementation to pass tests (TDD GREEN phase)"
 argument-hint: "specs/{feature}.md [--ac AC-001,AC-002]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Implementer Skill v0.9.2

@@ -2,7 +2,7 @@
 description: "[ADD v0.9.2] Generate project infographic — SVG from PRD + config with branding"
 argument-hint: "[--update]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
-references: ["design-system.md", "image-gen-detection.md"]
+references: ["design-system.md", "image-gen-detection.md", "rules/telemetry.md"]
 ---
 
 # ADD Infographic Skill v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Initialize Agent Driven Development — PRD interview + project setup"
 argument-hint: "[--reconfigure] [--quick] [--sync-registry]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
+references: ["rules/telemetry.md"]
 disable-model-invocation: true
 ---
 

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Manage learnings — generate active views, archive old entries, show stats"
 argument-hint: "[migrate|archive|stats] [--dry-run]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Learnings Skill v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Manage milestones — list, switch, split, rescope, create"
 argument-hint: "[--list | --switch <id> | --split <id> | --rescope <id> | --create]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Milestone Command v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Performance optimization pass — identify and fix bottlenecks"
 argument-hint: "[--scope backend|frontend|full] [--profile-first]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, Task]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Optimize Skill v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Create implementation plan from a feature spec"
 argument-hint: "specs/{feature}.md"
 allowed-tools: [Read, Write, Glob, Grep, Bash]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Plan Skill v0.9.2

@@ -2,6 +2,7 @@
 description: "[ADD v0.9.2] Maturity promotion — gap analysis and level-up workflow"
 argument-hint: "[--check | --execute] [--target poc|alpha|beta|ga]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, Task, TodoWrite]
+references: ["rules/telemetry.md"]
 ---
 
 # ADD Promote Command v0.9.2

@@ -2,7 +2,7 @@
 description: "[ADD v0.9.2] Run a retrospective — context-aware, data-driven review with pre-populated tables"
 argument-hint: "[--agent-summary] [--since YYYY-MM-DD] [--scope feature|sprint|session] [--dry-run]"
 allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion, TodoWrite]
-references: ["learning-reference.md"]
+references: ["learning-reference.md", "rules/telemetry.md"]
 ---
 
 # ADD Retro Command v0.9.2