Kiro IDE 기초

Kiro 소개

자동 완성에서 자율 에이전트로 — 진화의 끝에서 Kiro가 해결하는 문제와 제품 구조

AI 코딩 도구 진화

자동 완성 → AI 어시스턴트 → 에이전틱 IDE → 자율 에이전트 — 제안을 받는 도구에서 작업을 위임하는 에이전트로 이동한 무게중심

에이전틱 IDE의 세 가지 난제

규칙 드리프트·컨텍스트 한계·검증 부재 — 세 난제와 각각을 맡는 Steering·Skills·Hooks

Kiro — 4가지 형태

IDE·CLI·Web·Mobile — 상황에 맞는 형태 선택

IDE vs CLI

같은 엔진 — 다른 인터페이스

지원 모델 선택

Amazon Bedrock 기반 — 모델을 선택하고 전환

.kiro/ 설정의 두 스코프

Global(전역) 또는 Workspace(프로젝트) 단위로 설정하며, Workspace가 우선

🌐 Global — ~/.kiro/ (모든 Workspace 공통)

~/.kiro/                (Global)
├── steering/           # 팀 표준, 보안 정책
│   ├── coding-standards.md
│   └── team-conventions.md
├── settings/
│   └── mcp.json        # 전역 MCP
├── hooks/              # 전 워크스페이스 적용 훅
├── agents/
└── skills/

📁 Workspace — /.kiro/ (Git 공유 · 우선순위 높음)

<project>/.kiro/        (Workspace)
├── steering/           # 아키텍처, 컨벤션
│   ├── product.md
│   ├── tech-stack.md
│   └── conventions.md
├── specs/              # 요구사항/설계/태스크
├── settings/
│   └── mcp.json        # Workspace 전용 MCP
├── hooks/
├── agents/
└── skills/

IDE 시작하기

다운로드부터 첫 프로젝트까지 — 설치·로그인·화면 구성의 최단 경로

4단계로 시작하기

다운로드 → 설치 → 로그인 → 프로젝트 열기 — 마지막은 .kiro/를 Git에 커밋해 팀과 규칙 공유

1. 1
   다운로드

   • kiro.dev에서 OS별 설치 파일 다운로드
   • macOS: .dmg / Windows: .exe / Linux: .AppImage
   • 독립 IDE — Code OSS 기반 (VS Code 확장 설치 아님)
2. 2
   설치

   • 다운로드한 파일 실행 → 기본 설정 완료
   • 확장은 Open VSX 레지스트리 사용
   • 기존 VS Code 확장 대부분 호환 (Code OSS 기반)
3. 3
   로그인

   • GitHub · Google · AWS Builder ID · IAM Identity Center 중 선택
   • 별도 AWS 계정 불필요 — 모델 접근은 Kiro 서비스가 제공
   • Free 티어로도 즉시 시작 — 월 기본 크레딧 제공
4. 4
   프로젝트 열기

   • File > Open Folder로 프로젝트 디렉토리 선택
   • .kiro/ 디렉토리가 있으면 설정 자동 로드
   • 없으면 첫 Vibe 세션 시작 시 자동 생성
   • Git 커밋하여 팀 전원에게 규칙 공유

Kiro IDE 화면 구성

설치 후 처음 보는 화면 — 각 영역의 역할

기능 체계

두 세션 모드(Vibe·Spec) 위에 겹쳐 동작하는 Steering·Hooks·Skills·MCP — 배타 분류가 아닌 조합 장치

핵심 기능 체계

Vibe·Spec 세션이 뼈대, Steering·Hooks·Skills·MCP가 그 위의 제어판

1. 1
   Vibe 세션

   • 자연어 대화로 즉시 코드 생성
   • 빠른 반복 — 프로토타이핑, 버그 수정
   • Autopilot/Supervised로 자율성 제어
2. 2
   Spec 세션

   • Requirements → Design → Tasks 3단계
   • 검토/승인 게이트로 품질 보장
   • 프로덕션 코드, 팀 협업에 적합
