참고 자료
AI CLI 사용과 작업 경계
참가자는 준비된 Codex, Kiro CLI, Claude Code 중 하나를 선택합니다. 세 도구를 차례로 실행하는 과제가 아닙니다. 같은 파일을 여러 도구에서 동시에 수정하지 않습니다. 이 도구는 코드 작성과 검토를 돕고, 로봇 애플리케이션의 Bedrock 호출은 별도로 수행됩니다.
시작 위치와 기본 명령
01장의 info로 ROBOT_LAB과 참가자 포트를 먼저 확인합니다.
AI 도구를 시작할 터미널에서도 같은 환경 변수 블록을 실행합니다.
cd "$ROBOT_LAB"
test "$PWD" = "$ROBOT_REPO/workshop/.local/labs/$ROBOT_TEAM/app"
pwd
| 선택한 도구 | 설치 확인 | 시작 |
|---|---|---|
| Codex | codex --version |
codex |
| Kiro CLI | kiro-cli --version |
kiro-cli chat |
| Claude Code | claude --version |
claude |
설치된 버전의 도움말은 codex --help, kiro-cli --help, claude --help로 확인합니다.
교재는 기본 대화 명령만 사용합니다. 다른 도구의 플래그를 섞어 쓰거나
보호 장치를 해제하는 옵션을 추가하지 않습니다.
업그레이드와 재인증은 진행자가 수업 전에 점검합니다.
현재 대화에서 $ROBOT_LAB이라는 글자를 붙여 넣어도 터미널처럼 확장되는 것은 아닙니다.
필요하면 pwd의 실제 경로를 전달합니다.
01장의 준비기가 만든 참가자 지침을 도구가 읽었는지 첫 응답에서 확인합니다.
도구별 지침 파일을 추가로 쓰더라도 기존 지침을 지우지 않고 같은 경계를 유지합니다.
어떤 정보를 전달하는가
좋은 요청에는 수정 위치, 기대 동작, 확인 명령이 함께 있습니다.
03장의 범위는 참가자 사본의 tests/workshop-plan.test.ts입니다.
계획과 물리 코드 전체를 다시 만들라는 요청으로 확대하지 않습니다.
선택한 AI CLI의 대화 입력창에 붙여넣으세요. 세 도구가 같은 프롬프트를 사용합니다.
현재 참가자 폴더의 AGENTS.md와 지정한 계약·테스트 파일을 먼저 읽어 주세요.
tests/workshop-plan.test.ts에 계획의 허용·거부 경계값 검사를 추가하는 것이 이번 작업입니다.
실제 validatePlan을 사용하고 기존 코드와 테스트는 보존하세요.
어떤 파일을 바꿨는지, 어떤 명령을 실행했는지, 통과와 실패를 구분해서 알려 주세요.
모델·AWS 호출과 프로젝트 밖의 변경은 수행하지 마세요.
도구가 파일을 수정했다면 편집기로 직접 열어 봅니다. 테스트가 실패했는데 조건을 삭제했거나 결과를 상수로 바꾸지 않았는지 확인합니다. 실행하지 않은 명령을 “통과할 것”이라고 설명한 것은 검증 결과가 아닙니다.
인증·작업 공간 경계
| 대상 | 실습에서의 처리 |
|---|---|
| AI CLI 로그인 | 본인에게 배정된 계정으로 준비된 인증 사용 |
| AWS 호출 | 참가자 설정과 일치하는 역할·프로필, 04장에서 별도 확인 |
| 작업 파일 | workshop/.local/labs/<팀>/app 아래 |
| 운영 코드·자원 | robot-atlas, jeju-atlas와 다른 참가자의 결과는 변경하지 않음 |
| 비밀 정보 | 키·토큰·쿠키·인증 파일을 프롬프트나 결과물에 넣지 않음 |
| DNS | 핵심 과정에서는 사용하지 않으며 심화에서도 수동 등록 |
진행자가 검증한 Bedrock 모델을 지정하는 것은 애플리케이션의 MODEL_ID 설정입니다.
Codex·Kiro·Claude 자체의 provider나 모델 설정을 바꾸는 작업이 아닙니다.
AI CLI 인증에 성공했다는 이유로 AWS 모델 권한이 있다고 판단하지 않습니다.
오류 수정을 부탁하는 방법
전체 터미널 기록 대신 실패한 명령, 안전한 오류 코드, 관련 파일을 전달합니다.
.env, AWS credentials, 세션 쿠키나 CSRF 토큰이 포함된 출력을 붙여 넣지 않습니다.
선택한 AI CLI의 대화 입력창에 붙여넣으세요. 세 도구가 같은 프롬프트를 사용합니다.
참가자 사본에서 다음 검사 하나가 실패했습니다.
실행한 명령과 비밀값을 제외한 오류 메시지를 아래에 제공합니다.
관련 계약·테스트를 읽고 재현 조건부터 설명해 주세요.
기존 실패 검사를 삭제하거나 실제 모델 오류를 규칙 기반 성공으로 바꾸지 마세요.
프로젝트 밖의 변경 없이 가장 작은 수정 범위와 확인 명령을 제안해 주세요.
EACCES, 포트 권한, 읽기 전용 경로 등의 오류를 우회하려고 광범위한 권한을 부여하지 않습니다.
현재 작업이 참가자 범위인지 확인하고 진행자가 준비한 환경에서 검사합니다.
도구 인증이 준비되지 않았다면 편집기에서 같은 테스트를 직접 작성할 수 있습니다.
수행한 방식과 AI 도구 사용 여부를 결과에 정확히 남깁니다.
도구를 바꿀 때
현재 도구의 작업이 끝나고 변경 파일을 확인한 뒤 대화를 종료합니다.
같은 참가자 폴더에서 다음 도구를 시작하고 AGENTS.md, 변경 파일, 실패한 명령을 전달합니다.
새 참가자 사본을 만들거나 기존 결과를 덮어쓰지 않습니다.