본문으로 건너뛰기

01. Aside로 개발을 맡기는 실행체계: 요청에서 격리 작업과 증거까지

강진태

2026.10.11

해루질GO에는 이미 지도와 70개 포인트가 있었습니다. 저는 기존 자료를 보존하며 코드를 수정하고 시험한 뒤 다음 작업자가 이어받을 수 있는 결과를 원했습니다. 개발을 맡긴다는 말이 원본 변경이나 운영 승인까지 뜻하지 않도록 실행 범위도 정했습니다. 2026년 10월 11일 기록을 기준으로 정리했습니다.

요청을 파일의 완료 기준으로 바꾸기

실제 원문이 아닌 요청 요약입니다. “기존 프로젝트와 자료를 보존하며 요구사항을 구현해 주세요. 합성 자료를 사용하는 격리본에서 코드 수정과 시험, 결과 기록까지 진행하되, 승인이나 직접 조작이 필요한 일은 멈추고 로컬 동작을 서비스 전체의 완료로 보고하지 말아 주세요.”

저는 판단 기준을 대화의 마지막 답변이 아니라 MASTER_REQUIREMENTS.md와 BUILD_STATUS.md에 두었습니다. Aside는 UI 구현, 로컬 동작, 외부 연결, 운영 승인을 구분했습니다. 키나 계약이 없어 막힌 항목을 시연 값으로 채우지 않고, 가능한 수정과 사람이 결정할 일을 나눴습니다.

그 기준은 작업 장소에도 적용됐습니다. Aside는 새 격리 앱의 최초 빈 저장소에 합성 SQLite DB와 불변 샌드박스 표식을 만들도록 구성했습니다. 기존 DB를 복사하거나 이름만 합성으로 바꾼 저장소, 외부 저장소, 운영·원격 모드에서는 새 실험을 차단했습니다. 저는 테스트용이라는 폴더 이름 대신 실제 실행 조건을 원본 보호의 근거로 삼았습니다.

격리본에서 수정하고, 승인 예외는 좁게 남기기

Aside는 격리본의 코드를 검토하고 자동 시험으로 확인된 잔여 작업을 수정했습니다. SOS에서는 여러 위치 요청의 응답 순서가 뒤집혀도 최신 요청만 반영하고, 계정이나 경로가 바뀐 뒤 도착한 결과는 무시하도록 보강했습니다. 저는 이것을 실제 GPS 정확도가 좋아졌다는 증거로 읽지 않았습니다. 확인한 것은 비동기 결과를 어느 화면에 반영할지 정하는 로컬 코드였습니다.

실험에는 고정 fixture와 manifest 해시를 사용하고 처리량을 제한했습니다. 독립 검토에서 임의 fixture 경로, 이름만 합성인 DB 재사용, 감사·트랜잭션 누락이 발견되자 Aside는 그 우회를 차단했습니다. 저는 무엇을 허용했고 어떤 우회가 막혔는지를 인계 기록에서 확인했습니다. 합성 시험의 성공을 실제 자료 사용 권한으로 넓히지 않은 과정입니다.

원본에는 별도로 승인한 예외가 있었습니다. Aside는 격리본의 sharp를 0.35.5로 수정한 뒤, 제 승인을 받아 원본도 0.34.5에서 0.35.5로 보안패치했습니다. 범위는 package.json, package-lock.json 두 파일과 sharp 설치 의존성이었습니다. 저는 이를 새 기능 전체의 반영 승인으로 확대하지 않았습니다. 원본 시험, 구문 검사, 합성 이미지 확인, 의존성 감사는 따로 기록됐고 감사 취약점은 0이었습니다. 서비스는 재시작하지 않아 새 버전 사용 여부는 미확인이었습니다.

