ADRs4AI: 인간-AI 협업을 위한 버전 관리된 숙의 기록
핵심 개념: 추론 과정 포착하기
ADRs4AI는 인간-AI 협업 과정에서 '증발'하는 추론 문제를 해결하기 위해, 숙의 과정을 버전 관리되는 아키텍처 결정 기록(ADR)으로 공식화합니다. 코드는 저장되지만, 그 이면의 논리, 고려된 옵션, AI 모델과 논의된 트레이드오프는 일반적으로 유실됩니다. 이 프레임워크는 이러한 숙의 내용을 구조화된 Git 버전 관리 형식으로 기록하도록 강제하여, 향후 협업자들이 특정 구현 선택의 '이유'를 이해할 수 있도록 합니다.
ADRs4AI 워크플로우
이 방법론은 의도의 '씨앗(seed)'을 포착하고, AI가 그 의도를 ADR로 구조화하며, 인간이 최종 결정을 내리는 간단한 루프를 중심으로 합니다. 이 과정은 표준 개발 주기에 통합되도록 설계되었습니다:
- 씨앗(Seed): 사용자가 초기 생각이나 요구사항을 파일에 덤프합니다.
- 구조화(Structure): AI가 이 입력을 처리하여 미해결 질문을 식별하고, 관련 근거, 신뢰 수준, 잠재적 반증 가능성을 포함한 옵션을 제안합니다.
- 결정(Ruling): 인간이 AI의 권장 사항을 검토하고 최종 결정을 내린 후, 이를 저장소에 커밋합니다.
이 워크플로우는 미해결 질문의 트리 뷰를 제공하는 VS Code 확장 프로그램과 이동 중에도 결정을 검토하고 수락할 수 있는 iOS 클라이언트를 통해 지원됩니다. 이 시스템은 ### QST:라는 특정 태그를 사용하여 grep과 같은 표준 도구로 미해결 질문을 쉽게 검색할 수 있도록 합니다.
구현 및 도구
이 생태계는 이 관행을 도입하는 데 따르는 진입 장벽을 낮추기 위해 여러 도구를 제공합니다:
- 저장소 템플릿: ADR 템플릿, 지침, 받은 편지함 프로토콜이 포함된 시작 템플릿입니다.
- VS Code 확장 프로그램: 잘못된 형식의 기록에 대한 진단 기능과 AI 에이전트가 프로젝트의 기록을 쿼리할 수 있게 해주는 MCP 서버를 제공합니다.
- iOS 클라이언트: 보류 중인 결정을 검토하고 답변을 저장소에 직접 커밋할 수 있는 모바일 인터페이스입니다.
커뮤니티 피드백 및 비판
Hacker News에서 ADRs4AI에 대한 반응은 구조화된 의사결정의 잠재적 유용성과 구현에 관한 실질적인 우려를 동시에 보여주었습니다.
일부 사용자는 프로젝트의 마케팅 중심적인 발표 방식에 회의적인 반응을 보이며, ADR의 핵심 개념은 이미 소프트웨어 공학에서 잘 알려진 것이라고 지적했습니다. 다른 이들은 AI 기반 워크플로우에서 '문서 부패(doc rot)'의 위험에 대해 우려를 제기했습니다:
"에이전트는 ADR이 문서화하고 있다고 가정하는 다양한 상충하는 '가드레일'과 '제약 조건'으로 인해 혼란을 느끼기 시작할 것입니다. 에이전트에게 왜 특정 작위적인 행동을 했는지 물어보면, 결함이 있거나 오래된 가정을 인용할 것입니다. 이는 예전과 같은 문서 부패 문제이지만, 이제는 문서가 맹목적으로 준수된다는 점이 다릅니다." — @handle
반대로, 이 시스템의 지지자들은 intent.md 파일과 같은 설계 규칙을 문서화하는 것이 AI 보조 개발 세션 전반에 걸쳐 일관성을 유지하는 데 매우 효과적일 수 있다고 언급했습니다. 사용자들은 이 프로젝트가 더 넓은 채택을 얻으려면 문서화의 이론적 이점을 넘어 구체적이고 성가신 문제점을 어떻게 해결하는지 보여주는 더 명확한 실제 사례 연구를 제공해야 한다고 제안했습니다.