githubnext/chopin

해결하는 문제

Chopin은 구현 계획, RFC, 의사결정 기록과 같은 지속 가능한 기술 문서를 인간 개발자와 AI 에이전트 간의 협업을 통해 작성하는 과제를 해결합니다. 최종 글의 내용과 추론 및 승인된 답변을 분리함으로써 의사결정의 맥락이 손실되는 것을 방지하며, 나중에 글을 재작성할 때 선택의 이유가 조용히 사라지는 것을 막습니다.

작동 방식

Chopin은 GitHub 리포지토리와 멀티플레이어 리치 텍스트 문서를 연결하는 "채널"을 생성합니다. 리포지토리의 코드와 풀 리퀘스트를 읽을 수 있는 호스팅된 에이전트인 Planner가 변경 제안과 내용 초안을 제시합니다.

주요 구성 요소:

• 협업 문서: 인간과 에이전트가 실시간으로 함께 편집할 수 있는 MDX 기반의 공동 공간.
• 채팅: 팀 커뮤니케이션 공간으로, @chopin을 호출하여 에이전트를 불러내어 대화에 따라 행동하게 할 수 있습니다.
• 의사결정: 문서 본문과 별도로 속성 부여된 질문 답변과 댓글을 추적하는 전용 시스템.
• 연구: /research 명령어를 통해 백그라운드 작업을 트리거하고, 정보를 수집하여 자식 문서로 결과를 게시합니다.
• MCP 통합: 외부 코드 에이전트가 구현 계획을 생성하거나 소비할 수 있는 Model Context Protocol (MCP) 엔드포인트를 제공합니다.

대상 사용자

아키텍처 결정 기록을 엄격히 유지하면서 AI 지원을 받아 기술 사양 및 계획 문서를 공동 작성해야 하는 소프트웨어 엔지니어링 팀.

주요 특징

• 리포지토리 기반 AI: Planner 에이전트는 GitHub 리포지토리에 읽기 전용으로 접근하여 제안이 실제 코드 기반임을 보장합니다.
• 의사결정 지속성: "왜"(의사결정)과 "무엇"(문서 본문)을 분리합니다.
• 멀티플레이어 편집: 인간과 에이전트 모두의 존재와 커서를 실시간으로 지원하는 공동 편집 기능.
• 외부 에이전트 연결성: MCP를 사용하여 Chopin 내의 고수준 계획과 외부 에이전트의 실제 코드 구현 사이의 격차를 메웁니다.