Term (용어)aiverifiedFri May 01
Spec (명세 / 사양)
별칭: Spec · 명세 · 사양 · Specification · PRD
#spec#sdd#agentic-engineering#design-first#specification
정의
소프트웨어가 무엇을 해야 하고, 왜 그래야 하며, 어떤 트레이드오프 를 수용하는지 명시적으로 기록한 문서. AI 코딩 시대에 일차 산출물 이 코드에서 Spec + 테스트로 이동했다는 entity/karpathy 의 진단 핵심.
동의어 / 관련 표현
- 영어: Spec / Specification / PRD (Product Requirement Document)
- 한국어: 명세 / 사양 / 요구사항 정의서
- 본 강의 기본 표기: Spec
5대 검증 체크리스트 (오케스트레이터 필수)
좋은 Spec 의 5가지 필수 요소 — synthesis/booklet-9-chapters Part 3 Ch.3:
| 항목 | 의미 |
|---|---|
| Goal | 목표 — 이 변경의 의도 |
| Constraints | 금지 사항 — 해선 안 되는 것 |
| Acceptance criteria | 완료 기준 — 합격선 |
| Verification | 검증 방법 — 어떻게 확인할 것인가 |
| Rules | 규칙 — 적용되는 코딩 컨벤션 |
Spec vs 다른 문서 형태
| 형태 | 역할 |
|---|---|
| Spec | what + why + tradeoffs — AI에게 전달되는 정형 문서 |
| Plan | how + when — Spec 위에서 수립되는 실행 계획 |
| README | 사람용 입문 문서 |
| 코드 주석 | 구현 디테일 |
강의 활용
- 01 INT lesson/int-software-evolution: 일차 산출물 = 코드에서 Spec+테스트로 이동 의 핵심 어휘.
- 04 DSL: Spec 작성의 언어 가 term/claude-md / term/agents-md / term/cursorrules 라는 메시지.
- 05 DEM: 시연 시 Spec 먼저 작성 → AI에게 위임 흐름 보여주기.
- 06 CLN: 5대 체크리스트가 책상에 붙여놓을 카드.
주의사항
- Spec ≠ 코드: Spec은 의도와 계약 이지 구현 이 아니다. 강의 청중이 Spec = 의사 코드 로 오해하지 않도록 주의.
- 무게의 함정: "Spec 작성"이 대규모 RFC 처럼 들리면 청중이 거부 → 작은 Spec(20분)도 충분히 Spec 임을 강조.
- 번역 통일: Spec 그대로 사용 권장. 명세 한국어 표기는 부수적.