# 1. OpenSpec이란? ← [[openspec-00-toc|목차]] | 다음 → [[openspec-02-installation-and-setup|2. 설치 및 초기 설정]] --- ## 1.1 문제 배경 AI 코딩 어시스턴트는 강력하지만, 요구사항이 채팅 히스토리에만 존재할 때 다음과 같은 문제가 발생한다: > [!bug] AI 코딩 어시스턴트의 한계 > - **스코프 크리프(Scope Creep):** AI가 요청받지 않은 코드를 추가하거나 리팩터링 > - **컨텍스트 손실:** 긴 대화 후 AI가 초기 의도를 잊음 > - **팀 정렬 실패:** 팀원마다 다른 이해를 가지고 AI와 대화 > - **검증 불가:** 구현이 원래 요구사항과 일치하는지 확인 방법 없음 ## 1.2 OpenSpec의 해법 OpenSpec은 **Spec-Driven Development(SDD, 사양 주도 개발)** 을 실천하는 경량 프레임워크다. > [!quote] > "코드를 작성하기 **전에** 인간과 AI가 사양(Spec)에 합의한다." 사양 문서를 최우선 아티팩트로 삼고, 코드는 그 사양으로부터 도출된다. AI는 구조화된 경계 안에서만 구현하므로, 할루시네이션과 스코프 크리프를 구조적으로 방지한다. ## 1.3 핵심 철학 | 원칙 | 내용 | |------|------| | **Fluid not rigid** | 단계 제약 없음 — 필요에 따라 자유롭게 이동 | | **Iterative not waterfall** | 구축하며 학습, 진행하며 개선 | | **Easy not complex** | 5분 설치, 최소 절차 | | **Brownfield-first** | 기존 코드베이스와 새 프로젝트 모두 지원 | ## 1.4 경쟁 도구와의 차이 | 항목 | OpenSpec | Kiro (AWS) | GitHub Spec Kit | BMAD | |------|----------|-----------|-----------------|------| | 설치 시간 | **5분** | 30분+ | 30분+ | 복잡 | | AI 도구 지원 | **30종+** | Claude만 | 제한적 | Claude | | IDE 제약 | **없음** | AWS IDE 필요 | VS Code | 없음 | | 학습 곡선 | **낮음** | 중간 | 높음 | 높음 | | 오픈소스 | **MIT** | 아니오 | 제한적 | MIT | > [!success] OpenSpec의 강점 > 도구 독립적 설계로 **어떤 AI 코딩 어시스턴트와도 통합** 가능하며, [[openspec-09-supported-tools-and-integration|30종 이상의 도구]]를 지원한다. --- ← [[openspec-00-toc|목차]] | 다음 → [[openspec-02-installation-and-setup|2. 설치 및 초기 설정]]