Kiro의 Steering 기능: 4가지 Inclusion 모드로 컨텍스트 관리

AWS의 Agentic IDE인 Kiro에는 Claude Code의 CLAUDE.md에 해당하는 'Steering'이라는 메커니즘이 있습니다. 다만 단순한 전체 내용 상시 로딩이 아니라, 4가지 종류의 로딩 모드를 활용할 수 있다는 점이 특징적이었습니다. 실제 설정 파일 작성 방법을 정리합니다.

# 항상 적용 (코딩 규약/언어 설정용)
---
inclusion: always
...

always는 세션 시작 시마다 전체 내용을 로드하므로, 코딩 규약이나 언어 설정 등 항상 지켜야 할 규칙에 적합합니다. fileMatch는 지정한 파일 패턴을 조작할 때만 로드되므로, 특정 기술 스택 전용의 규칙을 컨텍스트에 불필요하게 포함시키지 않아도 됩니다.

# 채팅에서 #파일명 이라고 입력했을 때만 로드
---
inclusion: manual
...

manual은 상시 로드되지 않기 때문에, 긴 가이드를 컨텍스트를 압박하지 않고 유지할 수 있습니다. auto는 name과 description이 필수이며, 사용자의 프롬프트가 description 내용에 일치했을 때만 자동으로 로드됩니다.

{
"name": "auto-test-on-save",
"trigger": "fileSave",
...
}

.kiro/hooks/에 이 JSON을 배치하면, 대상 파일 저장 시마다 AI 에이전트가 자동으로 백그라운드 작업을 실행합니다. 파일 저장·생성·삭제·프롬프트 전송·에이전트 턴 완료 등 대응하는 트리거 종류가 많아, Claude Code나 Codex CLI에서는 얻기 힘든 '저장만 하면 테스트가 자동 실행되는' 경험을 할 수 있습니다.

---
name: review-pr
description: 풀 리퀘스트의 코드 리뷰를 수행한다. 보안·성능·가독성의 관점에서 지적한다.
...

name은 소문자, 숫자, 하이픈만 사용하며 폴더명과 일치해야 하고, description은 최대 1024자로 스킬을 구동해야 할 상황을 명확하게 기술합니다. Claude Code의 커스텀 슬래시 명령어(.claude/commands/)는 파일명이 그대로 명령어명이 되지만, Kiro의 Skills는 name 필드에서 명시적으로 지정한다는 점에서 차이가 있습니다.

.kiro/specs/web-infra/
├── requirements.md ← EARS 표기법의 유저 스토리와 수용 조건
├── design.md ← 아키텍처 설계
...

'〇〇을 만들고 싶다'라고 전달하는 것만으로 Kiro가 이 3개 파일을 순서대로 자동 생성합니다. 특히 Requirements 단계에서 '이 수용 조건이 부족하다'라고 수정할 수 있다는 점은 구현 전 인식 맞추기(alignment)로서 기능합니다. 의존 관계가 없는 작업은 'Wave'로 그룹화되어 병렬 실행되므로, 여러 파일에 걸친 구현에서도 시간을 단축할 수 있습니다.

Steering의 inclusion 모드를 통한 컨텍스트의 ON/OFF 제어와, JSON 하나로 설정 가능한 Hook의 자동화가 Kiro만의 Agentic IDE 설계 포인트였습니다. SKILL.md의 형식 자체는 Claude Code와 거의 공통적이어서, 기존 커스텀 명령어 자산을 그대로 이전하기 쉬운 설계이기도 합니다.