서버 코드 자동 생성 툴 — Sherpa는 왜 완전 자동화를 선택하지 않았을까

이 게시물은 Sherpa라는 서버 코드 자동 생성 도구가 완전 자동화를 선택하지 않은 이유를 설명합니다.

핵심 문제

• 마크다운 생성 과정에서 필드 및 옵션 설명 누락, 테스트로 잡기 어려운 운영 위험
• 원본과 결과를 비교할 기준 부재로 자동화 신뢰성 확보 불가능
• PDF 직접 변환은 속도는 빠르나 누락 위치 불명으로 운영에서 사용 어려움

해결 접근

• 모든 문서를 동일한 완전한 HTML 구조로 확보하여 HTML을 기준 진리로 설정
• 파이프라인을 분리(HTML 분류 → API 단위 마크다운 생성 → 위치 인덱스 생성)하여 디버깅 및 재실행 가능하게 설계
• HTML과 마크다운을 동시에 보여주는 검증 뷰어로 사람의 역할을 검수자에서 결정자로 전환