Commit-time 캡처를 통한 아키텍처 의사결정 휘발성 해결

Context

Conventional Commits나 Wiki 등 기존 도구가 기록하는 'What' 중심의 정보와 실제 설계 이유인 'Why' 사이의 간극 발생. 문서화 작업이 개발 흐름과 분리된 별도 프로세스로 작동함에 따라 기록 누락 및 정보 불일치가 심화되는 구조적 한계 노출.

Technical Solution

• Post-commit hook을 활용하여 의사결정이 가장 선명한 Commit 시점에 즉시 'Why'를 입력받는 워크플로우 설계
• 입력 데이터를 Front-matter가 포함된 Markdown 파일로 변환하여 .lore/docs/ 경로에 저장함으로써 코드와 문서의 원자적 동기화 구현
• Contextual Rules 체인을 통해 Merge commit, Rebase, CI run 등 단순 작업 시 Prompt 노출을 차단하는 필터링 로직 적용
• AI Persona 시스템(Angela 등)을 연동하여 캡처된 초안을 기술 명세서 수준으로 정제하는 Optional Polish 단계 구축
• 별도 플랫폼 의존성 없이 Git Repository 내 평문 파일로 저장하여 grep 기반 검색 및 Git SHA 연동을 통한 추적성 확보