이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.
핵심 요약
코드 아키텍처를 담은 Markdown 스펙 파일을 활용해 Claude의 문맥 이해도를 높이고 토큰 사용량을 최적화하는 방법.
배경
Claude와 대화하며 코딩할 때 발생하는 버그와 토큰 낭비 문제를 해결하기 위해, 코드 아키텍처를 요약한 Markdown 스펙 파일을 활용하는 워크플로를 공유했다.
의미 / 영향
이 토론에서 LLM의 코드 이해도를 높이기 위해 전체 코드 업로드보다 구조화된 스펙 파일 제공이 더 효과적임이 확인됐다. 커뮤니티 합의는 명시적인 아키텍처 정의가 버그 예방과 토큰 최적화에 필수적이라는 것이며, 향후 프로젝트 설계에 직접 적용 가능하다.
실용적 조언
- create a short MD spec for this codebase라고 요청하여 현재 코드의 아키텍처 요약본을 생성한다.
- 새 세션 시작 시 코드 파일과 함께 스펙 파일을 업로드한다.
- 편집 전 Before editing, confirm the spec matches the current code 프롬프트를 사용한다.
섹션별 상세
MD 스펙 파일은 코드의 도구 라우팅과 핵심 아키텍처를 명시하여 Claude가 의도를 정확히 파악하게 돕는다. 변수명에서 의도를 추론할 때 발생하는 버그를 방지하고, 전체 시스템 흐름을 명확히 한다.
markdown
## Tool routing
- Shape buttons call set_shape(key)
- If key == 'polygon' → _tool = 'polygon' (freeform)
- All other keys → _tool = '__shape__' (bounding-box draw)
## Shape keys
line, curve, ellipse, rect, roundrect, polygon, triangle, ...코드의 도구 라우팅과 핵심 키를 정의한 Markdown 스펙 파일 예시
전체 파일을 업로드하는 대신 스펙 파일과 변경된 함수만 제공하면 토큰 사용량을 크게 줄일 수 있다. 세션 시작 시 코드 파일과 스펙 파일을 함께 업로드하면 Claude가 즉시 아키텍처를 파악한다.
Claude는 세션 간 기억이 없으므로, 매 세션 시작 시 스펙 파일을 다시 제공해야 한다. 스펙 파일은 코드와 동기화된 상태를 유지해야 하며, 수정 전후로 스펙 준수 여부를 확인하는 프롬프트를 사용한다.
실무 Takeaway
- 코드의 핵심 구조와 도구 라우팅을 담은 Markdown 스펙 파일을 작성하여 Claude의 코드 이해도를 높인다.
- 전체 코드 대신 스펙 파일과 변경된 함수만 공유하여 API 토큰 비용을 절감한다.
- 편집 전후로 스펙과 코드 일치 확인 및 스펙 준수 여부 검증 프롬프트를 사용하여 버그를 예방한다.
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 06. 03.수집 2026. 06. 03.출처 타입 REDDIT
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.