Java 가이드

Kiro와 함께 Java 프로젝트를 구성하고, 코드를 분석하고, 디버깅 효율을 높이는 방법을 정리합니다.

개요

Kiro는 Java 프로젝트의 코드 작성, 리팩터링, 디버깅 단계를 AI 보조로 가속합니다. Spring Boot, Maven, Gradle 같은 표준 도구 위에 자연스럽게 얹혀 동작하며, 반복적인 작업을 줄여 비즈니스 로직에 집중할 수 있게 해 줍니다.

사전 준비

확장 프로그램

Kiro는 Open VSX 마켓플레이스의 다음 확장을 지원합니다.

개발 환경 다루기

프로젝트 구성과 구조

Kiro에게 프로젝트 초기화부터 의뢰할 수 있습니다. 예를 들어 “JUnit 5와 Mockito가 포함된 Gradle 프로젝트 생성”, “멀티 모듈 Maven 프로젝트 골격 구성” 같이 자연어로 지시하면 디렉터리 구조와 빌드 파일까지 한꺼번에 만들어 줍니다.

코드 분석과 리팩터링

디버깅 보조

Steering

Kiro는 작업 시작 시 세 종류의 기본 steering 문서를 자동으로 생성합니다.

  1. Product brief (product.md)
  2. Technical Stack (tech.md)
  3. Project Structure (structure.md)

커스텀 steering 파일 만들기

  1. 사이드바에서 Kiro 뷰로 이동합니다.
  2. Agent Steering 섹션의 + 버튼을 클릭합니다.
  3. 제목을 입력합니다.
  4. 마크다운 형식으로 내용을 작성합니다.

생성된 파일은 .kiro/steering/ 아래에 보관됩니다.

프로젝트 컨벤션 정의

예시로 java-conventions.md를 만들어 다음과 같은 합의 사항을 적어 둘 수 있습니다.

팁. 들여쓰기, 줄바꿈처럼 기계적인 포매팅은 Checkstyle이나 Spotless 같은 자동화 도구에 맡기고, steering에는 사람이 합의해야 할 규칙만 적는 편이 효율적입니다.

프레임워크별 가이드

spring-boot-patterns.md 같은 파일을 따로 두어 Spring Boot 관행을 명시할 수 있습니다.

Agent Hooks

Java 프로젝트에서 자주 쓰이는 hook 활용 사례입니다.

MCP 서버

Maven MCP Server

Kiro 설정에 다음 항목을 추가하면 Kiro가 Maven 명령을 직접 실행하고 빌드 이슈를 분석하며 의존성을 정리할 수 있습니다.

{
  "mcpServers": {
    "maven": {
      "command": "uvx",
      "args": ["maven-mcp-server@latest"]
    }
  }
}

더 많은 서버는 AWS MCP ServersAwesome MCP Servers에서 찾을 수 있습니다.

이슈 디버깅

코드 위에서 바로 Kiro에게 문의할 수 있는 세 가지 진입점이 있습니다.

  1. Inline Chat: Cmd/Ctrl + I
  2. Add to Chat: Cmd/Ctrl + L
  3. Quick Fix: 오류 또는 경고 위에 마우스를 올린 뒤 Quick fixAsk Kiro 선택
주의. Kiro가 제안한 수정은 적용 전에 반드시 직접 검토하세요. 특히 트랜잭션 경계, 예외 처리, 동시성 관련 코드는 의도치 않은 부작용이 발생할 수 있습니다.

참고 자료