결론

Kiro의 설정 파일(Steering)을 정비했더니, 같은 작업이 1/3의 시간 만에 끝나게 되었습니다.

구체적인 수치는 다음과 같습니다:

이 기사에서는 실제로 사용하고 있는 Steering 설정을 공개합니다.

전제: Kiro란

AWS 공식 AI 코딩 어시스턴트입니다. Claude를 탑재하고 있으며, VS Code 상에서 동작합니다.

특징은 "Steering"이라는 메커니즘입니다. .kiro/steering/에 둔 Markdown 파일이 AI를 향한 영구적인 지시가 됩니다.

Before: 무엇이 문제였나

Kiro에게 "작업을 진행해줘"라고 말하면 다음과 같이 됩니다:

나: 작업을 진행해 주세요
Kiro: 어떤 작업인가요?
나: 파일 편집입니다
...

매번 이런 확인 절차가 들어갑니다.

AI는 친절하게 확인해 주지만, 작업 효율은 최악입니다.

After: Steering으로 "질문 금지"로 설정

.kiro/steering/my-workflow.md를 작성했습니다:

---
inclusion: manual
---
...

포인트는 마지막 한 줄입니다.

"질문하지 말고, 추론하여 진행할 것"

이것을 쓰는 것만으로 AI의 움직임이 급변합니다.

실제 대화 (After)

나: #my-workflow 작업을 진행해 주세요
Kiro: (memo 폴더를 확인)
Kiro: (이전 진척도를 확인)
...

질문이 제로가 되었습니다.

Steering 작성법: 3가지 팁

1. "질문하지 마"를 명시하기

AI는 친절함 때문에 질문을 합니다. 그것을 멈추게 하려면 명시적으로 적어야 합니다.

## 작업 규칙
- 불명확한 점이 있어도 질문하지 말고, 추론하여 진행할 것
- 망설여지면 memo 폴더를 확인할 것
...

2. 파일 경로는 구체적으로

❌ 나쁜 예:

설정 파일을 확인한 후 작업

✅ 좋은 예:

`memo/memo.YYYYMMDD.md`에서 당일 작업을 확인

AI가 "어떤 파일인가요?"라고 묻는 이유는 경로가 모호하기 때문입니다.

3. inclusion: manual로 호출식으로

---
inclusion: manual
---

이것을 쓰면 채팅에서 #파일명이라고 입력하지 않으면 읽어오지 않습니다.

항상 읽어오는 설정(inclusion: auto)도 있지만, 작업별 지시는 manual이 좋습니다. 컨텍스트를 낭비하지 않습니다.

Steering의 예

user-preferences.md (auto)

---
inclusion: auto
---
...

my-workflow.md (manual)

---
inclusion: manual
---
...

자주 묻는 질문

Q. Claude Code의 CLAUDE.md와 무엇이 다른가요?

Claude Code는 CLAUDE.md 파일 하나에 전부 작성합니다.

Kiro는 여러 파일로 나눌 수 있으며, inclusion으로 읽어오는 타이밍을 제어할 수 있습니다.

작업별로 나누고 싶다면 Kiro의 Steering이 더 유연합니다.

Q. AI가 지시를 무시하는 경우가 있나요?

있습니다. 특히 채팅이 길어지면 잊어버리는 경우가 있습니다.

대책:

• 중요한 지시는 서두에 작성한다
• 작업마다 채팅을 리셋한다
• #파일명으로 명시적으로 재로드시킨다

Q. 어디까지 작성해야 하나요?

"매번 설명하고 있는 것"을 모두 작성해 주세요.

2번 이상 설명한 내용은 Steering에 작성해야 합니다.

요약

Kiro를 똑똑하게 사용하는 팁은 다음 3가지입니다:

"질문하지 말고 추론하라"를 명시하기
파일 경로는 구체적으로 적기
작업별로 Steering을 나누고, manual로 호출하기

이것만으로 작업 시간이 1/3로 줄어듭니다.

설정에 30분을 투자해도 일주일이면 본전을 뽑는 계산입니다.

아직 Steering을 작성하지 않았다면, 오늘부터 시작해 보세요.

Discussion