명세 기반 워크플로우(인터뷰 → 명세 → 계획 → 작업 → 코드)를 강제하는 오픈 소스 Claude Code 플러그인을 만들었습니다

많은 사람들과 마찬가지로, 저의 Claude Code 세션은 보통 다음과 같이 진행되었습니다: 모호하게 "기능 X를 만들어줘"라고 던져놓고, 결과가 잘 나오기를 기도하는 식이었죠. 때로는 훌륭한 결과물이 나오기도 했지만, 종종 두 시간 동안 엉킨 실타래를 푸는 데 시간을 허비해야 하는 프랑켄슈타인 같은 결과물이 나오곤 했습니다. 제가 발견한 패턴은 이렇습니다: 모델이 멍청한 것이 아니라, 제 요청이 모호했다는 것입니다. 그래서 모델은 추측을 통해 그 빈틈을 채워버린 것이죠. 프롬프트(Prompt) 문단을 더 많이 추가하는 것으로는 해결되지 않았습니다. 구조(Structure)가 필요했습니다.

그래서 제가 수동으로 사용해 오던 방식을 Specsmith라는 플러그인으로 패키징했습니다. 이 플러그인은 코드가 작성되기 전에 다음과 같은 흐름을 강제합니다:

• 프롬프트 그릴 (prompt-grill): 모호한 요청을 명확한 명세(Spec)로 작성할 수 있을 때까지 한 번에 하나씩 질문을 던져 심문합니다. 그 후 specs/<feature>/spec.md를 생성합니다.
• 메서드 실행: spec.md → plan.md → tasks.md → code 순으로 실행되며, 작업(Task)당 하나의 커밋(Commit)을 생성합니다.
• 개발 라이프사이클 (dev-lifecycle): git 측면을 처리합니다: develop 브랜치에서 분기, Conventional Commits 준수, 테스트/CI 통과, 그리고 자동 병합(Auto-merging) 대신 사용자의 승인을 기다리는 PR(Pull Request) 생성.

Claude Code에서 설치는 두 개의 명령어로 가능합니다:
/plugin marketplace add murilobauck/specsmith
/plugin install specsmith@specsmith

주의 사항: 이 프로젝트는 v0.1 버전이며, 의도적으로 최소한의 기능만 담았습니다. 기능을 부풀리기 전에 실제 사용 환경에서 검증할 수 있도록 메서드를 먼저 출시했습니다 (두 가지 스킬 + specs/ 스캐폴딩(Scaffold)). MIT 라이선스입니다. 어떻게 만들어졌는지 확인하거나 향후 행보를 따라가고 싶다면 리포지토리(Repo)는 여기 있습니다: https://github.com/murilobauck/specsmith

만약 사용해 보신다면, 어디에서 문제가 발생하거나 사용감이 어색한지 진심으로 알고 싶습니다. 그것이 v0.2를 만들어가는 밑거름이 될 것입니다.