Lore - Git Commit Knowledge Protocol
Git 커밋 메시지를 AI 코딩 에이전트용 구조화된 지식 프로토콜로 변환. 제약조건, 거절된 대안, 신뢰도, 지시사항을 git trailers로 인코딩.
문제: Decision Shadow
모든 커밋은 의사결정 컨텍스트를 파괴한다.
개발자와 AI 에이전트는 대안을 고려하고, 트레이드오프를 평가하고, 하나의 접근법을 선택한다. 하지만 최종 diff만 남는다.
사라지는 것들:
- 제약조건 (Constraints)
- 거절된 대안 (Rejected alternatives)
- 신뢰도 수준 (Confidence levels)
- 미래 수정자에 대한 경고 (Warnings)
이 잃어버린 컨텍스트가 Decision Shadow다. 개별적으로는 작지만, 누적되면 “레거시 코드”가 된다 — 작동하지만 구조적 근거가 사라진 코드.
해결책: Lore
각 커밋을 기관 지식의 원자 단위로 변환.
Git trailers (네이티브 git 기능, 별도 도구 불필요)를 사용하여 의사결정 컨텍스트를 인코딩.
예시
Prevent silent session drops during long-running operations
The auth service returns inconsistent status codes on token
expiry, so the interceptor catches all 4xx responses and
triggers an inline refresh.
Constraint: Auth service does not support token introspection
Constraint: Must not add latency to non-expired-token paths
Rejected: Extend token TTL to 24h | security policy violation
Rejected: Background refresh on timer | race condition
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Error handling is intentionally broad (all 4xx)
-- do not narrow without verifying upstream behavior
Tested: Single expired token refresh (unit)
Not-tested: Auth service cold-start > 500ms behavior
Trailer 스펙
| Trailer | 용도 |
|---|---|
Constraint: | 의사결정을 형성한 외부 제약 |
Rejected: | 고려했던 대안과 거절 이유 (alt | reason) |
Confidence: | 신뢰도 (high / medium / low) |
Scope-risk: | 범위 리스크 (narrow / moderate / broad) |
Reversibility: | 되돌리기 난이도 (clean / moderate / difficult) |
Directive: | 미래 수정자를 위한 경고 또는 지시사항 |
Tested: | 검증된 내용 |
Not-tested: | 알려진 커버리지 갭 |
Related: | 연결된 커밋 (의사결정 체인) |
모든 trailer는 선택사항이며 반복 가능. 커스텀 trailer 추가 가능.
쿼리
표준 git 도구로 쿼리 가능:
# 특정 trailer가 포함된 커밋 찾기
git log --all --grep="^Constraint:" -- path/to/file.ts
git log --all --grep="^Rejected:" -- path/to/file.ts
git log --all --grep="^Directive:" -- path/to/file.tsZero infrastructure. Git 히스토리가 쿼리 가능한 의사결정 데이터베이스가 됨.
설치
# Claude Code skill 설치
npx skills add tmdgusya/lora
# 글로벌 설치 (모든 프로젝트에서 사용)
npx skills add tmdgusya/lora -gAI 에이전트가 Lore 형식의 커밋 메시지를 작성하도록 가르침. skills 생태계를 지원하는 모든 에이전트에서 작동.
장점
| 특성 | 설명 |
|---|---|
| Atomic binding | 지식이 코드 변경에 영구적으로 융합 |
| Temporal immutability | append-only 로그, 한 번 커밋하면 영구 보존 |
| Universal availability | 모든 git 프로젝트가 이미 이 채널을 가짐 |
| Natural granularity | 커밋은 이미 논리적 작업 단위로 범위 지정됨 |
| Graceful degradation | 최악의 경우 현재 관행과 동일 |
출처
논문: “Lore: Repurposing Git Commit Messages as a Structured Knowledge Protocol for AI Coding Agents” by Ivan Stetsenko (2026)