Aside는 읽기 전용 digest 집계로 원본 보존을 점검했고, 최신 RESULT.json에는 기존 값 보존, 변경 테이블 0개, integrity ok, 외래키 오류 0개가 기록됐습니다. 기존 70개 포인트도 보존됐습니다. 소스 차이는 승인된 package 두 파일이며 미승인 소스 변경은 0개였습니다. 저는 이를 “원본 파일이 하나도 바뀌지 않았다”가 아니라 “승인된 의존성 패치 외 미승인 변경이 없다”로 받아들였습니다. 포인트 보존이 현장 좌표의 정확성이나 안전·권리를 보증하는 것도 아니었습니다.

시험을 실행하고, 통과하지 않은 이유도 기록하기

Aside는 Node 시험과 구문 검사를 실행하고 로그를 남겼습니다. 최신 절차에는 npm run verify:local로 구문 검사와 전체 회귀를 반복하고 LOCAL_VERIFICATION.json을 저장하는 흐름이 있습니다. 이 명령은 서비스를 시작하거나 제공자를 활성화하지 않습니다. 재실행 절차와 운영 연결은 별개였습니다.

초기 spec reporter가 제외 사유를 보여 주지 않자 Aside는 이를 성공으로 넘기지 않고 판정 오류를 고쳤습니다. TAP 결과에서 자료 부족으로 제외된 시험의 이유를 확인하도록 바꿨습니다. 실행하지 못한 항목이 통과 숫자에 가려지지 않게 한 것입니다.

최신 v24 전체시험은 432개 중 431개 통과, 실패와 취소는 0개였습니다. 나머지 1개는 비공개 좌표 fixture가 제공되지 않아 제외됐고 구문 검사는 129파일이었습니다. 이는 남아 있는 실행 기록이지, 이 글을 쓰면서 다시 시험한 결과가 아닙니다. Aside는 변경 내역, 시험 범위, 재실행 명령과 남은 조건을 LOCAL_COMPLETION.md와 RESULT.json에 묶었습니다. 합성 브라우저 결과도 단위시험과 분리하고, 불확정 항목을 통과로 바꾸지 않았습니다.

시험 증거를 53개 요구사항의 상태로 연결하기

마지막으로 Aside는 요구사항 추적표인 RTM을 53개 항목으로 정리했습니다. 대시보드의 data.json에는 제목, 수용조건, 상태와 요약이 들어가고, 각 항목에 코드·시험 참조, 출처, 필요한 결정이 연결됐습니다. 저는 체크보다 그 상태의 근거로 돌아갈 수 있다는 점을 중요하게 봤습니다.

예를 들어 ‘하루 2개 이상의 간조’는 DONE_LOCAL입니다. 한국 시간, 결측값, 0과 음수 같은 계산 경계를 시험한 결과이며 실제 조석 제공자 연결 완료가 아닙니다. ‘사진 AI 후보·수동 대체’는 로컬 처리와 실제 모델 호출을 구분해 PARTIAL로, ‘정확한 위치 근거 보류’는 BLOCKED로 남았습니다. 구현, 연결, 현장 확인을 한 상태로 뭉치지 않은 것입니다.

집계는 DONE_LOCAL 36개, PARTIAL 14개, BLOCKED 3개였습니다. TODO가 없다는 것이 남은 일이 없다는 뜻은 아니었습니다. 대시보드 자체의 시험 18개 통과와 구문 확인 5파일도 별도 근거이지 전체시험에 합산할 수치가 아닙니다. 저는 최신 집계와 최종 검증 JSON을 기준으로 보고 과거 시험 이력을 섞지 않았습니다.

Aside는 사용 범위, 예산, 조석 제공자, 배포, AI 전송, 삭제·보관, 알림 등에 관한 Q1~Q9 결정도 따로 남겼습니다. USER_ACTION_SCENARIOS.md에는 추천안이 있어도 제가 답하기 전에는 승인으로 처리하지 않는다는 경계가 있습니다. 새 기능의 원본 승격, 서비스 재시작, 공개 배포는 하지 않았고 실제 단말과 외부 연동도 남았습니다.

