Steering

학습 목표

Steering 파일의 개념과 역할 이해
프로젝트별 개발 표준 설정
자동 적용 확인

스티어링 주요 특징

스티어링(Steering)은 Kiro가 코드를 생성할 때 따라야 할 가이드라인을 정의하는 마크다운 파일입니다.

일관성 유지: 모든 코드가 동일한 스타일과 패턴을 따름
표준 자동화: 매번 설명하지 않아도 표준이 자동 적용
팀 협업: 팀 전체가 동일한 기준으로 개발

steering/ 주요 마크다운 파일


.kiro/
└── steering/
    ├── product.md
    ├── structure.md
    └── tech.md

product.md: 프로젝트의 목적과 기능을 설명합니다. Kiro가 요청사항을 이해할 때 전체적인 맥락을 파악하는 데 활용됩니다.
structure.md: 프로젝트 폴더 구조와 주요 구성 요소를 설명합니다. 원하는 파일의 위치를 빠르게 찾고 올바른 위치에서 작업할 수 있도록 지원합니다.
tech.md: 기술 스택과 도구를 설명합니다. 기존 기술을 유지하면서 일관된 개발 환경을 보장합니다.

steering/ 마크다운 내용


---
inclusion: always    # 항상 포함
---
 
---
inclusion: fileMatch # 특정 파일 패턴에만 적용
fileMatchPattern: "*.js"
---
 
---
inclusion: manual    # 수동으로 참조할 때만 적용
---


...
 
# 기존 파일 패턴 참조
 
#[[file:style.css]]
#[[file:script.js]]
 
...

스티어링 기능으로 To-Do 웹 사이트 개선하기

좌측 사이드바 > Kiro 패널(유령(👻) 아이콘) 선택
AGENT STEERING에서 Generate Steering Docs 선택
세션 창 Command에서 실행이 멈출 경우, 실행(▶) 아이콘을 계속 선택
Kiro가 자동으로 기본 파일(product / structure / tech) 생성
AGENT STEERING에서 추가(+) 아이콘 > todo-app agent steering을 선택합니다.
파일명 todo-app-standards.md를 입력하고 Enter로 커스텀 스티어링 파일을 생성합니다.
파일 내용을 복사해서 생성된 todo-app-standards.md에 붙여넣기하고 저장합니다.
아래 프롬프트를 복사한 후, Kiro 바이브 세션에 입력하여 추가 기능을 요청합니다.


할 일 추가 버튼 HTML을 만들어주세요.

아래 프롬프트를 복사한 후, Kiro 바이브 세션에 입력하여 스타일링을 요청합니다.


할 일 목록을 표시하는 CSS 클래스를 만들어주세요.

스티어링에서 지정한 CSS 표준이 자동 적용되었는지 확인합니다.

✅ 확인 사항:

BEM 방법론 적용 여부
CSS 변수 사용 여부
2칸 들여쓰기 적용 여부

아래 프롬프트를 복사한 후, Kiro 바이브 세션에 입력하여 함수 생성을 요청합니다.


할 일을 추가하는 JavaScript 함수를 만들어주세요.

스티어링에서 지정한 JavaScript 표준이 자동 적용되었는지 확인합니다.

✅ 확인 사항:

ES6+ 문법 사용
const/let 사용
함수명이 동사로 시작
한글 주석 포함