Claude Code의 환각과 설계 이탈을 방지하는 Specforge 프레임워크

작성자가 직접 개발한 프레임워크에 대해 대체로 긍정적인 반응이며, 특히 Claude Code의 환각 문제를 겪던 사용자들이 구체적인 워크플로와 에이전트 구성 방식에 관심을 보이고 있다.

• Claude Code 사용 시 모델이 제안하는 코드를 바로 수용하지 말고 실제 파일 존재 여부를 확인하는 그라운딩 단계를 워크플로에 포함하라.
• 복잡한 기능 구현 전 Mermaid를 활용하여 다이어그램을 먼저 작성하고 이를 시스템 아티팩트의 기준으로 삼아라.

• Claude Code를 단순한 코드 생성기가 아닌 설계 초안 작성자로 취급하고 4개의 전문 에이전트로 다각도 검토를 수행하여 보안 구멍과 에지 케이스를 포착한다.
• 모든 설계 참조를 실제 코드베이스와 대조하는 그라운딩 과정을 강제하여 모델이 임의로 엔드포인트나 함수를 발명하는 환각 현상을 원천 봉쇄한다.
• 구현 완료 후 시스템 아티팩트의 변경 사항(diff)을 자연어로 확인하는 방식을 통해 복잡한 마이크로서비스 환경에서도 코드 품질 관리를 효율화할 수 있다.