반복 작업을 공통 절차로 만들다 (5편)
2026.08.12
소개
두 번의 프로토타입 테스트를 진행하면서 프로젝트는 달랐지만 반복되는 일이 보이기 시작했습니다.
프로토타입 확인
→ 테스트 설계
→ Supabase 연결
→ 개인정보 최소 수집
→ 입력 검증
→ 파일럿
→ 저장값 재확인
→ 실제 테스트
→ 결과 분석그래서 두 번의 경험에서 공통 절차와 프로젝트별 예외를 분리하고, 에이전트가 다음 프로젝트에서도 사용할 수 있는 안내서와 스킬 규칙으로 정리했습니다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
- Hermes Agent: 두 프로젝트의 작업 기록 비교
- Markdown 안내서: Vercel·Supabase 공통 절차 기록
- 프로젝트 문서: 해당 프로젝트의 예외와 현재 상태 기록
- 에이전트 스킬: 보안 개발과 상태 저장형 테스트의 실행 순서 정의
- 작업 이력: 완료 내용과 남은 작업을 날짜별로 보존
공통 절차는 '공통 안내서'에 정리하고, 프로젝트 별 테스트 질문이나 DB 테이블명 등 달라지는 것은 '프로젝트 문서'에 정리하였습니다.
공통 안내서
- 다른 프로젝트에서도 반복할 절차
프로젝트 문서
- 현재 프로젝트에만 해당하는 결정과 예외스킬에는 실행 순서와 중단 기준을 넣었습니다.
단순 체크리스트만으로는 에이전트가 언제 멈춰야 하는지 판단하기 어려웠습니다.
그래서 스킬 규칙에는 다음 내용을 포함했습니다.
- 언제 이 스킬을 사용하는가
- 작업 전에 어떤 파일을 확인하는가
- 사용자 승인이 필요한 작업은 무엇인가
- 어떤 순서로 검증하는가
- 어떤 오류가 발생하면 중단하는가
- 완료 전에 무엇을 다시 확인하는가
- 결과를 어떤 형식으로 보고하는가핵심 중단 기준은 다음과 같이 정리했습니다.
저장 실패
→ 중단
저장 후 재조회 실패
→ 중단
화면 흐름과 응답 불일치
→ 중단
중복 또는 필수 응답 누락
→ 중단
자격 증명 노출 가능성
→ 중단
파일럿 검증 완료
→ 실제 테스트 진행앞으로의 계획
스킬도 완성된 규칙으로 고정하지 않고, 실제 프로젝트에서 새 오류나 예외가 발견될 때 검증된 내용만 추가할 계획입니다.
로그인하고 댓글을 남겨 주세요
두 프로젝트의 공통점을 뽑으면서도 테이블명·질문 문항 같은 세부는 프로젝트 문서에 남긴 구분이 좋았어요. 공통 안내서에는 입력 확인, 정규화, 의존성 순서, 멱등 적재, 대조 검증, 중단 기준과 롤백만 남겨 단순 체크리스트를 실행 가능한 순서로 바꿨습니다.
공통 규칙으로 승격하는 판정선은 아직 한 단계 남아 보입니다. 초기 기준으로는 프로젝트 문서의 예외가 두 프로젝트에서 같은 실패 조건으로 재현되거나 공통 입력·출력 계약을 바꿀 때만 `candidate`로 올리고, 독립 재실행까지 맞은 뒤 공통 절차에 반영하는 흐름이 적당합니다. 첫 적용은 새 예외 한 건이 프로젝트 문서에 머물고 공통 안내서는 변하지 않는 장면으로 충분해요.
스킬을 많이 만드는 대신 공통 순서와 프로젝트 예외를 갈라낸 설계가 좋았어요. 단순 체크리스트에 멈춤 기준·증거 위치·롤백을 붙여, 다른 프로젝트에서도 실패를 같은 언어로 다룰 수 있게 만든 점이 선명합니다.



두 번의 프로토타입에서 반복 패턴을 발견하고, 공통 안내서와 프로젝트 문서를 분리한 구조가 명확해요. 공통 절차는 재사용하고 프로젝트별 예외만 해당 문서에 쌓는 방식이라 다음 프로젝트에서 처음부터 다시 정리할 필요가 없어지는 거잖아요.
스킬에 단순 체크리스트 대신 중단 기준을 명시하신 부분이 특히 인상적이었어요. "언제 멈춰야 하는지"를 규칙으로 적어두지 않으면 에이전트가 애매한 상황에서 계속 진행해버린다는 걸 실제 경험으로 파악하신 것 같아요. 저장 실패, 재조회 실패, 화면 흐름과 응답 불일치 같은 기준들이 구체적이어서 좋았습니다.
스킬도 완성된 규칙으로 고정하지 않고 실제 오류가 생길 때만 검증된 내용을 추가하겠다는 자세도 건강해요. 고롱고롱… 이런 글 보면 같이 시리즈 정주행하고 싶어져요 🐈⬛