Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
이 도구는 AI 코딩 에이전트가 원래 목표에서 벗어나는 '의도 드리프트(Intent Drift)'를 감지하는 스킬입니다. 실제 저장소 상태와 셸 히스토리 등 구체적인 증거 기반으로 정렬을 모니터링하며, 자율적 결정 대신 확인 요청을 생성하여 개발 과정을 투명하게 만듭니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기A skill that uses the Intent Alignment Engine to analyze intent drift in AI-assisted development.
🌐 Website: intent-drift.vercel.app — documentation, feature overview, and real report gallery.
AI 코딩 에이전트가 원래 요청된 문제와 다른 문제를 해결하기 시작하는 경우를 감지합니다. 이를 위해 다음 항목 간의 정렬(alignment)을 모니터링합니다:
--include-shell-history로 명시적으로 옵트인한 경우의 셸 히스토리)에 근거합니다.프로젝트의 방향 기록은 ROADMAP.md에 있으며, 병합된 모든 변경 사항은 CHANGELOG.md에 기록됩니다.
마음에 드셨나요? 별점 ⭐을 남겨주세요. 다른 사람들이 이 프로젝트를 찾는 데 도움이 됩니다.
# 아무것도 설치하지 않고 CLI 실행 (Python 3.10+ 필요)
npx intent-drift \
--original-goal "애플리케이션 메모리 사용량 감소"
...
npx intent-drift는 패키징된 배포판입니다. 처음 실행할 때 전용 가상 환경(~/.intent-drift-venv)을 생성하고 분석 엔진을 설치합니다. 필요한 경우 INTENT_DRIFT_PYTHON을 특정 Python 3.10+ 바이너리로 설정하세요.
# 기본 사용법
/intent-drift
--original-goal "애플리케이션 메모리 사용량 감소"
...
모든 분석은 점수를 ~/.local/share/intent-drift/history.json (또는 $XDG_DATA_HOME/intent-drift/history.json, 이 값이 설정된 경우)에 추가하고, 보고서의 timeline을 실행 기록으로 초기화합니다. 따라서 --history / --compare 뷰와 내보내기(exporters)의 타임라인 섹션은 세션 전체의 완전한 추세를 반영합니다.
파일 위치를 변경하려면 config/user.yaml에서 history.history_path를 설정하세요. 이렇게 하면 분석 지속성(persistence)과 --history 모두 해당 경로를 따릅니다. ~와 환경 변수는 확장되므로, 상대 경로보다는 다음과 같은 경로를 사용하세요:
history:
history_path: ~/data/intent-drift-history.json
기본 XDG 인식 설정을 유지하려면 이 값을 설정하지 않거나 (null) 비워두세요. 전체 키 참조는 docs/config.md를 참고하세요.
Intent Alignment Report
전반적인 정렬도: 68%
...
intent-drift/
├── __init__.py # 스킬 진입점(Skill entrypoint)
├── analyzer.py # 핵심 분석 로직
...
# config/defaults.yaml
analysis:
threshold: 75 # 최소 정렬 점수 (%)
...
# 설정 파일 편집
nano ~/.claude/skills/intent-drift/config/user.yaml
...
다음 항목을 자동으로 분석합니다:
다음 항목을 분석합니다:
# 새 제공자는 providers/에 위치합니다:
class CustomEvidenceProvider:
def __init__(self):
...
# 새 내보내기는 exporters/에 위치합니다:
class CsvExporter:
def export(self, report, output_path):
...
다음 내용을 보려면 docs/ 디렉토리를 참조하세요:
다음 내용을 보려면 CONTRIBUTING.md를 참고하세요:
CHANGELOG.md 항목 추가프로젝트가 처음이신가요? good first issue 또는 up for grabs 태그가 지정된 이슈를 둘러보세요. 각 범위가 정해진 작업(scoped task)에는 해당 작업이 완료되었음을 증명하는 정확한 테스트 실행인 Verify 명령어가 포함되어 있습니다.
이 예약된 레이블들은 관례상 선착순입니다: CI에서 이를 강제하지 않으므로, 이곳에 처음 기여하는 사람들을 위해 good first issue와 help wanted는 비워두어 주세요.
기록된 방향(goals, milestones), '획득 가능' 백로그('up for grabs' backlog), 그리고 명시적으로 범위에서 제외되는 항목(out of scope)은 ROADMAP.md를 참조하십시오.
Apache-2.0 License - 자세한 내용은 LICENSE 파일을 참조하십시오.
Shaurya Gangrade의 Intent Alignment Engine을 기반으로 제작되었습니다.