학습 목표
- 실전 5. 에이전트 개발 환경 구축의 역할과 적용 조건을 설명할 수 있다.
- 목표·허용 범위·금지 행동을 AGENTS.md 초안에 적으세요.
- 실패·컨텍스트 압축·재개·롤백 시나리오를 연습하세요.
사전 지식
앞선 실전 4. 운영 가능한 커뮤니티를 먼저 읽으면 용어를 이해하기 쉽습니다. 이미 아는 내용이면 이 장부터 시작해도 됩니다.
개념 이해
작은 앱 하나를 대상으로 에이전트가 반복해서 안전하게 작업할 환경을 만듭니다. 지침·문서·검사·리뷰·기록이 연결돼야 새 세션과 다른 사람도 이어갈 수 있습니다.
프로젝트 규칙과 문서
AGENTS.md는 핵심 범위와 문서 위치를, 요구 문서는 완료 조건을, 아키텍처 문서는 데이터와 신뢰 경계를 담습니다.
테스트 자동화와 CI/CD
실제 명령과 연습 데이터를 정하고 자동 검사에 연결합니다. 자동 배포는 운영 권한과 승인 경계를 별도로 둡니다.
리뷰·변경 검증·기록
diff와 실제 실행 결과를 검토하고 남은 위험·재개 위치를 기록합니다. 작업 기록은 비밀이나 사용자 원본 데이터가 아니라 근거와 경로를 담습니다.
실제 사용 사례
첫 과제를 “필수 입력 오류 문구 개선”처럼 작게 정합니다. 지침을 읽고 필요한 파일만 바꾼 뒤 실제 검증과 결과 보고까지 한 바퀴 실행할 수 있는지 확인하세요.
단계별 실습
실습은 운영 서비스가 아닌 별도 연습 프로젝트에서 진행하세요. 기존 파일이 있다면 변경 전 기록을 남깁니다.
- 목표·허용 범위·금지 행동을 AGENTS.md 초안에 적으세요.
- README·요구사항·아키텍처·보안·결정 문서를 연결하세요.
- 연습 환경과 검사 명령을 준비하고 CI에 최소 권한으로 연결하세요.
- 리뷰 체크와 작업 기록 템플릿을 작성하세요.
- 새 세션에서 작은 과제를 분석→수정→검증→기록까지 수행하세요.
- 실패·컨텍스트 압축·재개·롤백 시나리오를 연습하세요.
코드와 프롬프트
아래 요청에서 대괄호 부분을 내 프로젝트에 맞게 바꾼 뒤 AI 도구에 전달하세요.
AI에게 요청하기
[앱 저장소]의 에이전트 개발 환경을 만들어줘. AGENTS.md·개발/아키텍처 문서·연습 데이터·검사 명령·CI/CD 경계·리뷰·변경 검증·작업 기록을 연결하고 작은 과제 하나로 재개와 복구가 가능한지 확인해줘.자주 발생하는 문제와 해결
| 문제와 원인 | 해결 방법과 확인 기준 |
|---|---|
| 문서는 있는데 실제 명령이 다름 | 새 환경에서 문서대로 시작하고 어긋난 항목을 고칩니다. |
| 자동 검증이 운영 권한을 갖고 있음 | 검사와 배포 자격을 분리합니다. |
핵심 요약
- 완료 산출물은 도구 목록이 아니라 재현 가능한 작업 흐름입니다.
- 새 세션에서 다시 실행해 환경을 검증합니다.
완료 확인
참고자료
확인 기준일: 2026-10-20. 요금·사용 한도·제품 기능·설정 경로는 변경될 수 있으므로 작업 직전 공식 문서와 설치 버전을 확인하세요.