Ch8. Autopilot 모드 활용

Kiro Autopilot의 자율 실행 범위, 감독 모드 전환, 승인 기준, 장시간 자동화 리스크를 팀 운영 관점에서 정리합니다.

핵심 요약

Autopilot은 사용자 승인 없이 자율 실행하는 모드입니다. 중요한 변경은 단계별로 승인받는 Supervised와 구분해 씁니다.
.kiro/settings/config.json에서 maxActions·timeoutMinutes·maxFilesPerAction으로 실행 범위를 제한합니다.
allowedPaths/restrictedPaths로 src/**만 허용하고 node_modules·.git·.env*를 보호합니다.
allowFileDeletion: false와 restrictedCommands(rm -rf·sudo·curl)로 위험 작업을 차단합니다.
무한 루프는 detectInfiniteLoop·maxRetries로, 실패는 onError: pause·rollbackOnFailure로 복구합니다.

Autopilot 모드는 Kiro가 사용자 승인 없이 자율적으로 작업을 수행하는 모드입니다. 복잡한 작업을 연달아 실행하거나 반복 작업을 자동화할 때 쓸모가 있습니다.

Claude Opus 4.6 + Autopilot (2026-02~)

Autopilot에서 Claude Opus 4.6을 쓰면 계획이 더 신중해지고 장시간 태스크가 안정적으로 돌아가며, 대규모 코드베이스에서 스스로 코드를 리뷰하고 디버깅하는 성능도 크게 좋아집니다. Pro, Pro+, Power 플랜에서 사용 가능합니다.

실행 모드 비교

모드	승인 방식	적합한 작업	안전성
Supervised	단계별 승인	중요한 변경, 학습 단계	높음
Autopilot	자율 실행	반복 작업, 복잡한 워크플로우	중간

Autopilot 모드 활성화

VS Code에서 모드 전환

Ctrl/Cmd + Shift + P
> Kiro: Switch to Autopilot Mode
> Kiro: Switch to Supervised Mode

설정 파일로 기본 모드 지정

// .kiro/settings/config.json
{
  "defaultMode": "autopilot",
  "autopilotSettings": {
    "maxActions": 50,
    "timeoutMinutes": 30,
    "allowFileCreation": true,
    "allowFileModification": true,
    "allowCommandExecution": true,
    "restrictedPaths": ["node_modules", ".git"],
    "autoSave": true
  }
}

Autopilot 안전 장치

1. 액션 제한

{
  "autopilotSettings": {
    "maxActions": 50,           // 최대 실행 가능한 액션 수
    "timeoutMinutes": 30,       // 최대 실행 시간
    "maxFileSize": "10MB",      // 수정 가능한 최대 파일 크기
    "maxFilesPerAction": 10     // 한 번에 수정 가능한 파일 수
  }
}

2. 경로 제한

{
  "autopilotSettings": {
    "allowedPaths": [
      "src/**",
      "docs/**", 
      "tests/**"
    ],
    "restrictedPaths": [
      "node_modules/**",
      ".git/**",
      "dist/**",
      "build/**",
      ".env*"
    ]
  }
}

3. 작업 유형 제한

{
  "autopilotSettings": {
    "allowFileCreation": true,
    "allowFileModification": true, 
    "allowFileDeletion": false,     // 파일 삭제 금지
    "allowCommandExecution": true,
    "allowNetworkAccess": false,    // 네트워크 접근 금지
    "restrictedCommands": [
      "rm -rf",
      "sudo",
      "curl",
      "wget"
    ]
  }
}

Autopilot 워크플로우 패턴

1. 기능 개발 자동화

"사용자 프로필 편집 기능을 구현해주세요. 
다음 단계를 자동으로 수행해주세요:

1. 백엔드 API 엔드포인트 구현
2. 프론트엔드 컴포넌트 작성  
3. 단위 테스트 추가
4. 통합 테스트 작성
5. 문서 업데이트"

Autopilot이 자동으로:

API 라우트 파일 생성
데이터베이스 스키마 업데이트
React 컴포넌트 구현
테스트 케이스 작성
README 문서 업데이트

2. 리팩토링 자동화

"레거시 클래스 컴포넌트들을 함수형 컴포넌트로 
자동 변환해주세요. Hooks를 적절히 사용하고 
기존 기능은 그대로 유지해주세요."

Autopilot이 자동으로:

클래스 컴포넌트 식별
함수형 컴포넌트로 변환
useState, useEffect 등 적절한 Hooks 적용
테스트 코드 업데이트

3. 코드 품질 개선

"전체 프로젝트의 코드 품질을 개선해주세요:

1. ESLint 규칙 위반 수정
2. TypeScript 타입 안전성 개선
3. 성능 최적화 기회 적용
4. 보안 취약점 수정
5. 코드 중복 제거"

서브에이전트와 Autopilot

Autopilot 모드에서는 서브에이전트를 붙여 작업을 병렬로 돌릴 수 있습니다.

병렬 개발 워크플로우

// 메인 에이전트가 자동으로 서브에이전트들을 조율
const parallelTasks = [
  {
    agent: "context-gatherer",
    task: "기존 인증 시스템 분석"
  },
  {
    agent: "general-task-execution", 
    task: "새로운 JWT 인증 구현"
  },
  {
    agent: "general-task-execution",
    task: "인증 관련 테스트 작성"
  }
];

// Autopilot이 자동으로 병렬 실행 및 결과 통합

단계적 워크플로우

"대규모 기능을 단계별로 구현해주세요:

Phase 1: 기반 구조 설계 및 구현
Phase 2: 핵심 비즈니스 로직 구현  
Phase 3: 사용자 인터페이스 구현
Phase 4: 테스트 및 문서화
Phase 5: 성능 최적화 및 배포 준비"

실시간 모니터링

진행 상황 추적

Autopilot이 도는 동안 진행 상황을 실시간으로 볼 수 있습니다:

현재 진행 상황:
✅ API 엔드포인트 구현 완료
🔄 프론트엔드 컴포넌트 작성 중...
⏳ 테스트 코드 작성 대기 중
⏳ 문서 업데이트 대기 중

실행된 액션: 15/50
경과 시간: 8분 23초

중간 중단 및 재개

Ctrl/Cmd + Shift + P
> Kiro: Pause Autopilot
> Kiro: Resume Autopilot  
> Kiro: Stop Autopilot

사후 검토 및 되돌리기

변경 사항 검토

Autopilot이 끝나면 바뀐 내용을 전부 검토할 수 있습니다:

## Autopilot 실행 결과

### 생성된 파일 (5개)
- src/api/profile.ts
- src/components/ProfileEditor.tsx  
- tests/profile.test.ts
- docs/api/profile.md
- types/profile.d.ts

### 수정된 파일 (3개)
- src/app.ts (라우트 추가)
- package.json (의존성 추가)
- README.md (문서 업데이트)

### 실행된 명령 (2개)
- npm install @types/multer
- npm run test

선택적 되돌리기

특정 변경사항만 되돌리기:
> Kiro: Revert File src/components/ProfileEditor.tsx
> Kiro: Revert All Changes
> Kiro: Keep Changes

Autopilot 모범 사례

1. 명확한 요구사항 정의

✅ 좋은 예:
"사용자 인증 시스템을 JWT 기반으로 구현해주세요. 
로그인, 회원가입, 토큰 갱신 기능이 필요하고,
Express.js와 TypeScript를 사용합니다."

❌ 나쁜 예:
"인증 기능 만들어주세요."

2. 안전 장치 설정

{
  "autopilotSettings": {
    "maxActions": 30,           // 적절한 제한 설정
    "allowFileDeletion": false, // 위험한 작업 비활성화
    "restrictedPaths": [        // 중요한 경로 보호
      ".env*",
      "node_modules/**",
      "dist/**"
    ]
  }
}

3. 점진적 접근

1단계: 작은 기능부터 Autopilot으로 테스트
2단계: 성공적인 패턴을 더 큰 작업에 적용
3단계: 팀 전체로 확산

4. 정기적인 검토

- 매주 Autopilot 실행 결과 검토
- 문제가 발생한 패턴 분석
- 안전 장치 설정 개선
- 팀 가이드라인 업데이트

문제 해결

무한 루프 방지

{
  "autopilotSettings": {
    "maxRetries": 3,
    "retryDelay": 5000,
    "detectInfiniteLoop": true
  }
}

리소스 사용량 제한

{
  "autopilotSettings": {
    "maxMemoryUsage": "2GB",
    "maxCpuUsage": 80,
    "pauseOnHighUsage": true
  }
}

에러 복구

{
  "autopilotSettings": {
    "onError": "pause",        // "continue", "stop", "pause"
    "createBackup": true,
    "rollbackOnFailure": true
  }
}

참고 문서

Kiro 공식 사이트: https://kiro.dev
Kiro 문서: https://kiro.dev/docs

고급 Autopilot 전략

🎯 스마트 배치 처리

복잡한 작업을 효율적으로 묶어 처리하는 전략:

{
  "autopilotSettings": {
    "batchSize": 5,
    "parallelTasks": 3,
    "priorityQueue": true,
    "smartRetry": {
      "maxRetries": 3,
      "backoffMultiplier": 2,
      "retryableErrors": ["timeout", "rate_limit"]
    }
  }
}

🔄 적응형 실행 전략

작업이 얼마나 복잡한지에 따라 전략을 자동으로 조정:

간단한 작업 (CRUD, 스타일링):
- 높은 자율성, 빠른 실행
- 최소한의 검증

복잡한 작업 (아키텍처 변경, 보안):
- 단계별 검증 포인트
- 상세한 로깅 및 백업

위험한 작업 (데이터베이스 마이그레이션):
- 자동 실행 비활성화
- 수동 승인 필수

🧠 컨텍스트 인식 자동화

프로젝트 상태와 히스토리를 함께 보고 똑똑하게 실행:

신규 프로젝트:
- 보수적 접근, 많은 설명과 문서화
- 베스트 프랙티스 우선 적용

성숙한 프로젝트:
- 기존 패턴 유지, 일관성 중시
- 점진적 개선 접근

레거시 프로젝트:
- 기존 코드 스타일 존중
- 최소한의 변경으로 목표 달성

🚀 실전 Autopilot 시나리오

대규모 리팩토링 자동화

"레거시 jQuery 코드를 React로 마이그레이션해주세요"

Autopilot 실행 계획:
1. 기존 코드 분석 및 컴포넌트 구조 설계
2. 공통 유틸리티 함수 추출
3. 페이지별 React 컴포넌트 생성
4. 상태 관리 로직 구현
5. 스타일링 마이그레이션
6. 테스트 코드 작성
7. 점진적 배포 계획 수립

예상 소요 시간: 3-5시간 (수동 작업 시 2-3주)

API 전체 재설계

"REST API를 GraphQL로 전환하고 성능을 최적화해주세요"

Autopilot 실행 과정:
1. 기존 REST 엔드포인트 분석
2. GraphQL 스키마 설계
3. Resolver 구현 및 데이터 로더 최적화
4. 인증/인가 미들웨어 적용
5. 캐싱 전략 구현
6. API 문서 자동 생성
7. 클라이언트 코드 업데이트
8. 성능 테스트 및 모니터링 설정

결과: API 응답 시간 50% 개선, 개발 생산성 3배 향상

핵심 요약

Autopilot은 사용자 승인 없이 자율 실행하는 모드입니다. 중요한 변경은 단계별로 승인받는 Supervised와 구분해 씁니다.
.kiro/settings/config.json에서 maxActions·timeoutMinutes·maxFilesPerAction으로 실행 범위를 제한합니다.
allowedPaths/restrictedPaths로 src/**만 허용하고 node_modules·.git·.env*를 보호합니다.
allowFileDeletion: false와 restrictedCommands(rm -rf·sudo·curl)로 위험 작업을 차단합니다.
무한 루프는 detectInfiniteLoop·maxRetries로, 실패는 onError: pause·rollbackOnFailure로 복구합니다.

Claude Opus 4.6 + Autopilot (2026-02~)

실행 모드 비교

모드	승인 방식	적합한 작업	안전성
Supervised	단계별 승인	중요한 변경, 학습 단계	높음
Autopilot	자율 실행	반복 작업, 복잡한 워크플로우	중간

Autopilot 모드 활성화

VS Code에서 모드 전환

Ctrl/Cmd + Shift + P
> Kiro: Switch to Autopilot Mode
> Kiro: Switch to Supervised Mode

설정 파일로 기본 모드 지정

// .kiro/settings/config.json
{
  "defaultMode": "autopilot",
  "autopilotSettings": {
    "maxActions": 50,
    "timeoutMinutes": 30,
    "allowFileCreation": true,
    "allowFileModification": true,
    "allowCommandExecution": true,
    "restrictedPaths": ["node_modules", ".git"],
    "autoSave": true
  }
}

Autopilot 안전 장치

1. 액션 제한

{
  "autopilotSettings": {
    "maxActions": 50,           // 최대 실행 가능한 액션 수
    "timeoutMinutes": 30,       // 최대 실행 시간
    "maxFileSize": "10MB",      // 수정 가능한 최대 파일 크기
    "maxFilesPerAction": 10     // 한 번에 수정 가능한 파일 수
  }
}

2. 경로 제한

{
  "autopilotSettings": {
    "allowedPaths": [
      "src/**",
      "docs/**", 
      "tests/**"
    ],
    "restrictedPaths": [
      "node_modules/**",
      ".git/**",
      "dist/**",
      "build/**",
      ".env*"
    ]
  }
}

3. 작업 유형 제한

{
  "autopilotSettings": {
    "allowFileCreation": true,
    "allowFileModification": true, 
    "allowFileDeletion": false,     // 파일 삭제 금지
    "allowCommandExecution": true,
    "allowNetworkAccess": false,    // 네트워크 접근 금지
    "restrictedCommands": [
      "rm -rf",
      "sudo",
      "curl",
      "wget"
    ]
  }
}

Autopilot 워크플로우 패턴

1. 기능 개발 자동화

"사용자 프로필 편집 기능을 구현해주세요. 
다음 단계를 자동으로 수행해주세요:

1. 백엔드 API 엔드포인트 구현
2. 프론트엔드 컴포넌트 작성  
3. 단위 테스트 추가
4. 통합 테스트 작성
5. 문서 업데이트"

Autopilot이 자동으로:

API 라우트 파일 생성
데이터베이스 스키마 업데이트
React 컴포넌트 구현
테스트 케이스 작성
README 문서 업데이트

2. 리팩토링 자동화

"레거시 클래스 컴포넌트들을 함수형 컴포넌트로 
자동 변환해주세요. Hooks를 적절히 사용하고 
기존 기능은 그대로 유지해주세요."

Autopilot이 자동으로:

클래스 컴포넌트 식별
함수형 컴포넌트로 변환
useState, useEffect 등 적절한 Hooks 적용
테스트 코드 업데이트

3. 코드 품질 개선

"전체 프로젝트의 코드 품질을 개선해주세요:

1. ESLint 규칙 위반 수정
2. TypeScript 타입 안전성 개선
3. 성능 최적화 기회 적용
4. 보안 취약점 수정
5. 코드 중복 제거"

서브에이전트와 Autopilot

Autopilot 모드에서는 서브에이전트를 붙여 작업을 병렬로 돌릴 수 있습니다.

병렬 개발 워크플로우

// 메인 에이전트가 자동으로 서브에이전트들을 조율
const parallelTasks = [
  {
    agent: "context-gatherer",
    task: "기존 인증 시스템 분석"
  },
  {
    agent: "general-task-execution", 
    task: "새로운 JWT 인증 구현"
  },
  {
    agent: "general-task-execution",
    task: "인증 관련 테스트 작성"
  }
];

// Autopilot이 자동으로 병렬 실행 및 결과 통합

단계적 워크플로우

"대규모 기능을 단계별로 구현해주세요:

Phase 1: 기반 구조 설계 및 구현
Phase 2: 핵심 비즈니스 로직 구현  
Phase 3: 사용자 인터페이스 구현
Phase 4: 테스트 및 문서화
Phase 5: 성능 최적화 및 배포 준비"

실시간 모니터링

진행 상황 추적

Autopilot이 도는 동안 진행 상황을 실시간으로 볼 수 있습니다:

현재 진행 상황:
✅ API 엔드포인트 구현 완료
🔄 프론트엔드 컴포넌트 작성 중...
⏳ 테스트 코드 작성 대기 중
⏳ 문서 업데이트 대기 중

실행된 액션: 15/50
경과 시간: 8분 23초

중간 중단 및 재개

Ctrl/Cmd + Shift + P
> Kiro: Pause Autopilot
> Kiro: Resume Autopilot  
> Kiro: Stop Autopilot

사후 검토 및 되돌리기

변경 사항 검토

Autopilot이 끝나면 바뀐 내용을 전부 검토할 수 있습니다:

## Autopilot 실행 결과

### 생성된 파일 (5개)
- src/api/profile.ts
- src/components/ProfileEditor.tsx  
- tests/profile.test.ts
- docs/api/profile.md
- types/profile.d.ts

### 수정된 파일 (3개)
- src/app.ts (라우트 추가)
- package.json (의존성 추가)
- README.md (문서 업데이트)

### 실행된 명령 (2개)
- npm install @types/multer
- npm run test

선택적 되돌리기

특정 변경사항만 되돌리기:
> Kiro: Revert File src/components/ProfileEditor.tsx
> Kiro: Revert All Changes
> Kiro: Keep Changes

Autopilot 모범 사례

1. 명확한 요구사항 정의

✅ 좋은 예:
"사용자 인증 시스템을 JWT 기반으로 구현해주세요. 
로그인, 회원가입, 토큰 갱신 기능이 필요하고,
Express.js와 TypeScript를 사용합니다."

❌ 나쁜 예:
"인증 기능 만들어주세요."

2. 안전 장치 설정

{
  "autopilotSettings": {
    "maxActions": 30,           // 적절한 제한 설정
    "allowFileDeletion": false, // 위험한 작업 비활성화
    "restrictedPaths": [        // 중요한 경로 보호
      ".env*",
      "node_modules/**",
      "dist/**"
    ]
  }
}

3. 점진적 접근

1단계: 작은 기능부터 Autopilot으로 테스트
2단계: 성공적인 패턴을 더 큰 작업에 적용
3단계: 팀 전체로 확산

4. 정기적인 검토

- 매주 Autopilot 실행 결과 검토
- 문제가 발생한 패턴 분석
- 안전 장치 설정 개선
- 팀 가이드라인 업데이트

문제 해결

무한 루프 방지

{
  "autopilotSettings": {
    "maxRetries": 3,
    "retryDelay": 5000,
    "detectInfiniteLoop": true
  }
}

리소스 사용량 제한

{
  "autopilotSettings": {
    "maxMemoryUsage": "2GB",
    "maxCpuUsage": 80,
    "pauseOnHighUsage": true
  }
}

에러 복구

{
  "autopilotSettings": {
    "onError": "pause",        // "continue", "stop", "pause"
    "createBackup": true,
    "rollbackOnFailure": true
  }
}

참고 문서

Kiro 공식 사이트: https://kiro.dev
Kiro 문서: https://kiro.dev/docs

고급 Autopilot 전략

🎯 스마트 배치 처리

복잡한 작업을 효율적으로 묶어 처리하는 전략:

{
  "autopilotSettings": {
    "batchSize": 5,
    "parallelTasks": 3,
    "priorityQueue": true,
    "smartRetry": {
      "maxRetries": 3,
      "backoffMultiplier": 2,
      "retryableErrors": ["timeout", "rate_limit"]
    }
  }
}

🔄 적응형 실행 전략

작업이 얼마나 복잡한지에 따라 전략을 자동으로 조정:

간단한 작업 (CRUD, 스타일링):
- 높은 자율성, 빠른 실행
- 최소한의 검증

복잡한 작업 (아키텍처 변경, 보안):
- 단계별 검증 포인트
- 상세한 로깅 및 백업

위험한 작업 (데이터베이스 마이그레이션):
- 자동 실행 비활성화
- 수동 승인 필수

🧠 컨텍스트 인식 자동화

프로젝트 상태와 히스토리를 함께 보고 똑똑하게 실행:

신규 프로젝트:
- 보수적 접근, 많은 설명과 문서화
- 베스트 프랙티스 우선 적용

성숙한 프로젝트:
- 기존 패턴 유지, 일관성 중시
- 점진적 개선 접근

레거시 프로젝트:
- 기존 코드 스타일 존중
- 최소한의 변경으로 목표 달성

🚀 실전 Autopilot 시나리오

대규모 리팩토링 자동화

"레거시 jQuery 코드를 React로 마이그레이션해주세요"

Autopilot 실행 계획:
1. 기존 코드 분석 및 컴포넌트 구조 설계
2. 공통 유틸리티 함수 추출
3. 페이지별 React 컴포넌트 생성
4. 상태 관리 로직 구현
5. 스타일링 마이그레이션
6. 테스트 코드 작성
7. 점진적 배포 계획 수립

예상 소요 시간: 3-5시간 (수동 작업 시 2-3주)

API 전체 재설계

"REST API를 GraphQL로 전환하고 성능을 최적화해주세요"

Autopilot 실행 과정:
1. 기존 REST 엔드포인트 분석
2. GraphQL 스키마 설계
3. Resolver 구현 및 데이터 로더 최적화
4. 인증/인가 미들웨어 적용
5. 캐싱 전략 구현
6. API 문서 자동 생성
7. 클라이언트 코드 업데이트
8. 성능 테스트 및 모니터링 설정

결과: API 응답 시간 50% 개선, 개발 생산성 3배 향상

On this page

Ch8. Autopilot 모드 활용

On this page