소개

"코드는 있지만 명세서가 없거나, 명세서는 있지만 신뢰할 수 없다" ── 레거시 시스템 유지보수, 신규 참여 엔지니어 온보딩, 납품물로서의 명세서 정비,社内 지식 정비 등 어느 현장에서도 자주 마주치는 과제입니다.

LLM 이 당연한 시대가 되었으니, AI 에게 "이 코드에서 명세서를 만들어달라"고 요청하면, 예쁜 Markdown 명세서가 순식간에 돌아옵니다. 하지만 그 명세서를 프로덕션 운영에 견딜 수 있는 품질로 받아들이면, "추측으로 채워진 아름다운 허구" 였다는 경우가 적지 않습니다. "order_status 의 5 는 무엇을 의미하는가"를 물으면 "상수의 의미를 읽어보세요..."라고 쓰여 있어도, 실제 소스에는 // TODO: 5 는 폐지 예정 이라는 코멘트만 있었다는 것과 같은 함정입니다.

이 문제를 정면으로 해결하기 위해, 기존 코드베이스에서 명세서를 역생성하는 Claude Code 스킬 cc-rsg 를 만들어 공개했습니다. 본 기사에서는 그 설계 사상과 구현 개요를 공유합니다.

저장소: https://github.com/daishir0/cc-rsg

예상 독자

• 레거시 코드 명세화에 관여하는 엔지니어 / 컨설턴트
• LLM 에 명세서 생성을 맡겨서 "이렇다