/spec:verify — Seed 명세 최종 점검·잠금#

한마디로#

작성한 핵심 명세(Seed spec)가 빠짐없이 잘 갖춰졌는지 검사하고, 합격하면 "확정(잠금)"으로 도장을 찍는 단계입니다. 계약서를 최종 검토하고 서명해서 더는 함부로 못 바꾸게 봉인하는 것과 같아요.

누가·언제 쓰나요#

• 핵심 명세 작성을 마치고, 이제 이걸 확정해도 되는지 점검하고 싶을 때
• 명세에 빠진 항목이나 애매한 부분이 없는지 마지막으로 확인하고 싶을 때
• 검토가 끝난 명세를 더 못 바꾸게 잠가두고(LOCKED) 다음 단계로 넘어가고 싶을 때

무엇을 해주나요#

• 구조 점검 — 명세에 꼭 들어가야 할 10개 항목(M-01~M-10)이 다 채워졌는지 확인하고, 빠진 항목과 보완 방법을 알려줍니다.
• 애매함 점수 확인 — 명세가 얼마나 명확한지 점수로 체크합니다(0.2 이하여야 통과). 아직 평가 전이면 /spec:ambiguity 실행을 권합니다.
• 확정(잠금) — 모든 조건을 통과하면 명세 상태를 DRAFT(초안)에서 LOCKED(확정)로 바꾸고, 잠근 날짜와 기록을 명세 파일에 남깁니다.

검사 결과는 화면에 출력되고, 잠금까지 진행되면 해당 Seed 명세 파일이 갱신됩니다.

어떻게 쓰나요#

/spec:verify                         # 가장 최근에 만든 Seed 명세를 점검
/spec:verify --file {path}           # 특정 파일을 지정해서 점검
/spec:verify --lock                  # 점검 통과 시 자동으로 확정(잠금)까지

• --file 으로 점검할 파일을 직접 지정할 수 있습니다(기본값은 가장 최근 docs/seed-spec-*.md).
• --lock 을 붙이면 점검을 통과했을 때 따로 확인 없이 바로 확정(잠금)까지 진행합니다(기본은 꺼짐).

안에서 무슨 일이 벌어지나요#

크게 네 단계로 진행됩니다.

1. 구조 검사 — 꼭 필요한 10개 항목(M-01~M-10)을 차례로 살펴보고, 빠진 항목과 보완 방법을 정리합니다.
2. 애매함 점수 확인 — 명세가 충분히 명확한지(0.2 이하인지) 확인하고, 아직 평가 전이면 /spec:ambiguity 실행을 안내합니다.
3. 잠금 가능 여부 판단 — 구조 검사 10개 전부 통과 + 애매함 점수 0.2 이하 + (--lock 또는 사용자 확인) 조건이 모두 충족됐는지 확인합니다.
4. 확정(잠금) 실행 — 상태를 DRAFT → LOCKED로 바꾸고, 잠근 날짜를 기록하며, 변경 이력에 "locked" 이벤트를 추가합니다.

/spec:verify                         # Verify the latest Seed spec
/spec:verify --file {path}           # Verify a specific file
/spec:verify --lock                  # Auto-lock on verification pass