IDE 1.0 새 기능
IDE 1.0의 새 기능과 변경 사항, 그리고 0.x에서 이전하는 방법을 안내합니다.
IDE 1.0에는 새로운 권한 시스템, 구조화된 Hooks 형식, 그리고 실험적인 에이전트 중심 레이아웃이 도입되었습니다. 이 페이지에서는 무엇이 새로워졌고, 무엇이 바뀌었으며, 0.x에서 어떻게 이전하는지 다룹니다.
한눈에 보기
새로워진 내용과 업그레이드 후 해야 할 작업을 요약했습니다.
| 영역 | 새 기능 | 필요한 조치 |
|---|---|---|
| 권한 | 기능(capability) 기반 모델로 에이전트가 할 수 있는 작업을 제어 | 권한 설정 검토 |
| Custom Agents | 태그 기반 도구와 인라인 MCP를 갖춘 Markdown 기반 에이전트 프로필 | .kiro/agents/에 에이전트 생성 |
| Agent Focus Mode | 병렬 세션을 지원하는 에이전트 중심 레이아웃(실험적) | 오른쪽 상단 토글에서 활성화 |
| Dockable Chat | 채팅 세션을 전체 너비 에디터 탭으로 열기 | 채팅 탭 우클릭 → Open in Editor |
| 세션 내보내기 | 대화를 이식 가능한 zip 파일로 저장 | 채팅 탭 우클릭 → Export Chat |
| Hooks | 자연어 생성을 지원하는 구조화된 v1 JSON 형식 | 패널에서 기존 Hooks 이전 |
| 세션 | 성능 향상을 위한 개선된 저장 형식 | 세션별 또는 열 때 이전 |
권한
IDE 1.0은 기능 기반 권한 시스템을 통해 에이전트가 할 수 있는 작업을 명시적으로 제어합니다. 에이전트는 사용자가 명시적으로 허용하지 않은 작업을 수행하기 전에 승인을 요청합니다.
실제로는 다음과 같이 동작합니다.
- 1.0을 처음 사용할 때, 에이전트가 파일을 쓰거나 명령을 실행하거나 MCP 도구를 호출하려고 하면 동의 프롬프트가 표시됩니다
- 결정을 "항상 허용" 또는 "항상 거부" 규칙으로 유지할 수 있으며, 현재 워크스페이스 또는 모든 워크스페이스로 범위를 지정할 수 있습니다
- 별도 설정이 없어도 에이전트는 워크스페이스 파일을 읽고 읽기 전용 git 명령을 실행할 수 있으며, 그 외의 작업은 모두 프롬프트를 띄웁니다
기능, 패턴 문법, 설정 예시 등 전체 레퍼런스는 권한을 참고하세요.
Custom Agents
목적에 맞춘 에이전트를 Markdown 파일로 만들 수 있습니다. 간단한 태그(read, write, shell, web)로 에이전트가 접근할 수 있는 도구를 정의하고, MCP 서버와 권한 규칙을 인라인으로 포함하며, 버전 관리로 공유합니다. 저장하는 즉시 에이전트 선택기에 표시됩니다.
- 태그 기반 도구 — 개별 도구를 나열하는 대신
read,write,shell같은 태그로 기능을 선언합니다 - 인라인 MCP — MCP 서버 설정을 에이전트 프로필에 직접 번들합니다
- 인라인 권한 — 별도의 권한 파일 없이 에이전트가 할 수 있는 작업의 범위를 지정합니다
- 에이전트 선택기 — 대화 기록을 잃지 않고 채팅 입력 바에서 세션 도중 에이전트를 전환합니다
전체 형식과 예시는 Custom Agents를 참고하세요. 에이전트 전환에 대해서는 에이전트 전환을 참고하세요.
Dockable Chat
모든 채팅 세션을 전체 너비 에디터 탭으로 열어 더 넓은 읽기 공간과 유연한 레이아웃을 확보할 수 있습니다.
- 세션 탭 바에서 채팅 탭을 우클릭합니다
- Open in Editor를 선택합니다
이 탭은 분할, 드래그, 멀티 모니터 작업을 지원합니다. 패널이나 에디터 탭 어느 쪽에서 보낸 메시지든 동일한 세션에 전달됩니다. Dockable Chat을 참고하세요.
세션 내보내기
모든 대화를 이식 가능한 zip 파일로 저장하여 Kiro 외부에서 공유, 보관, 검토할 수 있습니다.
- 채팅 탭을 우클릭합니다
- Export Chat을 선택합니다
zip 파일에는 chat.md(Markdown 형식의 전체 대화)와 metadata.json(세션 메타데이터)이 포함됩니다. 내보낸 파일은 읽기 전용입니다. 세션 내보내기를 참고하세요.
Agent Focus Mode (실험적)
에이전트 대화를 중심에 두는 새로운 레이아웃입니다. 채팅이 메인 패널을 차지하고, 세션이 왼쪽에 정렬되며, Spec과 diff가 오른쪽 보조 패널에 표시됩니다.
주요 기능:
- 다중 패널 레이아웃 — 세션, 채팅, 보조 패널이 에이전트 작업에 맞게 구성됩니다
- 다중 병렬 세션 — 여러 에이전트를 서로 다른 작업에 독립적으로 실행합니다
- 워크플로 선택기 — 구조화된 워크플로(Spec, Plan, Bug Fix, Quick Spec) 또는 자유 형식으로 세션을 시작합니다
- 언제든 전환 — 오른쪽 상단의 버튼으로 Agent Focus Mode와 Editor View를 오갑니다
Agent Focus Mode에서는 Autopilot과 Supervised 모드를 모두 사용할 수 있습니다.
전체 안내는 Agent Focus Mode를 참고하세요.
Hooks
Hooks는 이제 .kiro/hooks/에 저장되는 구조화된 v1 JSON 형식을 사용합니다. 0.x의 레거시 Hooks는 Agent Hooks 패널에 업그레이드 배지와 함께 표시되며, 이전하기 전까지는 실행되지 않습니다.
Hooks 이전하기
Kiro 패널에서 Agent Hooks 섹션을 엽니다. 이전되지 않은 각 Hook에는 업그레이드 아이콘 배지가 표시됩니다. 배지를 클릭하면 Hook이 v1 형식으로 변환됩니다. 이전된 Hook은 즉시 활성화됩니다.
원본 레거시 파일은 디스크에 남아 있지만 더 이상 로드되지 않습니다.
1.0에서 Hooks 만들기
UI 생성 흐름이 변경되었습니다. Agent Hooks 패널에서 +를 클릭하면 두 가지 옵션이 나타납니다.
- Ask Kiro to create a hook — 원하는 내용을 자연어로 설명합니다
- Manually create a steering file —
.kiro/steering/에/<filename>슬래시 명령으로 호출되는 markdown 파일을 만듭니다
수동 Hooks(기존의 Manual 트리거)는 수동 steering 파일로 대체되었습니다. 0.x에서 수동 Hooks를 사용했다면 steering 파일로 이전됩니다. 형식과 기능은 Steering을 참고하세요.
v1 JSON 형식(.kiro/hooks/*.json)은 1.0에서 새로 도입된 것으로, 이전의 .hook 파일 형식을 대체합니다. 전체 레퍼런스는 Hooks를 참고하세요.
세션
IDE 1.0은 새로운 세션 저장 형식을 사용합니다. 0.x의 세션은 이전하기 전까지 세션 목록에 표시되지 않습니다. 이전된 세션이 하나도 없으면 채팅 패널이 세션 목록으로 열려 주의가 필요한 항목을 확인할 수 있습니다.
세션 이전하기
두 가지 방법이 있습니다.
- Migrate 클릭 — 이전되지 않은 각 세션은 세션 목록에 Migrate 버튼을 표시합니다
- 세션 열기 — 이전되지 않은 세션을 선택하면 자동으로 이전됩니다
마감 기한은 없습니다. 이전되지 않은 세션은 로컬에 그대로 저장되며 필요할 때 언제든 이전할 수 있습니다.
세션 이전 문제 해결
세션이 제대로 이전되지 않으면 세션 목록에서 해당 세션을 우클릭해 추가 옵션을 사용할 수 있습니다.
- Force Re-migrate — 이전을 처음부터 다시 실행합니다(첫 시도가 불완전한 결과를 냈을 때 유용)
- Show Migration Logs — 문제 진단에 도움이 되는 이전 로그를 엽니다
다운그레이드
0.x로 되돌려야 한다면 설치 페이지의 다운그레이드 안내를 참고하세요.