Claude Code를 위해 GitHub을 지식 그래프 (Knowledge Graph)로 사용하는 시스템을 구축했으며, 그 결과가 경이롭습니다.

여러분 안녕하세요! 이곳의 대부분의 사람들처럼 저도 저만의 플랫폼과 전반적인 제품을 구축하고 있습니다 (참고로 아주 잘 진행되고 있습니다! 감사합니다). 시간이 흐르면서 저의 워크플로우는 이전 세션이나 에이전트(Agent)가 저질렀던 실수를 그대로 반복하는 에이전트들을 관리하고 오케스트레이션 (Orchestration) 하는 사이에 놓이게 되었습니다. 코드베이스 (Codebase)가 커질수록 이러한 실수들이 늘어났고, 코드베이스 내의 서로 다른 기능들 사이의 통합 (Integration) 공백 또한 점점 더 명확해졌습니다.

그러다 약 2개월 전부터 제가 직접 개발한 "ForgeDock"이라는 사내 시스템을 사용하기 시작했습니다. 기본 개념은 이렇습니다. 이 시스템은 기본적으로 GitHub CLI를 통해 접근 가능한 GitHub 이슈 (Issue), 풀 리퀘스트 (Pull Request), 코멘트 (Comment) 및 기타 모든 가능한 정보들을 Claude Code의 모든 에이전트와 오케스트레이터 (Orchestrator)를 위한 인용 가능한 지식 베이스 (Knowledge Base)로 변환합니다. 즉, 각 에이전트가 해결할 이슈를 맡을 때 무엇을, 어디서, 어떻게, 언제, 누가 해야 하는지에 대한 완전한 이해를 갖게 됩니다. 이를 통해 특정 에이전트에게 각 이슈에 맞춤화된 컨텍스트 (Context)와 함께 매우 세밀한 작업을 수행할 수 있도록 합니다. GitHub 이슈는 조사 작업부터 리서치 (Research) 작업, 버그 수정 (Bug fix) 또는 그 외 다양한 것들이 될 수 있습니다.

이 시스템의 상단에는 여러 에이전트를 한 번에 다양한 웨이브 (Wave) 단위로 실행할 수 있는 오케스트레이션 레이어 (Orchestration layer)가 자리 잡고 있습니다. 웨이브를 통해 작업은 충돌하지 않는 수준으로 분할될 수 있습니다. 예를 들어, 4개의 이슈가 동일한 파일을 건드리는 경우, 충돌 위험을 방지하기 위해 지능적으로 이를 별도의 경로로 분할합니다. 여러분은 그저 Claude Code로 가서 "새로운 기능 마일스톤 (Milestone)을 오케스트레이션해줘"라고 말하고 자리를 비웠다가 돌아오기만 하면 됩니다. 그러면 다듬어지고 품질이 높으며 완전히 통합되고 연결된 프로덕션 레벨 (Production level) 시스템을 마주하게 될 것입니다. ForgeDock은 그 하나의 프롬프트 (Prompt)로부터 모든 것을 처리합니다. 조사하고, 새로운 이슈를 생성하고, 범위를 정하고, 오케스트레이션 웨이브를 계획하며, 작업을 수행하고, 검토(Review)한 뒤 마일스톤 브랜치 (Branch)에 병합 (Merge)합니다. 그리고 완전히 전달될 때까지 이 과정을 반복합니다. 검토 과정에서 PR(Pull Request)당 발견된 사항이 있다면 새로운 이슈를 생성할 수도 있습니다. 친구들에게 이것을 보여주었을 때 그들은 즉시 경악하기 시작했습니다. 저는 이것이 모두에게 유용할 것이라고 생각했을 뿐입니다!

이 파이프라인은 제가 실제 고객과 사용자들에게 서비스하며 제 이름을 내걸 수 있는 프로덕션 레벨 (production level) 애플리케이션을 1인 개발자로서 운영하는 동안, 새로운 기능 개발, 버그 (Bugs), 보안 강화 (Security hardening), 통합 접점 (Integration touchpoints), 경쟁사 조사 (Competitor research), 검색 엔진 최적화 (search engine optimization) 및 기타 수많은 유형의 이슈 (issues)를 포함하여 제 프로젝트를 위해 2만 개 이상의 이슈를 조율해 왔습니다. 사람들이 이 아이디어를 더 빠르고 쉽게 이해할 수 있도록 설명 영상 (explainer video)을 제작 중입니다. 질문이 있으시면 댓글로 기꺼이 설명해 드리겠습니다. 그동안 꼭 확인해 보시고, 도움이 되었다면 별 (star)을 남겨주세요. 완전히 오픈 소스 (open source)입니다 😄 https://github.com/RapierCraftStudios/ForgeDock /u/Opposite-Art-1829 님이 제출함 [link] [comments]