피드로 돌아가기
Dev.toDevOps
원문 읽기
Claude Code와 Playwright 기반 73개 도움말 문서 1주일 내 구축 및 LLM 인덱싱 성공
We shipped a 73-article help center in a week with Claude Code — and ChatGPT started citing us 3 days later
AI 요약
Context
인도 대출 시장용 AI Loan CRM인 SigmaDSA의 급격한 제품 성장으로 인한 문서화 부재 상황. 기술 작가 고용이나 수동 작성 시 발생하는 높은 비용과 시간 지연이라는 제약 조건 존재.
Technical Solution
- Claude Code를 통한 코드베이스 분석과 Playwright 브라우저 자동화를 결합한 Docs-as-Code 워크플로우 설계
- 고정 뷰포트(1920x2800) 설정을 통한 Responsive Design으로 인한 스크린샷 깨짐 현상 해결
- MDX 기반의 정적 사이트 생성 구조를 채택하여 콘텐츠 변경 시 자동 빌드 및 배포 파이프라인 구축
- llms.txt 표준 도입을 통한 LLM 친화적 사이트 인덱스 제공 및 외부 AI 모델의 데이터 참조 유도
- JSON-LD 및 FAQPage 구조화 데이터를 MDX 프론트매터에 통합하여 SEO 최적화 자동화
- Sharp 및 SVG 컴포지팅을 활용한 스크린샷 내 자동 어노테이션 생성 로직 구현
실천 포인트
1. LLM 기반 문서 생성 시 MDX 중괄호({}) 충돌 방지를 위한 백틱(``) 처리 확인
2. 자동화 스크린샷 캡처 시 fullPage 옵션 대신 고정 ViewportSize 설정 권장
3. YAML 파서 오류 방지를 위해 프론트매터 내 특수문자(콜론 등) 포함 문자열은 반드시 쿼테이션 처리
4. AI 에이전트 제어 시 아티클 단위가 아닌 섹션 단위의 전략적 가이드라인 제시