Waybill

영수증을 챙기세요. Waybill은 AI 지원 작업에 대한 토큰 회계 처리 도구입니다 — 모든 토큰을 계량하고, 이를 배송된 Jira 스토리에 귀속시키며, 이를 가치 보고서, 성과 검토 자료, 그리고 검증을 견딜 수 있는 토큰 예산 요청으로 전환하는 Claude Code 플러그인입니다.

Waybill은 화물과 그 비용을 항목별로 기재하는 선하증권입니다. 당신이 배송하면 Waybill이 항목별 기록을 보관합니다.

이유

엔지니어의 한 해를 결정짓는 두 가지 대화는 모두 동일한 결함 있는 입력값에 기반합니다:

• "AI 예산은 그만한 가치가 있었나?" — 더 많은 팀이 입증된 가치에 따라 Claude 토큰을 할당합니다. 잘 사용하고, 보여주고, 더 받으세요.

• "이번 사이클에 무엇을 성취했나요?" — 성과 검토, 승진 자료, 스프린트 리뷰.

인간은 둘 다 기억에 의존해, 전날 밤에, 형용사로 답합니다. 결정권자는 정직한 주장과 부풀려진 주장을 구분할 수 없어 모든 것을 할인합니다. Waybill은 증거를 고칩니다, 설득이 아닌: 작업이 발생할 때 기록하고, 모든 주장을 산출물(PR, 이슈, 배포 태그, 대화록)에 연결하며, 다음 피치가 무시당하게 만드는 종류의 주장을 할 수 없게 합니다.

Related MCP server: Token Analyzer MCP

첫 영수증까지 60초

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

그런 다음 Claude Code 세션에서 "내 waybill 원장을 초기화해줘" 라고 말하세요. 이것이 전체 설정입니다: 계정, 토큰, OAuth가 필요 없습니다. Waybill은 git config에서 신원을 가져오고, Anthropic 가격표 요율을 가져와 첫날부터 비용이 표시되도록 하며, 대화록 보존 설정을 확인하고, 로컬 git 기록만으로 부트스트랩 영수증을 렌더링합니다 — 배송된 작업이 1분 안에 항목별로 정리됩니다.

업데이트

Claude Code는 플러그인 업데이트 알림을 푸시하지 않습니다; 업데이트는 원할 때마다 한 번의 명령어로 수행합니다:

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, 배포)를 생성합니다 — 단 하나의 습관도 바꾸지 않은 상태에서요. 그 이후로 원장을 통해 작업을 열면 더 강력한 주장(아래 계층 참조)을 사용할 수 있습니다.

작동 방식

모든 Claude Code 토큰은 로컬 대화록에서 결정론적으로 계량되어 제공된 스토리에 귀속되며, 이벤트별 해결자 이름과 신뢰도, 보존 검사(Σ 귀속 = Σ 관찰, 세션별)를 waybill verify로 오프라인에서 재실행 가능, 모호한 잔여물을 위한 귀속 받은 편지함, 그리고 스토리별 낭비 진단(토큰이 구매한 것 — 그리고 재시도 루프에서 낭비한 것)을 포함합니다. 1.0 기준으로 스키마는 고정되었습니다: 영수증이 계약입니다.

증거 계층 (핵심 아이디어)

보고서의 모든 숫자는 출처를 명시합니다:

1. 사실 — 병합 타임스탬프, 배포 태그, 스토리 포인트, 토큰 수.

2. 기준선 델타 — Claude 이전의 자신의 속도/사이클 타임 vs. 현재.

3. 사전 등록된 추정치 — 작업 전에 기록되었으며, 범위로 보고됨.

4. 회고적 판단 — 원장에 보관되며, 기본적으로 피치에서 제외됨.

더불어 구조적 정직성: 추가 전용 저장소(수정 사항은 덮어쓰지 않고 대체), 범위는 절대 중간점으로 축소되지 않음, 병합되거나 배포된 경우에만 가치가 계산됨, 비용(사용된 토큰, 재작업)이 모든 피치에 표시됨. 전체 규칙: 방법론.

보고서 프리셋

• token-pitch — 요청, 영수증, 지출 원장, 효율성 추세, 예측.

• perf-review — 검토 기간 동안의 에픽 수준 결과, 리뷰/인시던트/문서 작업 포함.

• sprint-recap / quarterly — 진행 중인 기록.

보고서는 세 가지 대상 수준(self, internal, external)으로 렌더링되며, 조직 외부로 나가기 전에 결정론적 가명 처리가 적용됩니다.

Waybill이 절대 하지 않을 일

• 관리자 모드 없음, 감시 없음. 오직 당신에게 할당된 이슈와 당신이 작성한 PR만 조회합니다.

• 동료 순위 매기기 없음. 방법론은 설계상 개인 동료 비교를 거부합니다 — 당신은 Dave가 아닌 자신의 기준선과 경쟁합니다.

• 호스팅 서비스 없음, 원격 측정 없음. 모든 것은 ~/.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 전용 모드는 설정이나 인증이 전혀 필요 없습니다: 계량, 브랜치/핀별 귀속, 부트스트랩 영수증 모두 로컬 데이터에서 실행됩니다. 트래커/git 호스트를 연결하면 영수증이 업그레이드됩니다; MCP 서버가 있는 모든 것을 교체할 수 있습니다 (어댑터).

회사가 토큰을 배급하지 않아도 성과 검토에 사용할 수 있나요? 네 — 그것이 perf-review 프리셋입니다. 토큰 피치는 원장의 여러 출력 중 하나일 뿐, 그것의 목적이 아닙니다.

내 데이터는 비공개인가요? 홈 디렉토리 아래의 로컬 JSONL; 유일한 네트워크 호출은 당신이 승인한 MCP 호출이며, 자신의 항목으로만 범위가 제한됩니다.

왜 나를 팀원과 비교하지 않나요? 스토리 포인트는 사람 간에 비교할 수 없고, 동료를 긁어모으는 것은 감시로 읽히며, 자신의 궤적이 어쨌든 더 강력한 증거입니다. (방법론 §6)

관리자에게 AI 지출을 어떻게 정당화하나요? sync를 실행한 다음 "내 토큰 피치를 만들어줘"라고 하세요. 한 페이지 요약본을 가져가고, 후속 질문을 위해 원장을 보관하세요.

기여하기

이슈와 PR은 환영합니다 — CONTRIBUTING.md, 로드맵, 그리고 good first receipt 레이블이 붙은 이슈를 참조하세요. 다른 트래커를 위한 어댑터 설정이 가장 원하는 기여입니다. 행동 강령을 읽어주세요; 보안 보고는 SECURITY.md를 통해 제출하세요.

라이선스

MIT