ZeeSpec의 개요
ZeeSpec은 Vishal Mysore의 명세 주도 개발 방법론입니다. 무엇을, 어디서, 언제, 누가, 왜, 어떻게의 여섯 묶음에 10개씩, 모두 60개의 질문이 있으며, 약 한 시간 안에 답해서 에이전트가 짐작해야 할 정의되지 않은 동작을 남기지 않는 것이 목표입니다. 작은 Node.js CLI가 .spec/ 폴더에 Markdown 템플릿 여덟 개를 만들고, 이를 AGENTS.md로 묶은 뒤 프롬프트를 클립보드에 복사합니다.
vishalmysore.github.io/zeespec/app의 브라우저 앱에는 탭이 세 개 있습니다. Spec Builder는 질문을 차례로 안내하고, WebGPU 로컬 모델로 AGENTS.md 초안을 쓸 수 있습니다. EPIC Score는 2026년 10월 arXiv 논문의 EPIC 루브릭을 휴리스틱으로 옮긴 버전으로 명세, 공개 GitHub 저장소, 붙여 넣은 텍스트를 채점합니다. 10개 차원에 걸친 40개 관행이며 30점 만점입니다. SpecGuard는 SpecGuardBench를 작게 재현한 것으로, JavaScript 작업 16개로 모델의 검증 하니스가 버그 있는 구현을 거부하면서 올바른 구현 두 개를 받아들이는지 시험합니다. 저장소는 커밋 14개에 릴리스가 없고, 마지막 커밋은 2026년 11월 16일입니다.
ZeeSpec, 쓸 만한 가치가 있습니까?
여기서 쓸모 있는 아이디어는 방법론이 아니라 SpecGuard 탭입니다. SpecGuardBench라는 논문이 기록한 실패를 브라우저에서 GPU 없이 보여 줍니다. 참조 구현을 보고 테스트를 쓰라고 하면 모델은 버그까지 포함해 참조 구현을 그대로 따라 합니다. 내장된 기준선 세 개 중 참조를 따라 하는 것은 충실도 0%, 기존 테스트를 되풀이하는 것도 0%이며, 손으로 쓴 오라클만 100%에 이릅니다. 각 하니스는 네트워크 없이 시간 제한이 걸린 워커에서 돌고, 고쳐서 다시 돌릴 수 있습니다. 에이전트가 쓴 테스트가 왜 버그를 통과시키는지 보여 주는 시연으로서, 이 주제를 다룬 대부분의 글보다 명쾌합니다.
EPIC Score 탭은 배지가 풍기는 것보다 소박합니다. 논문 루브릭을 휴리스틱으로 다시 구현한 것이지 저자들의 도구가 아니며, 앱도 그렇게 밝힙니다. 상위 구간 명세는 커밋의 11.8%를 버그 수정에 썼고 하위 구간은 20.4%였다는 논문의 결과는 저장소 114개에 걸친 상관관계입니다.
60개 질문은 좋은 질문이며, 꼼꼼한 테크 리드가 던질 법한 것들입니다. 무엇을 절대 저장하면 안 되는지, 누가 절대 행동하면 안 되는지, 시스템이 언제 막아야 하는지. 한 시간이라는 약속은 프로젝트 스스로의 면책 문구로 누그러집니다.
주의할 점: README의 설치 명령 `npx spec-cli init`은 spec-cli라는 무관한 npm 패키지를 가져옵니다. 2024년에 다른 작성자가 공개했고 다른 저장소를 가리키는 패키지입니다. ZeeSpec 자체는 npm에 없습니다. 실행하면 모르는 사람의 코드가 돌아갑니다. 대신 저장소를 클론해 bin/spec.js를 실행하십시오. 프로젝트의 스타는 18개, 커밋은 14개입니다.
결론: ZeeSpec은 작업지이자 수업용 시연으로 보면 됩니다. 같은 일을 하는 실무용 도구는 GitHub의 Spec Kit입니다.
제 역할을 하는 곳
에이전트가 쓴 테스트를 주제로 사내 워크숍을 여는 엔지니어링 매니저
코드에서 생성한 테스트가 왜 그 코드의 버그를 놓치는지 개발자에게 보여 주기
SpecGuard 탭을 열고 mirror trap 모드를 켠 뒤 기준선 세 개를 그 자리에서 돌립니다. 오라클은 충실도 100%, 나머지 둘은 0%입니다. 무료이고 설치할 것이 없으며, 모든 하니스가 브라우저 안에서 격리되어 돕니다.
Claude Code로 작은 예약 앱을 시작하는 1인 개발자
에이전트가 규칙을 지어내지 않을 만큼 완전한 명세 쓰기
Spec Builder에서 60개 질문을 풀고 AGENTS.md를 내보낸 뒤, EPIC Score 탭에서 점검하고 그 수정 프롬프트를 에이전트에 붙여 넣습니다. CLI는 npx 대신 저장소를 클론해서 씁니다.
도입 전 확인할 점
- 설정
- 로컬 모델을 쓰려면 WebGPU를 지원하는 브라우저에서 웹 앱을 열거나, 저장소를 클론해 `node bin/spec.js init`을 실행합니다. `npx spec-cli`는 실행하지 마십시오. npm에서 그 이름은 무관한 패키지의 것입니다.
- 연동
- AGENTS.md를 읽는 모든 에이전트용으로 이를 생성합니다. EPIC Score는 공개 GitHub 저장소의 Spec Kit, Kiro, ZeeSpec, AGENTS.md 구조를 읽습니다. 선택 사항인 로컬 모델에는 WebLLM을 씁니다.
- 데이터와 개인정보
- 앱은 브라우저 밖으로 아무것도 나가지 않는다고 밝힙니다. 네트워크 트래픽은 모델 다운로드와 GitHub 저장소 가져오기뿐입니다. SpecGuard 하니스는 네트워크 없는 워커에서 돕니다. MIT 라이선스입니다.
- 제한
- SpecGuard는 JavaScript 작업 16개로, 논문의 Python 작업 291개와 점수를 비교할 수 없습니다. EPIC 채점은 휴리스틱입니다. npm 패키지도 태그된 릴리스도 없습니다.
좋은 점
- SpecGuard가 따라 쓴 테스트의 실패를 명확히 보여 줌
- 브라우저 앱은 로컬에서 돌고 테스트 워커는 네트워크 없음
- 60개의 구체적 질문이 정의되지 않은 동작을 드러냄
- 휴리스틱 채점과 그 한계에 대해 정직함
아쉬운 점
- README의 npx 명령이 무관한 npm 패키지를 설치
- EPIC 점수는 휴리스틱이며 논문의 도구가 아님
- 스타 18개, 커밋 14개, 릴리스 없는 아주 작은 프로젝트
- 로컬 모델 다운로드가 약 1~2 GB
추천 대상
구조화된 명세 체크리스트와, 에이전트가 버그를 통과시키는 테스트를 쓰는 모습을 생생하게 보여 줄 시연을 원하는 테크 리드와 강사에게 맞습니다.
ZeeSpec 대안
ZeeSpec: 자주 묻는 질문
- ZeeSpec, 쓸 만한 가치가 있습니까?
- ZeeSpec의 질문은 탄탄한 체크리스트이고 SpecGuard 탭은 날카로운 작은 교육 도구이지만, CLI 설치 명령은 남의 패키지를 가리킵니다. 평점은 5점 만점에 3.3점입니다.
- ZeeSpec의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. 웹 앱은 브라우저에서 실행되며, 선택 사항인 로컬 모델은 한 번 약 1~2 GB를 내려받습니다.
- ZeeSpec의 단점은 무엇입니까?
- README의 npx 명령이 무관한 npm 패키지를 설치; EPIC 점수는 휴리스틱이며 논문의 도구가 아님; 스타 18개, 커밋 14개, 릴리스 없는 아주 작은 프로젝트; 로컬 모델 다운로드가 약 1~2 GB.
- ZeeSpec에 적합한 사람은 누구입니까?
- 구조화된 명세 체크리스트와, 에이전트가 버그를 통과시키는 테스트를 쓰는 모습을 생생하게 보여 줄 시연을 원하는 테크 리드와 강사에게 맞습니다.
- ZeeSpec에 회사 데이터를 맡겨도 안전합니까?
- 앱은 브라우저 밖으로 아무것도 나가지 않는다고 밝힙니다. 네트워크 트래픽은 모델 다운로드와 GitHub 저장소 가져오기뿐입니다. SpecGuard 하니스는 네트워크 없는 워커에서 돕니다. MIT 라이선스입니다.
- ZeeSpec의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Spec Kit 및 Agent Skills (Addy Osmani)입니다.
답변 확인일: 2026년 11월 21일.