같은 폴더에서 두 세션이 값을 다르게 정했다 — '검증부터'로 순서를 바꾼 이야기
2026.06.05

하려던 것 📝
AI 코딩 도구로 작은 동네 사업 하나를 작업공간째로 굴리는 중인데, 여러 문서에 흩어진 핵심 값(가격)이 세션마다 엇갈린 걸 하나로 정합하고 싶었다.
"무엇을 만들지"는 잔뜩 적었는데 "무엇이 완료이고 어긋나면 어떻게 되돌릴지"를 안 정해둔 게 문제의 뿌리였다.
한 발 더 나아가, 이 방식이 나 혼자에게만 통하는지 아니면 팀의 다른 작업 에이전트에게 넘겨도 통하는지까지 확인하고 싶었다.
활용한 툴 ⚒️
AI 코딩 도구 : 작업공간 전체 운용 + 실제 문서 정정·검토
검증 문서 기반 자율 실행 방식 : "완료 조건"과 "건드리면 안 되는 것"을 먼저 문서로 못 정하고, 그 조건을 통과할 때까지 자율로 돌리는 방식
인계 노트(handoff) : 세션 간·에이전트 간 컨텍스트 전달. 같은 방법을 다른 에이전트에 넘길 때도 이 한 장으로
진행 세부 내용 🔍
1️⃣ 값이 엇갈린 걸 발견
작업이 길어지니 같은 폴더에서 여러 세션을 동시에 띄우게 됐고, 한 번은 핵심 상품 값을 두 세션이 따로 정했다. 한쪽은 값을 내리기로 결정했는데 그 결정이 다른 세션이 만든 등록용 문서에는 반영되지 않았다. 결정 기록엔 새 값, 실제 쓰일 문서엔 옛 값. 제일 무서웠던 건 "지금 어느 게 진짜 값이지?"가 안 잡히던 순간이었다.
2️⃣ 순서를 뒤집었다 (스펙 먼저 → 검증부터)
시도한 접근: 값을 고치기 전에 "정답 조건"부터 정했다. 그것도 사람이 눈으로 대조하는 게 아니라 통과/실패를 기계적으로 확인할 수 있는 조건으로. 그리고 결정적으로 "무엇을 고치나"만큼 "무엇을 건드리면 안 되나"도 같이 조건에 적었다 (다른 상품군은 손대면 안 되니까).
핵심 프롬프트 (요약):
이 폴더의 값 불일치를 정합해줘. 정답 값은 최신 결정 기록을 기준으로. 단 다른 상품군 라인은 절대 건드리지 마. 그 라인이 바뀌면 실패로 처리해. 완료 판정은 사람 눈이 아니라 검색으로 통과/실패가 딱 떨어지게.
3️⃣ 검증 루프를 끝까지 돌렸다
정답 조건을 고정해두고 루프를 돌렸더니, 여러 문서에 흩어진 옛 값이 새 값으로 정합되고 건드리면 안 되는 라인은 0건 변경으로 통과했다. 사이에 숨어 있던 표기 깨짐(따옴표 버그)처럼 내가 미처 못 본 것까지 같이 잡혔다. 검증 항목 전부 통과. 무거운 조사는 가벼운 모델에 맡기고 나는 판단·검토만 했더니 비용도 줄었다.
4️⃣ 같은 방법을 팀에 넘겨봤다
여기서 멈추지 않고 같은 방법을 팀의 다른 작업 에이전트에게도 인계 노트로 넘겼다. 흥미로웠던 건 그쪽이 내 방식을 그대로 베끼지 않았다는 거다. "나는 그 부분은 이미 돼 있고 진짜 약한 건 다른 데다"라고 비판적으로 받아서 자기 환경에 맞게 재해석했고, 심지어 내가 놓친 함정(겉으론 멀쩡한데 실제론 안 쓰이는 것들)을 자기 쪽에서 새로 짚어 돌려주기까지 했다.
시행착오 ⚠️
발생한 어려움과 해결:
여러 세션이 같은 값을 따로 정해 문서마다 엇갈림 → "정답 조건"을 먼저 고정하고 통과해야만 다음으로 넘어가는 검증 루프로 해결.
실패한(놓칠 뻔한) 시도:
처음엔 고칠 대상만 적었다. 그런데 "건드리면 안 되는 것"을 안 적으면 자동으로 돌릴 때 엉뚱한 데까지 손댈 위험이 있었다. 보호 대상을 조건에 같이 넣고 나서야 안심하고 자율 실행을 맡길 수 있었다.
남은 과제:
고객이 보는 라이브 화면 재배포는 일부러 자율 범위에서 뺐다 (대외 변경이라 사람이 한 번 더 보고). 이건 따로 마무리 예정.
배운 점 📚
"무엇을 만들지"보다 "무엇이 완료인지"를 먼저 정하는 게 진짜 통제다. 잘 만든 결과물도 정답 조건이 없으면 어느 게 진짜인지 보장 못 한다.
"건드리면 안 되는 것"까지 조건에 적어야 자동으로 돌려도 안심이 된다. 이게 자율 실행의 안전벨트였다.
방법론은 떠먹이는 게 아니라 재해석하게 하는 것. 인계 노트 한 장으로 다른 에이전트에 옮겼더니, 그쪽이 자기 약점에 맞게 다시 해석해서 한 번 더 검증됐다.
도구 욕심이 곧 비용이다. 안 쓰는 건 지우고, 무거운 건 가벼운 도구에 위임하고, 화려한 지식 위키는 굳이 안 깔았다 (문서 스무 개 안쪽이면 가벼운 메모가 더 빠름).
향후 계획 🧭
이번 주: 라이브 화면 재배포 마무리 (자율 범위에서 뺐던 마지막 한 단계).
다음: 같은 "검증부터" 패턴을 다른 작업공간에도 인계 노트로 확산 — 한쪽에서 검증된 방법을 옮겨 또 검증하는 식으로.
최종: 새 작업을 시작할 때마다 "완료 조건 + 보호 대상"을 먼저 정하는 걸 기본 순서로 굳히기.
도움이 필요한 점 🤝
자동 실행을 맡길 때 "건드리면 안 되는 것"을 조건에 넣는 더 좋은 패턴이 있으면 공유받고 싶다. 지금은 검색 기반 통과/실패로 잡고 있는데, 더 정교한 방법이 궁금하다.
여러 작업 에이전트 사이에 방법론을 넘길 때, "베끼지 말고 재해석하게" 유도하는 인계 노트 작성 노하우가 있으면 배우고 싶다.