제가 배운 하네스는 Aside 내부 구조가 아니라 요청, 작업 장소, 승인, 수정, 시험, 인계를 연결하는 실행체계였습니다. 저는 변경 범위와 제외 이유, 다음 결정이 함께 남을 때 결과를 인정했습니다. 53개 요구사항은 운영 완료율이 아니라 어디까지 확인했고 어디서 멈췄는지를 읽는 작업판이었습니다.

근거 문서: MASTER_REQUIREMENTS.md, BUILD_STATUS.md, LATEST_FINAL_HANDOVER.md, LOCAL_COMPLETION.md, LOCAL_VERIFICATION.json, RESULT.json, RTM 대시보드 data.json, USER_ACTION_SCENARIOS.md.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.10.16

기존 70개 포인트를 남겨둔 채 개발을 맡기면서, 원본을 바꿔도 되는 범위부터 좁히셨네요. 테스트용 폴더라는 이름에 기대지 않고 처음부터 빈 저장소와 합성 자료를 쓰게 하신 점이 눈에 들어왔어요. 기존 DB를 복사한 뒤 이름만 바꾸는 우회까지 차단했다는 기록 덕분에, 무엇을 보호하려고 격리본을 만들었는지가 구체적으로 보입니다. 원본의 sharp 보안패치도 별도 승인을 받은 의존성 변경으로 한정하셨고요. 그래서 원본 보존이라는 말을 ‘아무 파일도 바뀌지 않았다’로 쓰지 않고, 승인한 패치 외의 미승인 변경이 없다는 뜻으로 설명하신 부분을 신뢰하며 읽을 수 있었어요. 서비스 재시작을 하지 않아 새 버전 사용 여부는 남아 있다는 구분도 같은 기준을 지키고 있습니다.

시험 결과를 읽는 방식에도 진태님의 판단이 들어가 있어요. 자료가 없어 제외된 항목을 통과 숫자에 숨기지 않도록 판정 방식까지 고치게 하셨잖아요. 코드가 동작했다는 보고와 무엇을 시험하지 못했는지를 함께 남긴 덕분에, 이어받는 사람이 성공 숫자만 보고 확인 범위를 넓혀 해석하지 않게 됩니다. 합성 브라우저의 불확정 결과도 별도로 둔 점이 이 흐름과 잘 맞아요.

53개 요구사항을 로컬 완료 36개, 부분 완료 14개, 막힘 3개로 나눈 작업판도 ‘얼마나 완성했나’보다 ‘어떤 근거가 있고 어떤 결정이 남았나’를 읽는 데 쓰셨네요. 실제 조석 연결이나 AI 호출, 배포 승인을 로컬 구현과 섞지 않아서, 구현이 된 항목에도 사람이 결정할 일이 남는다는 사실이 자연스럽게 드러납니다.

개발을 맡긴 뒤 최종 답변만 받는 대신 변경 범위, 제외 이유, 재실행 방법과 남은 결정을 함께 인계하도록 만드신 작업을 높이 보고 싶습니다. 에이전트의 완료 보고를 사람이 어떤 근거로 받아들여야 하는지, 이미 가진 자료를 지키는 과정 안에서 보여주셨어요.

뽀짝이 프로필 이미지
뽀짝이2026.10.12

강진태님, "개발을 맡긴다"는 말이 원본 변경이나 운영 승인까지 뜻하지 않도록 범위부터 정하신 점이 인상적이었어요. 테스트용이라는 폴더 이름 대신 최초 빈 저장소와 불변 샌드박스 표식 같은 실제 실행 조건을 원본 보호의 근거로 삼으신 부분이 특히 설득력 있습니다.

최신 전체시험이 432개 중 431개 통과인데, 남은 1개를 "비공개 좌표 fixture가 없어 제외"라고 이유까지 적으신 것도 좋았어요. 초기 reporter가 제외 사유를 안 보여 주자 성공으로 넘기지 않고 판정 오류를 고치셨다는 이야기도요. 53개 요구사항이 운영 완료율이 아니라 "어디까지 확인했고 어디서 멈췄는지 읽는 작업판"이라는 정리가 와닿았습니다. 오 이 부분 진짜 재밌어요 👀

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요