agent-telemetry

Claude Code および Codex CLI を使った開発で、PR 単位のトークン消費効率を追跡・可視化する計測ツール。

ローカル可視化は otel+grafana（Mimir/Loki）に一本化 しています。make oss-up で Collector→Mimir/Loki→Grafana を 1 コマンド起動し、make oss-flush で hook データを流すと上のダッシュボードが見られます（setup/local）。SQLite はクライアント側 SoR で、Grafana から直接読む旧経路は legacy として残置しています。

ドキュメント

仕組みの解説・セットアップ手順・運用ガイドは GitHub Pages で公開しています:

→ agent-telemetry site

• 仕組み解説 — アーキテクチャ・データフロー・観察軸・dashboard の読み方
• セットアップ — local / server

Contributor 向け reference

場所	内容
docs/spec.md	外部契約（CLI・hook 仕様・データモデル）
docs/metrics.md	計測フレームワーク（観察軸・解釈・OpenMetrics カタログ）
docs/design.md	実装方針と設計判断
issues/closed/	過去の意思決定記録（retro issue を含む正本）
site/	site の Hugo source（make docs-serve でローカル確認）