테마
Scene C1 · Spec 생성
💡 이 실습에서 사용하는 Spec 세션의 개념과 원리는 기능 카탈로그 · Spec 세션에서 자세히 볼 수 있습니다.
목표
Spec 세션을 열어 체계적인 "Task Management System" 스펙을 생성합니다. Spec 기반 개발의 첫 단계인 구조화된 요구사항 입력을 체험합니다.
사전 준비
spec-todo폴더를 Kiro에서 열기 (File → Open Folder)- 빈 상태에서 시작
해볼 것
1단계: Spec 세션 시작
- Kiro 패널에서 Specs 섹션 클릭
- Create Spec 버튼 클릭
- Kiro가 먼저 Spec 유형과 시작 경로를 묻습니다. 이 실습은 새 기능을 처음부터 정의하므로 다음을 선택합니다:
- Spec 유형:
Build a Feature(새 기능/앱 생성) - 시작 경로:
Requirements(상위 아이디어에서 시작해 무엇을 만들지 먼저 정의)
티켓·브리프로 요구사항이 이미 명확하다면
Technical Design으로 바로 들어갈 수도 있고, 결함을 구조적으로 고칠 때는Fix a Bug를 선택합니다. 자세한 내용은 Spec 세션을 참고하세요. - Spec 유형:
- 아래 프롬프트를 붙여넣기:
Spec 생성 프롬프트
text
"Task Management System"이라는 이름으로 할 일 관리 애플리케이션 spec을 만들어주세요.
핵심 기능:
- 할 일 생성, 편집, 삭제
- 우선순위 설정 (높음/보통/낮음)
- 상태 관리 (todo, in-progress, completed)
- 마감일 설정 및 알림
- 로컬 스토리지를 통한 데이터 영속성
사용자 스토리:
- 개인 사용자가 일일 업무를 체계적으로 관리
- 우선순위에 따른 작업 정렬 및 필터링
- 진행 상황 추적 및 완료율 확인
기술 요구사항:
- HTML5, CSS3, ES6+ JavaScript
- 반응형 웹 디자인 (모바일 우선)
- 웹 접근성 지침(WCAG) 준수
- 브라우저 호환성 (Chrome, Edge, Firefox, Safari)
이번 Spec의 범위:
- 포함: 개인 할 일의 생성·편집·삭제·상태·우선순위 관리
- 제외(Out of scope): 로그인, 서버 동기화, 푸시 알림, 팀 협업
- 향후 기능(예: 공유·알림)은 별도 Spec으로 분리2단계: Spec 구조 확인
Kiro가 생성한 Spec의 3단계 구조를 확인합니다:
- requirements.md — 기능/비기능 요구사항 (EARS 형식)
- design.md — 기술 아키텍처, 컴포넌트 구조, 데이터 모델
- tasks.md — 구현 작업 목록 (순서·의존성 포함)
tasks.md를 열어 제품 완료에 필요한 항목은 required, 있으면 좋은 확장 항목은 optional로 표시했는지 확인합니다. 로그인·공유처럼 이번 범위 밖 기능은 task로 넣지 말고 별도 Spec 후보로 기록하세요.
3단계: 폴더 확인
탐색기에서 .kiro/specs/ 폴더가 생성되었는지 확인:
.kiro/
└── specs/
└── task-management-system/
├── requirements.md
├── design.md
└── tasks.md기대 결과
.kiro/specs/task-management-system/폴더에 3개 문서 생성- 같은 앱이지만 Vibe 때와 달리 "체계적 설계 문서"가 먼저 만들어짐
- 이 문서를 기반으로 Scene C2~C5에서 검토·구현 진행
- Specs 섹션에서 Create Spec 실행필수
- requirements.md 파일 생성 확인필수
- design.md 파일 생성 확인필수
- tasks.md 파일 생성 확인필수
🚨 문제 해결
- Spec이 생성되지 않음: Kiro 패널 → Specs 섹션이 보이지 않으면 Kiro 업데이트 확인. 최소 버전 요구사항 확인.
- Spec 이름이 다르게 생성됨: 자동 생성된 이름을 기록해두세요. 이후
#spec:참조 시 해당 이름을 사용합니다. - 파일이 1~2개만 생성됨: Kiro가 순차적으로 생성 중일 수 있습니다. 잠시 기다리거나 "나머지 design.md, tasks.md도 생성해주세요"라고 요청.