3. 3
   Steering

   • 마크다운 규칙 (.kiro/steering/*.md)
   • AI가 코드 생성 시 항상 참조하는 표준
   • fileMatch 패턴으로 파일별 선택 적용
4. 4
   Hooks

   • JSON 이벤트 자동화 (.kiro/hooks/ · 전역 ~/.kiro/hooks/)
   • 파일 저장/생성 시 린트, 테스트 실행
   • 자연어로 Hook JSON 자동 생성 가능
5. 5
   Skills

   • 키워드 매칭 JIT 지식 (.kiro/skills/)
   • 필요할 때만 컨텍스트 로딩 — 토큰 절약
   • 도메인 가이드, API 레퍼런스, 패턴
6. 6
   MCP

   • 외부 도구 연결 프로토콜
   • stdio(로컬) + streamable-http(원격)
   • Powers = MCP + Steering + 문서 패키지

Agent Focus 모드

채팅 중심 레이아웃 + 멀티에이전트 병렬 실행 (실험적)

상황별 기능 선택 가이드

예 / 아니오 질문에 답하며 첫 장치를 고르는 의사결정 흐름

Vibe 세션

자연어 요청에서 코드까지 — 빠른 반복 루프와 그 위의 안전판

Vibe 워크플로우

대화하듯 코드를 만드는 흐름

1. 1
   요청

   • 채팅에 자연어로 원하는 기능 설명
   • "로그인 페이지 만들어줘", "이 버그 고쳐줘"
   • 파일을 드래그하거나 #file로 컨텍스트 지정 가능
2. 2
   생성

   • AI가 즉시 코드를 생성하고 파일 생성/수정
   • Autopilot이면 자동 적용
   • Supervised면 변경 사항을 미리 보여줌
   • Permissions로 파일 쓰기/셸 실행 능력별 제어
3. 3
   확인

   • 생성된 코드를 에디터에서 확인
   • Accept(적용) / Reject(거부) / View changes(차이 보기)
   • 추가 요청으로 수정 가능
4. 4
   반복

   • "에러 처리 추가해줘", "스타일 바꿔줘" 등 반복
   • 빠른 피드백 루프로 원하는 결과까지 도달
   • Checkpoint로 언제든 이전 상태로 복원 가능

실행 모드 선택

즉시 적용하는 Autopilot vs 승인 후 적용하는 Supervised — 기준은 실패 비용

Permissions — 능력별 권한 제어

Autopilot/Supervised 위에 겹쳐 적용하는 추가 보호 레이어 — Vibe에서 알아둘 것만

capability 14종

fs_read · fs_write · shell · web_fetch · web_search · mcp · subagent · skill · power · diagnostics · context 등 — 능력 단위 개별 승인 정책

deny > ask > allow

permissions.yaml의 규칙 우선순위 — deny된 능력은 Autopilot이든 Supervised든 사용 불가

Vibe 기본값

읽기는 allow, 쓰기·셸·MCP는 ask — 빠른 생성 중에도 파괴적 동작은 확인을 거침

Vibe 세션 프롬프트 예시

효과적인 Vibe 요청 작성법 — 요청 한 문단이 코드가 되는 실제 흐름

Spec 세션

요구사항에서 태스크까지 — 승인 게이트로 지키는 체계적 설계 흐름

Spec 3단계 워크플로우

Requirements → Design → Tasks — 단계마다 승인 게이트를 통과하는 흐름

1. 1
   Requirements

   • 사용자가 기능 설명 → AI가 요구사항 정형화
   • 모호한 표현을 구체적 스펙으로 변환
   • 승인 게이트 — 확인 후 다음 단계 진행
2. 2
   Design

   • 승인된 요구사항 기반 아키텍처 설계 생성
   • 파일 구조, API 인터페이스, 데이터 모델 정의
   • 승인 게이트 — 설계 검토 후 구현 시작
3. 3
   Tasks

   • 설계를 실행 가능한 태스크 목록으로 분해
   • Run all Tasks로 독립 태스크 병렬 실행
   • 각 태스크 완료 시 Hook 자동 실행 (테스트/린트)

5가지 워크플로우 모드

채팅 하단 워크플로우 드롭다운에서 선택

Vibe vs Spec 선택 기준

속도가 핵심이면 Vibe, 품질·협업이 핵심이면 Spec — 범위와 실패 비용이 가르는 선택