Waybill

領収書をお持ちください。 WaybillはAI支援作業のトークン会計ツールです。Claude Codeのプラグインとして、すべてのトークンを計測し、それを出荷先のJiraストーリーに紐付け、価値レポート、業績評価パッケージ、そして厳しい審査に耐えうるトークン予算要求に変換します。

*ウェイビル（waybill）*とは、貨物とその料金を明細化する運送書類です。あなたが出荷すれば、Waybillがその明細記録を保持します。

なぜ必要か

エンジニアの1年を左右する2つの会話があり、どちらも同じ不完全な情報に基づいています：

• 「AI予算の価値は何だったのか？」 — 多くのチームは、実証された価値に基づいてClaudeトークンを割り当てます。うまく活用し、それを示せば、より多くのトークンを得られます。

• 「今期は何を達成したのか？」 — 業績評価、昇進パッケージ、スプリントレビュー。

人間はどちらも記憶と形容詞に頼り、前日の夜に回答します。判断する側は、正直な主張と誇張された主張を見分けられないため、すべてを割り引いて評価します。Waybillは証拠を修正します。説得ではありません。作業が発生したときに記録し、すべての主張をPR、課題、デプロイタグ、トランスクリプトなどの成果物に結び付け、次回の提案が無視されるような主張をさせないようにします。

Related MCP server: Token Analyzer MCP

最初の領収書まで60秒

claude plugin marketplace add Jakeintech/waybill
claude plugin install waybill@waybill

次に、Claude Codeセッションで 「ウェイビル元帳を初期化して」 と言ってください。これで設定は完了です。アカウントもトークンもOAuthも不要です。Waybillはgit configからあなたのIDを取得し、Anthropicの価格表レートをインポートして初日からコストを表示し、トランスクリプト保存設定を確認し、ローカルのgit履歴のみからブートストラップ領収書をレンダリングします。あなたが出荷した作業が、1分足らずで明細化されます。

アップデート

Claude Codeはプラグインのアップデート通知をプッシュしません。アップデートは、好きなときに1つのコマンドで行います：

claude plugin update waybill@waybill

その後、Claude Codeを再起動してください。waybill status（またはwaybill --version）で実行中のエンジンバージョンが表示されます。Waybillは決して自分でアップデートを確認しません。あなたが要求しなければネットワーク呼び出しを行わないことはコミットメントであり、見落としではありません。リリースと変更履歴はリリースページにあります。GitHubからのメール通知をご希望の場合は、リポジトリをウォッチ（Watch → Custom → Releases）してください。

アップグレードパス（オプション、5分）

トラッカーとgitホストを接続すると、コミットがストーリーポイント、エピック、マージタイムスタンプ付きの領収書に変わります：

# Easiest — reuse your authenticated gh CLI:
export GITHUB_MCP_PAT="$(gh auth token)"
# Or mint a fine-grained read-only PAT (repos/PRs) at
# https://github.com/settings/personal-access-tokens and export it instead.

1. /mcp → atlassianのOAuthフローを完了します（トークンは不要）。

2. 「元帳を同期して、ブートストラップレポートを表示して」 と言ってください。

何が接続されていて何が接続されていないかわからない場合、waybill statusがそれを表示し、不足しているものを修正するための正確なコマンドを出力します。

これにより、過去約90日間のあなた自身の課題とマージされたPRがインポートされ、事実のみのレポート（出荷されたアイテム、ポイント、PR、デプロイ）が生成されます。習慣を1つも変える必要はありません。その後、元帳を介してタスクを開くことで、より強力な主張（以下のティアを参照）が可能になります。

仕組み

すべてのClaude Codeトークンは、ローカルのトランスクリプトから決定論的に計測され、それが提供したストーリーに帰属されます。イベントごとのリゾルバー名と信頼度、保存チェック（セッションごとにΣ帰属 = Σ観測）、waybill verifyでオフラインで再実行可能、曖昧な残り用の帰属受信箱、ストーリーごとの無駄診断（トークンが何を購入したか、そしてリトライループで何を無駄にしたか）が含まれます。1.0時点でスキーマは固定されています。領収書が契約です。

証拠のティア（全体のアイデア）

レポート内のすべての数値は、その出典を示します：

1. 事実 — マージタイムスタンプ、デプロイタグ、ストーリーポイント、トークン数。

2. ベースライン差分 — Claude導入前のあなた自身のベロシティ/サイクルタイムと現在の比較。

3. 事前登録された見積もり — 作業前に記録され、範囲として報告されます。

4. 事後的な判断 — 元帳に保持され、デフォルトではピッチから除外されます。

さらに、構造的な正直さ：追加専用ストレージ（修正は上書きではなく優先）、範囲は決して中間点に集約されず、マージまたはデプロイされた場合にのみ価値がカウントされ、コスト（消費トークン、手戻り）はすべてのピッチに表示されます。完全なルール：方法論。

