AI 개발 워크플로우 효율화를 위한 `ai-docs` GitHub 워크트리 관리 도구

핵심 기술

본 콘텐츠는 AI 코딩 어시스턴트 사용 시 발생하는 컨텍스트 파일 관리의 복잡성을 해결하기 위한 ai-docs라는 CLI 도구를 소개합니다. 핵심은 AI 관련 파일을 메인 개발 브랜치에서 분리하여 별도의 Git 브랜치(@ai-docs/{username})에 저장하고, Git worktree를 통해 로컬 환경에 마운트하는 방식입니다.

기술적 세부사항

• 문제점: AI 어시스턴트의 방대한 컨텍스트 파일 생성, 비결정적 파일 생성, Git 병합 충돌, 코드 리뷰 방해, .gitignore 관리의 어려움.
• 해결 방안: AI 컨텍스트 파일을 메인 브랜치에서 분리하여 별도의 Git 브랜치에 저장하고 worktree로 관리.
• ai-docs 도구 기능:
  • @ai-docs/{username} 형태의 독립적인 브랜치 생성 (username은 config, git user.name, hostname에서 결정).
  • .ai-docs/ 경로에 해당 브랜치를 Git worktree로 마운트.
  • memory-bank/, CLAUDE.md와 같은 AI 파일들을 해당 브랜치로 이동.
  • 메인 브랜치의 .gitignore를 자동으로 업데이트하여 AI 파일 추적 방지.
  • 변경 사항을 동기화하기 위한 pull 및 push 명령어 제공.
• 개발 과정: ChatGPT와 Claude를 활용하여 워크플로우 구상, 프로토타이핑, CLI 스캐폴딩 진행.
• 안정성 개선: 초기 버전의 rm -rf 사용으로 인한 .git 폴더 삭제 문제를 겪고, --force 플래그 사용 시에만 파일 삭제를 제한하고 안전한 Git 명령어 사용으로 전환.
• 자동화: GoReleaser와 GitHub Actions를 이용한 자동 릴리즈 설정을 시도했으나, 설정 오류와 AI 제안의 부정확성으로 인해 개선의 여지를 남김.

개발 임팩트

• 작업 브랜치를 깨끗하게 유지하며 AI 컨텍스트 파일과 주요 개발 코드를 분리할 수 있습니다.
• .ai-docs/ worktree를 통해 AI 관련 파일에 쉽게 접근하고 관리할 수 있습니다.
• push 및 pull 명령어로 AI 파일과 메인 브랜치 간의 변경 사항을 간편하게 동기화할 수 있습니다.
• AI 개발 워크플로우의 전반적인 조직화 및 효율성 증대.

커뮤니티 반응

콘텐츠에서 직접적인 커뮤니티 반응은 언급되지 않았으나, GitHub 저장소 링크와 함께 피드백을 환영한다는 메시지를 통해 오픈소스 프로젝트로서의 발전 가능성을 시사합니다.