/cc-spec:simplify — 기획서 군살 빼기#

한마디로#

확정된 기획서(Seed spec)가 너무 복잡하지 않은지 점검하고, 덜어낼 부분을 제안해 주는 명령입니다. 이사 가기 전에 짐을 펼쳐 놓고 "이건 안 써, 저건 합치자, 이건 나중에"라고 정리하는 것과 같아요.

누가·언제 쓰나요#

• 기획서를 만들었는데 항목이 너무 많아 부담스러울 때
• v1(첫 출시)에 꼭 필요한 것만 남기고 군더더기를 걸러내고 싶을 때
• 무엇을 빼고 무엇을 나중으로 미룰지(v2) 객관적인 기준이 필요할 때

무엇을 해주나요#

기획서의 복잡도를 숫자로 측정하고, 줄일 방법을 정리한 리포트를 보여줍니다.

• 복잡도 점수 — 항목 개수를 바탕으로 계산한 점수와 판정(적정 / 주의 / 과도)
• 단순화 제안 목록 — 빼도 되는 항목, 합칠 수 있는 항목, 나중(v2)으로 미룰 항목을 "전 vs 후"로 비교
• 결정 기록 — 각 제안에 대해 수락·거절·보류한 내용 기록

수락한 제안은 기획서(Seed spec) 파일에 그대로 반영되고, 리포트는 화면에 출력됩니다.

어떻게 쓰나요#

/cc-spec:simplify                       # 가장 최근 기획서를 대상으로
/cc-spec:simplify --file {경로}          # 특정 파일을 지정해서

특정 파일을 콕 집어 점검하려면 --file 뒤에 파일 경로를 적습니다. 아무것도 안 적으면 가장 최근 기획서(docs/seed-spec-*.md)를 자동으로 찾습니다.

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

기획서를 읽어서 군살을 진단하고, 함께 결정한 내용을 다시 기획서에 반영합니다.

1. 기획서 읽기 — 대상 파일을 불러와 항목별로 분해합니다.
2. 복잡도 측정 — 엔터티·관계·제약·필수 항목·검증 안 된 가정의 개수를 세어 복잡도 점수를 계산합니다.
3. 판정 — 점수에 따라 적정(015) / 주의(1630) / 과도(31+)로 분류합니다.
4. 단순화 제안 — 뺄 것, 합칠 것, 나중으로 미룰 것을 "전 vs 후"로 정리해 제안합니다.
5. 결정 받기 — 제안마다 수락·거절·보류를 선택합니다.
6. 리포트 정리 — 측정 결과 + 제안 목록 + 결정 기록을 한눈에 정리합니다.

/cc-spec:simplify                       # Target the latest Seed spec
/cc-spec:simplify --file {path}         # Target a specific file