Codebase Indexing

Kiro는 워크스페이스의 코드와 문서를 자동으로 색인하여, 코드 제안·탐색·문맥 인지형 어시스턴스가 항상 최신 상태에서 동작하도록 만듭니다.

색인이란 무엇인가

Codebase Indexing은 프로젝트에 포함된 소스 파일과 문서, 설정, 의존성 정의를 분석해 검색 가능한 형태로 저장해 두는 과정입니다. 이 인덱스가 있어야 Kiro가 파일 간 관계를 이해하고, 적절한 자동 완성과 리팩터링 제안을 내놓을 수 있습니다.

언제 색인이 동작하는가

자동 색인

다음 세 가지 상황에서 Kiro는 별도 조작 없이 색인을 시작합니다.

1. 프로젝트를 처음 열 때: Kiro에서 워크스페이스를 새로 열면 모든 파일에 대한 초기 색인이 자동으로 시작됩니다.
2. 파일 변경 감지: 새 파일을 추가하거나 기존 파일을 편집하면 해당 파일만 점진적으로 다시 색인됩니다.
3. 외부 변경 반영: git pull이나 외부 에디터 등 Kiro 밖에서 일어난 변경도 감지해 재색인합니다.

수동 색인

인덱스가 손상되었다고 의심되거나 대규모 구조 변경 직후라면 Command Palette에서 직접 색인을 트리거할 수 있습니다. Cmd+Shift+P(macOS) 또는 Ctrl+Shift+P(Windows/Linux)로 팔레트를 연 뒤 색인 관련 명령을 실행합니다.

사용 가능한 색인 명령

코드베이스 색인

• Kiro: Codebase Force Re-Index — 전체 코드베이스를 강제로 다시 색인합니다. 인덱스가 불완전해 보이거나, 큰 폴더 구조 변경이 일어났거나, 제안 결과가 과거 코드 기준으로 나올 때 사용합니다.
• Kiro: Rebuild codebase index — 인덱스를 처음부터 새로 만듭니다. Force Re-Index보다 더 철저한 작업으로, 인덱스가 심하게 손상된 경우나 탐색·제안 기능에 지속적인 문제가 있을 때 적합합니다.

문서 색인

• Kiro: Docs Index — Markdown, MDX 등 문서 파일에 대한 색인을 시작합니다.
• Kiro: Docs Force Re-Index — 모든 문서를 강제로 다시 색인합니다.

색인 진행 상황 확인

1. Kiro에서 Output 패널을 엽니다.
2. 드롭다운에서 Kiro Logs를 선택합니다.
3. 실시간으로 갱신되는 진행 메시지를 확인합니다.

로그에는 색인 시작/종료 시각, 처리한 파일 수, 대규모 코드베이스의 진행률, 각 작업 완료 시간이 함께 출력됩니다.

색인 대상

• Source Code: 워크스페이스에 포함된 모든 프로그래밍 언어 소스 파일
• Documentation: Markdown, MDX 등 문서 포맷
• Configuration: 프로젝트 설정 파일과 매니페스트
• Dependencies: 패키지 정의와 의존성 정보

색인이 켜져 있을 때 활용되는 기능

• 지능형 코드 자동 완성
• 파일 간 심볼·정의 탐색
• 문맥을 이해한 채팅 응답과 제안
• 문서에서 관련 내용 즉시 조회
• 리팩터링 보조