Show GN: Cluedoc: 코드베이스 이해를 돕는 문서 작성 에이전트 스킬

Cluedoc은 AI 에이전트가 코드를 수정할 때마다 그에 맞춰 **인간이 읽기 쉬운 문서(Documentation)**를 함께 작성하고 유지하도록 설계된 Agent Skill입니다. 코드가 생성하는 속도를 사람이 따라가지 못하는 문제를 해결하기 위해, 단순한 README를 넘어 기능(Feature) 단위의 학술 논문 형식으로 문서를 구조화합니다.

주요 특징은 다음과 같습니다:

• 기능 중심의 계층 구조: 시스템을 기능 단위로 나누고, 각 기능을 하나의 논문(Abstract, Introduction, Figures 등 포함)으로 작성하여 .cluedoc/ 디렉토리에 저장합니다.
• Capability Tree: 기능 간의 관계를 시각화한 계층 구조를 통해 시스템의 전체적인 설계 모델을 제공합니다.
• Progressive Sync: 코드 변경 사항을 추적하여 관련 문서를 실시간으로 업데이트하며, 기능 간의 인용(Citation) 관계를 통해 문서 간 연결성을 유지합니다.
• Local-first & Versioned: 외부 서버나 벡터 데이터베이스 없이, 코드 저장소 내의 Markdown 파일로 관리되어 코드와 함께 버전 관리가 가능합니다.

기존의 Doxygen이나 Sphinx 같은 도구가 함수나 심볼 단위의 참조를 생성했다면, Cluedoc은 설계자가 이해할 수 있는 기능(Capability) 단위의 설명을 제공하는 데 집중합니다.