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

혹시 코딩 에이전트가 쏟아내는 코드에 지치셨나요? 그래서 여러분의 소프트웨어를 이해하는 걸 포기하셨나요?

에이전트가 코드를 작성하면, 이해하는 것이 가장 중요한 일이 됩니다. 단 한 줄도 직접 타이핑하지 않았고 코드베이스는 계속 바뀌는데, 시스템이 실제로 무슨 일을 하는지, 다음 수정이 안전한지 어떻게 알 수 있을까요? 에이전트가 대신 일해주더라도, 에이전트를 올바른 방향으로 이끌려면 만들고 있는 시스템에 대한 최소한의 이해가 필요합니다.

그래서 Cluedoc을 만들었습니다. Cluedoc은 코딩 에이전트가 사람이 읽기 쉬운 문서들을 작성하게 하는 Agent Skill입니다. Cluedoc의 문서는 읽히기 위해 만들어졌습니다. 기술적인 내용들을 제외하고 상위 수준의 개념에 집중합니다.

Cluedoc은 시스템을 기능(feature)의 트리로 보고, 기능마다 하나의 문서(paper)를 작성합니다. 문서는 코드베이스 안에 순수 Markdown으로 존재하며 작업 루프 안에서 항상 최신 상태로 유지됩니다. 서버도 필요 없고, 데이터베이스도 필요 없습니다.

링크한 랜딩 페이지 자체가 Cluedoc에 대해 쓴 Cluedoc 문서입니다. Flask, Cobra, Commander에 대해 생성한 예시 문서들도 있으니 한번 살펴보세요.