Kiro

Kiro 사용자 가이드

rayplant

— 7 min read
Kiro 사용자 가이드

개요

Kiro는 프로토타입부터 프로덕션까지 개발자를 지원하는 에이전틱 IDE(통합 개발 환경)로, AWS에서 개발했으며, VS Code 기반의 독립적인 도구입니다. 이 가이드는 Kiro의 공식 문서(https://kiro.dev/docs/getting-started/)를 기반으로 Kiro를 설치하고, 설정하며, 첫 프로젝트를 시작하는 방법을 안내합니다. Kiro는 현재 공개 프리뷰 단계로, 기능과 문서가 개선될 수 있습니다.

Kiro는 스펙 기반 개발(spec-driven development)을 통해 AI와 협업하여 명확한 요구사항, 체계적인 설계, 그리고 작업 단위로 소프트웨어를 구축할 수 있도록 돕습니다. 주요 기능으로는 스펙 작성, 스티어링 파일, 훅(hooks), 그리고 MCP(Model Context Protocol) 서버 통합이 포함됩니다. 이 가이드를 통해 5분 이내에 Kiro를 시작할 수 있습니다.

설치 방법

Kiro를 설치하고 설정하는 과정은 간단하며, 다음 단계를 따릅니다.

  1. Amazon Kiro 설치 (Windows Package Manager - winget)

    • Windows 환경에서 Amazon Kiro 앱을 설치하려면 다음 명령어를 명령 프롬프트 (CMD) 또는 PowerShell에 복사해서 실행하세요.

    winget install --id=Amazon.Kiro -e

  2. 최초 실행 및 로그인:

    • Kiro를 처음 실행하면 로그인 옵션이 표시됩니다. 지원되는 인증 방법은 다음과 같습니다:
    • GitHub: GitHub 계정으로 로그인.
    • Google: Google 계정으로 로그인.
    • AWS Builder ID: 개인 개발자를 위한 빠른 설정.
    • AWS IAM Identity Center: Amazon Q Dev Pro 구독이 있는 경우 기업용 인증.
    • AWS 계정 없이도 Kiro를 즉시 사용할 수 있습니다.

  3. 설정 가져오기:

    • VS Code 사용자라면 기존 설정과 확장 프로그램을 가져올 수 있습니다. 다른 에디터를 사용하는 경우 이 단계를 건너뛸 수 있습니다.
    • 원하는 테마를 선택하고, Kiro가 명령을 실행할 수 있도록 셸 통합을 설정합니다.

  4. 환영 페이지:

    • 설정 완료 후 환영 페이지가 표시됩니다. 여기서 새 프로젝트를 생성하거나 기존 프로젝트를 열 수 있습니다.

첫 프로젝트 시작하기

Kiro는 새로운 프로젝트나 기존 프로젝트 모두에서 작동합니다. 첫 프로젝트를 시작하는 방법은 다음과 같습니다.

  1. 프로젝트 열기:

    • Kiro에서 프로젝트 디렉토리를 열거나, 터미널에서 프로젝트 디렉토리로 이동한 후 kiro . 명령을 실행합니다.
    • Kiro는 대부분의 인기 프로그래밍 언어를 지원합니다.

  2. 스티어링 파일 생성:

    • 스티어링 파일은 프로젝트의 구조, 기술 스택, 코딩 표준 등 Kiro가 프로젝트를 이해하는 데 필요한 컨텍스트를 제공합니다.
    • Kiro 패널에서 Generate Steering Docs를 선택하면 .kiro/steering/ 디렉토리에 product, structure, tech라는 세 개의 마크다운 파일이 생성됩니다.
    • 필요에 따라 이 파일들을 편집하거나, Kiro 패널의 + 버튼을 눌러 사용자 지정 스티어링 파일을 추가할 수 있습니다(예: 코딩 표준, 워크플로우, 팀 모범 사례).

  3. 스펙 작성:

    • 스펙은 복잡한 기능을 요구사항, 설계, 구현 작업으로 나누는 구조화된 아티팩트입니다.
    • Kiro 패널에서 + 버튼을 클릭하거나 채팅 패널에서 Spec 옵션을 선택하여 새 스펙을 생성합니다.
    • 프로젝트 아이디어를 설명하면 Kiro가 다음 세 단계 워크플로우를 안내합니다:
      • 요구사항: 사용자 스토리와 수락 기준을 포함한 요구사항 문서(requirements.md) 생성.
      • 설계: 기술 스택, 아키텍처, 시퀀스 다이어그램을 포함한 설계 문서(design.md) 작성.
      • 구현: 작업 목록(tasks.md)을 생성하여 구현 단계를 추적.
    • 예: “내 퀴즈 앱에 소셜 로그인 추가”와 같은 설명으로 시작하면, Kiro가 요구사항을 생성하고, 이를 기반으로 설계 문서와 작업 목록을 만듭니다.

  4. 훅 설정:

    • 훅은 파일 저장, 생성, 삭제 등의 이벤트에 따라 자동으로 작업을 실행하는 에이전트 기반 자동화입니다.
    • 예: 새 React 컴포넌트가 생성될 때 단일 책임 원칙(Single Responsibility Principle)을 확인하는 훅을 설정할 수 있습니다. 이를 위해 Kiro는 최적화된 시스템 프롬프트를 생성하고, Git에 커밋하면 팀 전체에 코딩 표준을 적용합니다.

  5. MCP 서버 통합:

    • MCP(Model Context Protocol)를 통해 외부 도구와 데이터 소스를 연결할 수 있습니다. 예: AWS 문서 MCP 서버를 통해 AWS 문서를 검색하거나 추천받을 수 있습니다.
    • MCP 설정은 작업 공간 또는 사용자 수준에서 JSON 파일로 구성됩니다. 예시:
      {
  "mcpServers": {
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": { "FASTMCP_LOG_LEVEL": "ERROR" },
      "disabled": false,
      "autoApprove": []
    }
  }
}
    • 작업 공간 수준: .kiro/settings/mcp.json
    • 사용자 수준: ~/.kiro/settings/mcp.json

