에이전트 목표에 작업·증거·경계·중단 조건 쓰기

“로그인 기능을 개선해줘”라는 요청만으로는 오류 문구 수정과 인증 구조 변경을 구분하기 어렵습니다. 에이전트에게 기대하는 결과, 수정할 범위, 완료를 확인할 방법을 함께 전달해야 합니다.

Alpha Batcher는 목표의 네 요소를 정리한 게시물에서 작업, 증거, 경계, 중단 조건을 제안합니다. 특정 명령에만 쓰는 형식은 아닙니다. 작은 코드 수정이나 문서 작성에서도 진행할 범위와 완료 기준을 정하는 데 사용할 수 있습니다.

관찰할 수 있는 작업 결과

“좋게 만들어줘”보다 사용자가 어떤 상황에서 어떤 결과를 받아야 하는지 적습니다. 로그인 오류라면 실패 시 빈 화면 대신 안내가 표시되는 것처럼 변경 전후를 구분할 수 있어야 합니다.

“최근 문의가 늘었다”는 배경이고, “잘못된 비밀번호에 오류 문구를 표시한다”는 작업입니다. 완료 기준에는 사용자가 볼 결과를 적습니다.

직접 만든 작업 범위 예시입니다. 로그인 오류 안내와 그 검사는 범위 안에 두고, 인증 구조와 Production 권한 변경은 별도 판단 대상으로 둡니다.

테스트와 빌드가 통과했다는 사실은 필요한 근거가 될 수 있습니다. 하지만 기존 테스트가 새 동작을 검사하지 않으면 그것만으로 완료를 증명할 수 없습니다. 무엇이 성공해야 하는지에 맞춰 검사를 골라야 합니다.

에이전트가 로그인 안내를 바꿨다면 잘못된 입력에서 문구가 보이는지, 정상 입력에서 기존 흐름이 유지되는지를 확인할 수 있습니다. 문서를 작성했다면 숫자와 근거를 대조하고, 최종 파일의 누락과 배치를 확인하는 식으로 작업에 맞는 증거를 남깁니다.

“직접 확인했다”는 보고에는 대상과 결과가 있어야 합니다. 계획한 검사와 실행한 검사, 로컬 검사와 실제 서비스의 동작도 구분합니다.

작업 요청에는 수정할 대상과 별도 승인이 필요한 행동을 적습니다. 로그인 화면을 고치는 요청이 데이터 구조 변경이나 프로덕션 배포까지 자동으로 포함하지는 않습니다.

에이전트는 정한 범위로 결과를 만들 수 없다면 필요한 추가 변경과 이유를 보고합니다. 주변에서 발견한 별도 문제는 요청한 변경과 분리해 전달합니다.

완료 조건은 목표를 달성했음을 판단하는 기준입니다. 중단 조건은 목표를 달성하지 못했더라도 실행을 멈추고 보고해야 하는 상황입니다. 자격증명 부족, 새로운 비용, 승인되지 않은 외부 효과, 정한 시간이나 예산의 소진이 해당할 수 있습니다.

에이전트는 중단 보고에 완료한 부분, 실제 차단 지점, 이어가려면 필요한 조건을 적습니다. 권한 부족인지 운영체제 오류인지 확인하지 못했다면 미확인 상태로 남깁니다.

작업: 잘못된 비밀번호를 입력하면 로그인 폼 아래에 오류를 표시합니다.
증거: 잘못된 입력의 안내와 정상 입력의 이동을 각각 확인합니다.
경계: 로그인 화면과 필요한 오류 처리만 수정합니다.
중단: 인증 방식이나 저장 구조를 바꿔야 하면 이유를 보고합니다.

예시 요청에는 완료할 결과와 별도 판단이 필요한 상황을 구분해 적었습니다. 검사 명령이나 파일 이름이 이미 정해져 있다면 실제 프로젝트 값으로 더 구체화할 수 있습니다.

결과를 받을 때는 네 항목을 다시 대조합니다. 오류 문구가 표시되는지, 정상 로그인은 유지되는지, 인증 방식이 바뀌지 않았는지 확인하면 요청과 결과의 차이를 찾을 수 있습니다.

요청을 다시 작성할 때는 결과와 달랐던 조건을 구체화합니다. 오류 안내만 수정하려던 작업에서 인증 구조까지 바뀌었다면, 다음 요청에는 수정 대상과 별도 승인이 필요한 변경을 명시합니다.