ClearSpec: Claude 코드의 환각 현상을 줄이기 위한 사양 생성기

ClearSpec: Claude Code를 위한 구조화된 명세서 생성

ClearSpec은 모호한 입력 설명으로 인해 Claude Code가 기술적으로는 작동하지만 불완전한 구현을 생성하는 문제를 해결하기 위해 설계된 명세서 생성기입니다. 이 도구는 일반 영어 설명을 Claude Code에 대한 개선된 프롬프트 역할을 하는 상세하고 구조화된 명세서로 변환합니다.

작동 방식

사용자가 일반 영어로 원하는 것을 설명하고 GitHub 저장소를 연결하면 ClearSpec이 다음과 같은 내용을 포함하는 구조화된 명세서를 생성합니다:

• 사용자 스토리
• 수용 기준
• 실패 상태
• 검증 기준

모든 명세서는 연결된 코드베이스의 실제 파일 경로와 의존성을 참조합니다. 생성된 명세서는 Claude Code의 프롬프트가 되어 모델이 실제로 사용할 수 있는 컨텍스트를 제공합니다.

소스 상세 정보

이 도구는 Claude Code를 매일 사용해 온 지 1년이 된 사용자가 개발했으며, 가장 큰 문제는 모델 자체가 아니라 모호한 설명으로 인해 절반의 경계 사례를 놓치는 구현이 발생한다는 점을 파악했습니다.

ClearSpec은 현재 초기 액세스 기간 동안 월 5개 명세서 제한으로 무료이며 신용카드가 필요하지 않습니다. 제작자는 다른 Claude Code 사용자들의 피드백을 구하고 있습니다.