/spec:seed — 흔들리지 않는 "핵심 명세" 굳히기#

소크라테스식 인터뷰로 끌어낸 답을, 함부로 바꾸지 않는 제품의 "변하지 않는 뼈대(Seed 명세)" 한 장으로 정리합니다.

한마디로#

깊은 질문(인터뷰)으로 알아낸 내용을, 나중에 흔들리지 않는 "핵심 약속" 한 장으로 굳히는 단계입니다. 건물로 치면, 인테리어는 바꿔도 되지만 절대 못 옮기는 "기둥과 골조"를 먼저 박아두는 일과 같아요.

누가·언제 쓰나요#

• 깊은 인터뷰(/spec:interview)를 이미 끝내서, 무엇을 만들지 합의가 거의 다 된 경우
• "이건 절대 바뀌면 안 된다"는 핵심 문제·제약을 문서로 못 박아두고 싶을 때

👉 먼저 필요한 것: 인터뷰 결과 파일(docs/socratic-discovery-{프로젝트이름}.md)이 있어야 하고, 그 합의 수준(수렴도)이 0.95 이상이어야 합니다. 부족하면 명령이 "인터뷰를 더 진행할까요?"라고 알려줍니다.

무엇을 해주나요#

파일 두 개가 만들어집니다.

• docs/seed-spec-{프로젝트이름}.md — 핵심 명세(처음엔 초안/DRAFT 상태). 핵심 문제, 절대 바꾸면 안 되는 제약, 핵심 개념, 합격 기준, 드러난 가정 등이 정리됩니다.
• docs/decision-log-{프로젝트이름}.md — 앞으로의 결정들을 기록할 "의사결정 일지"의 시작점

여기서 만든 명세는 아직 "초안"입니다. 이후 모호함 점검·반론 검토·단순화·구조 검증을 거쳐 최종적으로 "잠금(lock)"됩니다.

어떻게 쓰나요#

/spec:seed                           # 인터뷰 결과로부터 핵심 명세 만들기
/spec:seed --from {discovery-file}   # 사용할 인터뷰 결과 파일을 직접 지정
/spec:seed --slug {project-slug}     # 프로젝트 식별 이름(슬러그) 직접 지정

--from을 생략하면 가장 최근 인터뷰 결과(docs/socratic-discovery-*.md)를 자동으로 씁니다. --slug을 생략하면 인터뷰 결과에서 프로젝트 이름을 자동으로 뽑아냅니다.

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

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

1. 인터뷰 결과 불러오기 — 인터뷰 문서를 읽고, 합의 수준(수렴도)이 충분한지(0.95 이상) 확인합니다. 부족하면 인터뷰를 더 하라고 안내합니다.
2. 핵심 명세 초안 만들기 — 정해진 양식에 맞춰 핵심 문제, 절대 바꾸면 안 되는 제약, 핵심 개념, 합격 기준(해야 함/하면 안 됨/해도 됨), 드러난 가정, 변경 이력(v1.0.0)을 채웁니다.
3. 사용자 검토 — 만든 초안을 보여주고, 항목별로 의견을 받아 수정합니다.
4. 파일 저장 — 초안(DRAFT) 상태로 명세 파일을 저장하고, 의사결정 일지 파일을 새로 만듭니다.

이후 모호함 점검(/spec:ambiguity), 반론 검토(/spec:challenge), 단순화(/spec:simplify), 구조 검증·잠금(/spec:verify)으로 이어집니다.

/spec:seed                           # Create from Socratic interview results
/spec:seed --from {discovery-file}   # Specify a specific interview result
/spec:seed --slug {project-slug}     # Specify project slug