헌법: 프로젝트 원칙

모든 기능이 지켜야 할 원칙을 constitution.md 한 장에 적습니다. 원칙은 계획 단계의 헌법 점검, 일관성 분석, 수렴 단계에서 가장 중요한 기준으로 다시 쓰입니다.

무엇을 · 왜#

헌법(constitution)은 기능 하나가 아니라 프로젝트 전체에 적용되는 규칙입니다. 사양마다 "시험은 먼저 쓴다", "외부 연동은 모의로 둔다"를 되풀이하는 대신 한 곳에 두고, 이후 단계에서 이 문서를 읽고 따릅니다.

따라 하기#

1. 원칙을 말로 적어 넘깁니다. 이 실습에서는 원칙 네 개를 제시했습니다.

   /speckit-constitution 전국 주차장 검색·예약 서비스의 원칙을 정해 줘. 1) 시험 먼저: 인수 시나리오(Given/When/Then)마다 자동 시험을 먼저 쓰고 실패를 확인한 뒤 구현한다. 2) 단순함: 백엔드 서비스 하나와 웹 화면 하나로 시작하고, 결제 같은 외부 연동은 모의로 둔다. 3) 사양이 기준: spec.md 에 없는 기능은 만들지 않는다. 4) 문서와 화면 문구는 한국어로 쓴다.
   

2. 결과를 읽고 풀어 쓴 규칙을 확인합니다. 22초 만에 .specify/memory/constitution.md가 채워졌습니다. Claude는 "말씀하신 원칙에서 제가 풀어 쓴 규칙"으로 세 가지를 따로 알려 주었습니다. 모의 구현은 교체 가능한 인터페이스 뒤에 둔다, 구조를 늘리려면 plan.md에 근거를 적는다, 코드 식별자는 영어를 허용한다. 원치 않으면 이때 고치라고 합니다.

   

산출물: constitution.md#

틀의 빈칸([PRINCIPLE_1_NAME] 등)이 원칙 네 개로 채워지고, 원칙마다 MUST·MUST NOT와 근거가 붙습니다.

### I. 시험 먼저 (NON-NEGOTIABLE)
spec.md 의 인수 시나리오(Given/When/Then)마다 자동 시험을 먼저 작성해야 한다(MUST).
구현 전에 해당 시험을 실행해 실패하는 것을 확인해야 하며(MUST), 그 뒤에 시험을 통과시키는
최소한의 구현을 한다.
근거: 시나리오와 시험을 1:1로 묶어 두어야 사양 충족 여부를 사람의 판단 없이 확인할 수 있다.

### III. 사양이 기준
spec.md 에 없는 기능은 만들지 않는다(MUST NOT). 구현 중 필요한 기능이 발견되면 먼저
spec.md 를 갱신(`/speckit-specify` 또는 `/speckit-clarify`)한 뒤 시험과 구현을 진행한다.

맨 위에는 화면에 보이지 않는 주석으로 Sync Impact Report가 붙습니다. 무엇이 바뀌었는지, 다른 문서에 미칠 영향이 있는지를 적는 자리입니다.

<!--
Sync Impact Report
- Version change: (템플릿 미작성) → 1.0.0
- Added principles: I. 시험 먼저, II. 단순함, III. 사양이 기준, IV. 한국어 사용
- Added sections: 기술 및 범위 제약, 개발 절차와 품질 관문, Governance
-->

맨 아래 「Governance」에는 헌법을 고치는 규칙이 있습니다. 버전은 의미적 버전(semantic versioning)을 따릅니다. 원칙을 지우거나 다시 정의하면 MAJOR, 원칙이나 절을 더하면 MINOR, 표현만 다듬으면 PATCH를 올립니다. 이 실습의 헌법은 1.0.0으로 시작했습니다.

확인 문제#