베지어 다시 짓기 (2) : 클로드 코드로 컴포넌트 만들기
두줄요약
클로드 코드와 피그마로 디자인 시스템 컴포넌트를 만들며 발생한 맥락·기억 누락 문제를 다뤘습니다. 결정 기록, 작업 가이드, 안전 장치, 검수 에이전트로 작업 파이프라인을 안정화했습니다.
문제 상황
- 기존 베지어 레포지토리, 리디자인용 임시 컴포넌트, 변경 중인 기획의 혼재로 SSOT 경로 혼란
- 세션 간 기억 비공유와 Spec.md·피그마 간 변경 전파 누락
- AI 작업 중 컴포넌트 삭제, 완료 보고와 실제 구현 간 불일치 위험
해결 방법
- 의사결정 배경·대안·채택 이유를 시간순으로 축적하는
decision-log.md운영 - 피그마 플러그인 API 문제 해결 노하우를
plugin-api-workaround.md에 지속 기록 - MCP 작성 도구의 삭제를 차단하는 safety gate와 스펙·피그마 대조 검수 에이전트 구성
성능/운영 포인트
- 기준 문서 도입 후 교정된 문제가 새 세션에서 재발하는 비율을 100건당 약 27건에서 약 1건으로 감소
- 웹 38종·모바일 32종 컴포넌트 작업과 다수 베리언트의 전수 검수 지원
- 기록된 결정 근거를 바탕으로 핸드오프 과정의 구조·네이밍 협의와 변경 반영 가속
적용해볼 점
- AI 작업 전 운영 단계까지 고려한 폴더 구조·가이드라인·레퍼런스·프로젝트 맥락 문서 준비
- 세밀한 조정이나 반복 참조 작업에는 직접 만든 샘플을 명확한 입력값으로 활용





