code-trail은(는) 무엇을 하나요?
Sopify: 추적 가능한 결정 및 이력이 포함된 재개 가능한 AI 코딩 2026
개요
code-trail은 AI 코딩 세션 중에 추적 가능한 결정 이력을 생성하고, 작업을 재개할 수 있도록 지원하는 스킬입니다. 각 단계의 컨텍스트와 선택 사항이 저장되어, 언제든지 중단된 지점부터 작업을 계속할 수 있습니다.
주요 기능
- 결정 추적: AI 에이전트가 수행한 모든 결정과 그 이유를 로그로 기록합니다.
- 작업 재개: 중단된 세션을 식별하고, 이전 컨텍스트를 복원하여 원활하게 재개합니다.
- 호환성: Claude Code, Cursor, Codex 및 기타 AI 코딩 도구와 함께 사용할 수 있습니다.
- 파일 기반 로깅:
.code-trail/디렉토리에 JSON 형식으로 이력을 저장합니다.
사용 방법
- 작업 시작 시
code-trail start명령어로 새 추적을 시작합니다. - 각 결정 단계에서
code-trail log명령어로 선택 사항을 기록합니다. - 작업을 재개하려면
code-trail resume명령어를 사용합니다.
설정
| 변수 | 설명 | 기본값 |
|---|---|---|
CODE_TRAIL_DIR | 로그 저장 디렉토리 | .code-trail |
CODE_TRAIL_FORMAT | 로그 형식 (json/markdown) | json |
지원 도구
- Claude Code
- Cursor
- Codex
- 기타 AI 코딩 에이전트
예제
# 새 추적 시작
code-trail start --project my-project
# 결정 기록
code-trail log "선택한 API: REST vs GraphQL" "REST가 팀 표준과 일치하고 학습 곡선이 낮음"
# 작업 재개
code-trail resume --session last
라이선스
MIT