멀티 루트 워크스페이스¶
일반적인 Kiro 작업 공간에는 단일 "루트" 폴더가 포함됩니다(예: /users/bob/my-project). 그러나 Kiro는 여러 루트를 포함하는 작업 공간도 지원합니다(예: /users/bob/my-project 및 /shared/utils/crypto를 최상위 폴더로 포함하는 단일 작업 공간).
File > Add Folder to Workspace...를 사용하고 다른 폴더를 선택하거나 OS X Finder 또는 Windows File Explorer에서 다른 폴더를 Kiro의 Explorer 뷰로 드래그 앤 드롭하여 단일 루트 작업 공간에서 멀티 루트 작업 공간을 만들 수 있습니다.
단일 루트 작업 공간의 경우 Kiro는 사양(Spec), 스티어링 파일, 훅 등과 같은 아티팩트를 해당 단일 루트 아래의 .kiro 하위 폴더(예: /users/bob/my-project/.kiro)에 저장하고 검색합니다. 멀티 루트 작업 공간의 경우 Kiro는 각 루트 폴더 아래의 .kiro 하위 폴더에서 이러한 아티팩트를 저장하고 검색하는 것을 지원합니다. 멀티 루트 작업 공간 시나리오에서 Kiro의 정확한 동작은 아래에 설명되어 있습니다.
핵심 기능¶
Kiro는 멀티 루트 작업 공간을 탐색하고 업데이트할 때 루트 폴더 간에 파일 경로를 지능적으로 해결합니다.
코드베이스 인덱싱 및 Repository Maps는 멀티 루트 작업 공간에서 원활하게 작동합니다. 두 인덱스 모두 모든 루트 폴더의 코드를 포함하며 단일 루트 작업 공간 시나리오와 똑같이 프롬프트에서 참조할 수 있습니다.
#file 컨텍스트 제공자를 사용하여 컨텍스트에 파일을 추가할 때 다른 루트 폴더에 동일한 이름의 파일이 여러 개 있는 모호한 경우 Kiro는 경로와 함께 일치하는 파일 목록을 표시하여 올바른 파일을 선택할 수 있도록 합니다.
사양(Specs)¶
Kiro는 각 루트 폴더 아래의 .kiro 하위 폴더에서 모든 사양(spec) 파일을 검색하고 Kiro 패널의 Specs 섹션에 통합 목록으로 표시합니다. 포함하는 루트 폴더의 이름이 각 사양 옆에 표시됩니다.
Kiro에게 루트 폴더 중 하나에 정의된 사양에 대해 작업하도록 요청할 수 있습니다. 새 사양을 만들 때 Kiro는 사양을 배치할 적절한 루트 폴더를 결정합니다.
스티어링 파일¶
Kiro는 각 루트 폴더 아래의 .kiro 하위 폴더에서 모든 스티어링 파일을 검색하고 Kiro 패널의 Agent Steering 섹션의 Workspace 그룹 아래에 통합 목록으로 표시합니다. 포함하는 루트 폴더의 이름이 각 작업 공간 스티어링 파일 옆에 표시됩니다.
"Always Included" 지시문이 있는 스티어링 파일은 에이전트가 작업 중인 특정 루트 폴더에 관계없이 항상 로드됩니다. 그러나 "Conditional Inclusion" 지시문이 있는 파일은 에이전트가 동일한 루트에 정의된 파일에서 작업하는 경우에만 로드됩니다(물론 파일이 포함 패턴과 일치하는 경우).
새 작업 공간 스티어링 파일을 만들 때 스티어링 파일을 저장할 루트 폴더를 선택하라는 메시지가 표시됩니다.
훅(Hooks)¶
Kiro는 각 루트 폴더 아래의 .kiro 하위 폴더에서 모든 훅을 검색하고 Kiro 패널의 Agent Hooks 섹션 내에 통합 목록으로 표시합니다. 포함하는 루트 폴더의 이름이 각 훅 옆에 표시됩니다.
훅(File Create, File Save 및 File Delete)은 에이전트가 훅이 정의된 동일한 루트 폴더에 있는 파일을 수정할 때만 트리거됩니다.
새 훅을 만들 때 훅을 저장할 루트 폴더를 선택하라는 메시지가 표시됩니다.
MCP 서버¶
Kiro는 각 루트 폴더 아래의 .kiro 하위 폴더에서 모든 MCP 서버 정의를 검색하고 Kiro 패널의 MCP Servers 섹션에 통합 목록으로 표시합니다.
모든 루트에 정의된 모든 MCP 서버는 시작 시 초기화됩니다. 두 루트 폴더가 동일한 이름의 MCP 서버를 정의하는 경우 마지막으로 정의하는 루트의 서버 정의가 사용됩니다. 서버는 서버가 정의된 루트 폴더에 관계없이 첫 번째 루트 폴더를 현재 작업 디렉터리로 시작됩니다.
Kiro 패널의 MCP Servers 섹션에서 Open MCP config 버튼을 클릭하면 기본적으로 사용자 수준(전역) MCP 구성 파일이 표시되며 Workspace Config 버튼을 클릭하여 작업 공간 수준 구성을 볼 수 있습니다. 멀티 루트 작업 공간에서 해당 버튼을 클릭하면 MCP 구성을 볼 루트 폴더를 선택하라는 메시지가 표시됩니다.