03. 안전한 실행 환경 만들기

목표

작업에 사용할 도구, 검증 명령, 모의 환경, 승인 지점과 복구 방법을 실행 카드로 정리합니다.

핵심 설명

프롬프트에 “테스트해 주세요”라고 적는 것과 실제로 테스트할 수 있는 환경을 제공하는 것은 다릅니다. 하네스는 에이전트가 파일을 찾고 수정하고 검증할 수 있게 하는 도구와 규칙의 조합입니다. 검색 도구, 편집 방법, 테스트 러너, 로컬 브라우저, 샌드박스, 모의 응답, CI와 권한 경계가 모두 포함될 수 있습니다.

도구는 능력과 경계를 함께 정합니다. 로컬 파일 읽기는 허용해도 운영 배포는 사람 승인이 필요할 수 있습니다. 문의 전송처럼 외부 효과가 있는 동작은 실제 전송 대신 모의 어댑터나 테스트 데이터를 사용합니다. 운영 자격 증명이 있어야만 테스트되는 구조라면 먼저 검증 경로를 개선할 필요가 있습니다.

작은 작업이라면 파일 검색 → 제한된 수정 → 자동 테스트 → 로컬 화면 확인 → diff 검토만으로도 충분할 수 있습니다.

체크리스트

• 읽기, 수정, 실행 가능한 범위를 구분했습니다.
• 기본 테스트와 빌드 명령이 로컬에서 실행됩니다.
• 외부 API와 알림은 모의 환경으로 대체할 수 있습니다.
• 운영 비밀값 없이 핵심 동작을 검증할 수 있습니다.
• 배포·삭제·외부 전송처럼 승인이 필요한 행동을 표시했습니다.
• 실패했을 때 원래 상태로 복구하는 방법이 있습니다.
• 완료 조건마다 적어도 하나의 검증 수단이 있습니다.

직접 해보기

찾기: 사용할 검색과 확인 명령
수정: 변경을 허용할 파일과 범위
검증: 정적 검사 / 테스트 / 빌드 / 브라우저 확인
대체: 외부 연동에 사용할 mock 또는 fixture
금지: 비밀값, 운영 데이터, 승인 없는 외부 작업
복구: 변경을 되돌리거나 안전하게 중단하는 방법
승인: 반드시 사람이 결정할 지점

코드를 바꾸기 전에 기본 검증 명령을 한 번 실행합니다. 실패한다면 새 변경과 구분할 수 있도록 현재 실패를 기록합니다.

완료 근거

• 실행 카드만 보고도 허용·금지 행동을 구분할 수 있습니다.
• 기준점 테스트와 로컬 확인 방법이 작동합니다.
• 외부 전송 없이 성공과 실패를 재현할 수 있습니다.
• 작업 브리프의 완료 조건이 검증 수단과 연결되어 있습니다.

다음은 준비한 경계 안에서 일을 나누는 04. 에이전트와 작업 실행하기입니다.