レポートプリセット

• token-pitch — 要求、領収書、支出元帳、効率トレンド、予測。

• perf-review — レビュー期間のエピックレベルの成果（レビュー/インシデント/ドキュメント作業を含む）。

• sprint-recap / quarterly — 継続的な記録。

レポートは3つのオーディエンスレベル（self、internal、external）でレンダリングされ、組織外に出る前に決定論的な仮名化が行われます。

Waybillが決して行わないこと

• マネージャーモードや監視はありません。 あなたに割り当てられた課題と、あなたが作成したPRのみを照会します。

• 同僚のランキングはありません。 方法論は、設計上、個人の同僚比較を拒否します。あなたはデイブではなく、自分のベースラインと競争します。

• ホスト型サービスやテレメトリーはありません。 すべては~/.waybill/（あなたが所有するローカルgitリポジトリ）に保存されます。

• 時間追跡はありません。 成果と見積もりを記録し、キーストロークは記録しません。

これらはギャップではなくコミットメントです。ROADMAP.mdを参照してください。

一時停止、静音化、削除

作業を記録するツールへの信頼には、それを停止する正確な方法を知っていることも含まれます。停止から完全削除までの完全な出口パス：

• 計測を一時停止（クライアントエンゲージメント、共有マシン、デバッグ）：~/.waybill/config.jsonで"metering": { "enabled": false }を設定します。一時停止中は何もキャプチャまたは計測されません。waybill statusはmetering: PAUSEDと報告するため、状態が黙っていることはありません。既存のデータはそのままです。元に戻して再開します。

• 発言を減らす："notices": { "level": "minimal" }は、予算しきい値の行のみを保持します（"off"はWaybillが自発的に言うすべてを黙らせます。計測は引き続き実行されます）。更新リマインダー（budgets.renewal_reminder_days、デフォルト14）も同じスイッチに従います。

• データを持ち出す：waybill export --format json（またはcsv）で支出元帳を出力します。元帳全体はすでに~/.waybill/内のプレーンなJSONLです。あなたが所有するローカルgitリポジトリです。どこにでもコピーできます。独自仕様のものはありません。

• ツールをアンインストールし、データを保持：claude plugin uninstall waybill@waybillを実行し、Claude Codeを再起動します。フックとスキルは削除されます。~/.waybill/はあなたのままです。

• すべてを削除：rm -rf ~/.waybill（または$WAYBILL_HOMEを設定している場合はそれ）。これが全フットプリントです。Waybillは他の状態を保持しません。~/.claude/以下のセッショントランスクリプトはClaude Codeに属し、Waybillには属さず、そのcleanupPeriodDays設定によって管理されます。

代替手段との比較

ドキュメント

• チュートリアル：このREADMEのクイックスタート（上記）。

• ハウツー：Jira/GitHubをLinear、GitLab、Bitbucket…に交換する

• リファレンス：元帳エントリと設定スキーマ · スキルリファレンス · テスト計画 — Claudeが読むドキュメントは、あなたが読むドキュメントと同じです。

• 解説：価値測定方法論 · ロードマップとスコープ · ブランドとボイス · スキーマ固定と移行ポリシー

• 仕様：完全な製品仕様書 — 出荷されたエンジンが実装する規範的な設計。

FAQ

JiraやGitHubがなくても動作しますか？ はい。それがデフォルトです。Gitのみのモードは設定も認証も不要です。計測、ブランチ/pinによる帰属、ブートストラップ領収書はすべてローカルデータから実行されます。トラッカー/gitホストを接続すると領収書がアップグレードされます。MCPサーバーを持つものはどれでも交換可能です（アダプター）。

会社がトークンを配給していない場合でも、業績評価に使用できますか？ はい。それがperf-reviewプリセットです。トークンピッチは元帳の出力の1つであり、目的ではありません。

私のデータはプライベートですか？ ホームディレクトリ以下のローカルJSONLです。唯一のネットワーク呼び出しは、あなたが承認したMCP呼び出しであり、あなた自身のアイテムに限定されます。

なぜチームメイトと比較してくれないのですか？ ストーリーポイントは人によって比較可能ではなく、同僚のスクレイピングは監視と見なされ、あなた自身の軌跡の方がいずれにせよ強力な証拠です。（方法論 §6）

マネージャーにAI支出を正当化するにはどうすればよいですか？ syncを実行し、次に「トークンピッチを作成して」と言ってください。1ページの資料を持参し、フォローアップの質問に備えて元帳を保持してください。

貢献

IssueとPRは歓迎します。CONTRIBUTING.md、ロードマップ、およびgood first receiptラベルの付いたIssueを参照してください。他のトラッカー用のアダプター設定が最も求められている貢献です。行動規範をお読みください。セキュリティ報告はSECURITY.mdを通じて行ってください。

ライセンス

MIT