Kiro의 핵심 기능

Kiro는 다음과 같은 기능을 통해 개발 워크플로우를 향상시킵니다.

  • 스펙 기반 개발: 요구사항을 명확한 문서로 변환하고, 이를 설계 및 작업으로 세분화하여 AI 에이전트가 구현하도록 안내합니다.
  • 스티어링: 프로젝트별 규칙과 컨텍스트를 정의하여 AI의 동작을 사용자 지정합니다.
  • 훅: 반복 작업(예: 문서 업데이트, 단위 테스트 생성)을 자동화합니다.
  • 에이전틱 채팅: 프로젝트 컨텍스트를 이해하는 AI와 자연스러운 대화를 통해 기능을 개발합니다.
  • MCP 통합: 외부 도구 및 데이터를 연결하여 Kiro의 기능을 확장합니다.
  • 보안: AWS의 보안 인프라를 기반으로 데이터 암호화 및 TLS 1.2 이상의 통신을 제공합니다.
  • VS Code 호환성: 기존 VS Code 설정과 Open VSX 플러그인을 가져와 익숙한 환경을 제공합니다.

학습 자료

Kiro는 실습 중심의 학습을 제공합니다. 다음 리소스를 활용하세요:

  • Learn by Playing: 샘플 비디오 게임(Spirit of Kiro)의 챌린지 브랜치를 통해 Kiro의 기능을 배웁니다. 이 게임은 95%가 Kiro로 작성된 코드로 구성되어 있으며, 버그 수정 및 기능 추가를 통해 학습할 수 있습니다.
  • 가이드 및 튜토리얼: React, Python, Go 등 프레임워크별 가이드와 실습 튜토리얼을 제공합니다.
  • 커뮤니티: GitHub 저장소(github.com/kirodotdev/Kiro) 또는 Discord 서버에서 피드백을 공유하고 지원을 받을 수 있습니다.

요약

Kiro는 AI 에이전트를 활용하여 개발 프로세스를 간소화하고, 스펙 기반 개발로 명확성과 유지보수성을 높이는 강력한 IDE입니다. 설치 및 설정은 간단하며, 스티어링 파일, 스펙, 훅, MCP 통합을 통해 프로젝트를 효율적으로 관리할 수 있습니다. 무료 프리뷰 기간 동안 Kiro를 다운로드하여 실제 프로젝트에 적용해보고, GitHub 또는 Discord를 통해 피드백을 공유하세요!

Read more