docs: 토큰 절감 측정 리포트 신설 + 페어 1 등록 #71

Merged

xhh merged 1 commit from issue-7-token-savings-doc into main

2026-04-26 21:27:06 +09:00

xhh commented

2026-04-26 21:26:15 +09:00

Owner

요약

통합 로드맵 핵심 검증 지표(스킬 토큰 절감) 의 측정 리포트를 fdp 레포에 정착.
지금까지 claude-plugin#3 PR 본문에만 있던 페어 1쌍 데이터를 영구 위치로 옮기고
이후 페어 누적/평균 산출의 단일 진실 공급원으로 만든다.

변경 내용

docs/token-savings.md 신설
- A/B 정의, 메트릭 정의, 측정 환경, 운영 규칙
- 누적 페어 표 (현재 1/5)
- 첫 페어 기록 (2026-04-26 liquidity): B 토큰 -11.5%, 속도 -26.8%
- 잠정 평균 + 정성 관찰 + 다음 단계
README.md
- "관련 문서" 섹션에 링크
- "다음" 로드맵 항목 (#7) 줄에 링크 + 진행률 (1/5)
CLAUDE.md
- Phase 1 토큰 절약 효과 측정 체크박스에 링크 + 진행률

운영 규칙

한 페어 측정이 끝날 때마다 본 문서에 한 줄 추가 + 마지막수정일 갱신
5쌍 누적되면 평균 절감률 확정 → 통합 로드맵 Phase 1 게이트 판단 (이슈 #7 종료 조건)
페어가 누적되는 동안 type(분석 종류) 별 비교가 가능하면 별도 표로 분리

검증

uv run ruff check . 통과
uv run pytest 122 case 통과 (코드 변경 없음)
마크다운 링크 4건 모두 상대 경로 유효

이슈

Refs #7 (페어 5쌍 누적 후 게이트 판단까지 열어둠)

## 요약 통합 로드맵 핵심 검증 지표(스킬 토큰 절감) 의 측정 리포트를 fdp 레포에 정착. 지금까지 `claude-plugin#3` PR 본문에만 있던 페어 1쌍 데이터를 영구 위치로 옮기고 이후 페어 누적/평균 산출의 단일 진실 공급원으로 만든다. ## 변경 내용 - `docs/token-savings.md` 신설 - A/B 정의, 메트릭 정의, 측정 환경, 운영 규칙 - 누적 페어 표 (현재 1/5) - 첫 페어 기록 (2026-04-26 liquidity): **B 토큰 -11.5%, 속도 -26.8%** - 잠정 평균 + 정성 관찰 + 다음 단계 - `README.md` - "관련 문서" 섹션에 링크 - "다음" 로드맵 항목 (#7) 줄에 링크 + 진행률 (1/5) - `CLAUDE.md` - Phase 1 토큰 절약 효과 측정 체크박스에 링크 + 진행률 ## 운영 규칙 - 한 페어 측정이 끝날 때마다 본 문서에 **한 줄 추가** + 마지막수정일 갱신 - 5쌍 누적되면 평균 절감률 확정 → 통합 로드맵 Phase 1 게이트 판단 (이슈 #7 종료 조건) - 페어가 누적되는 동안 type(분석 종류) 별 비교가 가능하면 별도 표로 분리 ## 검증 - `uv run ruff check .` 통과 - `uv run pytest` 122 case 통과 (코드 변경 없음) - 마크다운 링크 4건 모두 상대 경로 유효 ## 이슈 Refs #7 (페어 5쌍 누적 후 게이트 판단까지 열어둠)

xhh added 1 commit

2026-04-26 21:26:15 +09:00

docs: 토큰 절감 측정 리포트 신설 + 페어 1 등록 (#7 )

Tests (PR) / pytest (pull_request) Successful in 28s

Details

9c8adceb88

통합 로드맵 핵심 검증 지표를 fdp 레포에 정착.

추가:
- docs/token-savings.md
  - A/B 정의, 메트릭 정의, 측정 환경, 운영 규칙
  - 누적 페어 표 (현재 1/5)
  - 첫 페어 기록: 2026-04-26 liquidity (B 토큰 -11.5%, 시간 -26.8%)
  - 잠정 평균 + 정성 관찰 + 다음 단계
- README "관련 문서" 섹션 + "다음" 로드맵 항목에 링크
- CLAUDE.md Phase 1 토큰 절감 측정 항목에 링크

페어 누적 운영 규칙: 한 페어 끝날 때마다 본 문서에 한 줄 추가 + 마지막
수정일 갱신. 5쌍 누적 시 평균 절감률 확정해 Phase 1 게이트 판단.

원본 측정값 출처: claude-plugin#3 (token-savings.md 갱신 PR).

Refs #7