첫 프로젝트¶

이 가이드는 실제 프로젝트를 통해 Kiro의 필수 기능을 안내합니다. 스티어링 파일, 사양(Spec), 훅(Hook) 및 MCP 서버를 사용하여 개발 워크플로우를 향상시키는 방법을 배웁니다.

사전 요구사항¶

시작하기 전에 다음을 확인하세요:

Kiro를 설치했습니다.
작업할 프로젝트(기존 프로젝트 또는 새 프로젝트)가 있습니다
프로젝트 구조 및 기술 스택에 대한 기본적인 이해가 있습니다

프로젝트 열기¶

Kiro를 실행하고 프로젝트를 엽니다:
- File > Open Folder를 사용하여 프로젝트 디렉터리를 선택합니다
- 또는 프로젝트 폴더를 Kiro로 드래그 앤 드롭합니다
- 또는 명령줄로 이동하여 프로젝트 디렉터리에서 kiro .를 실행합니다
- Kiro 패널 액세스:
- 활동 표시줄(왼쪽 사이드바)에서 Kiro Ghost 아이콘을 클릭합니다
- 이 패널은 Kiro의 모든 AI 기반 기능에 대한 액세스를 제공합니다
- 채팅 세션 시작:
- 채팅 창이 기본적으로 열려 있어야 합니다
- AI와 상호 작용할 수 있는 Kiro의 대화형 인터페이스가 열립니다

스티어링 파일 설정¶

스티어링 파일은 프로젝트에 대한 컨텍스트를 제공하여 Kiro가 코드베이스, 규칙 및 요구 사항을 이해하는 데 도움을 줍니다.

시작하려면 Kiro 창에서 Generate Steering Docs를 선택합니다. Kiro는 .kiro/steering/에 저장된 프로젝트 스티어링 문서를 생성하여 Kiro의 동작을 안내합니다. 여기에는 다음에 대한 정보가 포함됩니다:

제품 및 목적
기술 스택 및 프레임워크
프로젝트 구조 및 규칙

스티어링 섹션에서 + 버튼을 클릭하여 코딩 표준, 워크플로우 및 팀 모범 사례와 같은 사항을 추가하여 사용자 지정 스티어링 파일을 만들 수도 있습니다. 스티어링에 대해 여기에서 자세히 알아보세요.

사양(Spec)으로 기능 구축¶

사양(Spec)은 상위 수준의 기능 아이디어를 세 가지 단계를 통해 상세한 구현 계획으로 변환합니다:

요구 사항(Requirements) - EARS 표기법의 수용 기준이 포함된 사용자 스토리
설계(Design) - 기술 아키텍처 및 구현 접근 방식
작업(Tasks) - 개별적이고 추적 가능한 구현 단계

첫 번째 사양 만들기¶

새 사양 시작:
- 채팅 세션에서 Spec 버튼을 클릭합니다
- Kiro 패널의 Specs 섹션에서 + 버튼을 선택합니다
- 기능 설명 입력:
- 자연어로 기능을 설명합니다
- 예: "로그인, 로그아웃 및 비밀번호 재설정 기능이 있는 사용자 인증 시스템 추가"
- 안내 워크플로우 따르기:
- 요구 사항 단계: Kiro는 EARS 표기법을 사용하여 요구 사항을 구조화하는 데 도움을 줍니다
- 설계 단계: 기술 아키텍처 및 컴포넌트 설계가 문서화됩니다
- 구현 단계: 실행을 위한 개별 작업이 생성됩니다

사양 작업 실행¶

사양이 완료되면:

tasks.md 파일에서 생성된 작업을 검토합니다
개별 작업 항목을 클릭하여 작업을 실행합니다
작업이 자동으로 "진행 중" 및 "완료"로 업데이트되면서 진행 상황을 추적합니다

hooks

훅(Hook)으로 워크플로우 자동화¶

에이전트 훅(Hook)은 다음과 같은 경우 미리 정의된 작업을 자동으로 실행하여 수동 작업을 제거합니다:

파일이 생성, 저장 또는 삭제될 때
수동 트리거가 활성화될 때
특정 파일 패턴이 수정될 때

시작하려면:

훅 생성 액세스:
- Kiro 패널의 Agent Hooks 섹션으로 이동합니다
- + 버튼을 클릭하여 새 훅을 만듭니다
- 훅 동작 정의:
- 자연어로 자동화하려는 내용을 설명합니다
- 예: "React 컴포넌트 파일을 저장할 때 해당 테스트 파일을 자동으로 생성하거나 업데이트합니다"
- 훅 설정 구성:
- 이벤트 유형: File Created, File Saved, File Deleted 또는 Manual Trigger 중에서 선택합니다
- 파일 패턴: 훅을 트리거해야 하는 파일을 지정합니다(예: src/**/*.tsx)
- 지침: 수행할 특정 작업을 정의합니다

hooks

MCP로 기능 확장¶

모델 컨텍스트 프로토콜(MCP)을 통해 Kiro는 다음을 수행할 수 있습니다:

전문 지식 베이스 및 문서에 액세스
외부 API 및 서비스와 통합
도메인별 도구 및 유틸리티 사용
데이터베이스 및 클라우드 서비스에 연결

MCP 설정¶

활동 표시줄에서 Kiro Ghost 아이콘을 클릭하여 Kiro 패널을 엽니다. 먼저 MCP를 활성화한 다음 패널에서 MCP 옆에 있는 편집 버튼(연필 아이콘)을 클릭합니다
기본적으로 Kiro는 JSON 파일에 fetch MCP 서버와 함께 제공됩니다. 연결하려면 disabled=false로 전환합니다.
Kiro에게 새 서버를 추가하도록 요청하거나 JSON 파일을 직접 편집하여 MCP 서버를 추가할 수도 있습니다:

json

{ "mcpServers": { "web-search": { "command": "uvx", "args": ["mcp-server-brave-search"], "env": { "BRAVE_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": ["search"] } } }

MCP 도구 사용¶

구성이 완료되면 여러 가지 방법으로 MCP 도구를 사용할 수 있습니다:

직접 질문
- MCP 서버의 기능을 활용하는 질문을 합니다:
- 예: 최신 React 18 모범 사례 검색
명시적 도구 사용
- MCP 컨텍스트 제공자로 특정 MCP 도구를 참조합니다¶
- 예: #[fetch] fetch 웹 검색을 사용하여 TypeScript 제네릭 제약 조건의 예제를 찾습니다`
다른 기능과 통합
- MCP를 훅 및 사양과 결합합니다:
- 예: 새 컴포넌트 파일을 만들 때 웹 검색 MCP를 사용하여 관련 문서를 찾는 훅을 만듭니다

다음 단계¶

이제 Kiro의 핵심 기능을 경험했습니다:

인터랙티브 튜토리얼 시도: 실습 게임 개발 튜토리얼을 진행하세요
사양에 대해 자세히 알아보기: 사양 문서에서 개념 및 작동 방식에 대해 자세히 알아보세요
커뮤니티에 참여: Discord 서버에서 다른 Kiro 사용자와 연결하고 경험을 공유하세요