SvelteKit 마이그레이션 가이드를 JSON Feed 1.1 표준으로 구조화해 AI 코딩 어시스턴트가 자동으로 코드베이스를 감사할 수 있는 34가지 패턴 피드 구축

Context

기존 마이그레이션 가이드는 인간이 읽기에는 적합했지만, AI 에이전트가 코드베이스를 대상으로 "이 저장소에 어떤 Svelte 5 패턴을 적용할 수 있는가"를 자동으로 판단할 수 있는 기계가독 형식이 없었다. 개발자가 Claude Code 같은 AI 어시스턴트에게 "저장소를 확인해서 어떤 새로운 패턴을 적용할 수 있는지 보여줘"라고 요청해도 구조화된 데이터가 없어 어려웠다.

Technical Solution

• 각 Svelte 5 패턴을 구조화된 데이터로 변환: id, title, since(도입 버전), category(syntax/architecture/ecosystem/tooling), search_signatures(grep 가능한 검색 문자열), replacement(교체 코드)를 포함한 SveltePattern 인터페이스 정의
• JSON Feed 1.1 표준 채택: 확장 필드(underscore-prefixed _svelte_pattern)로 커스텀 데이터 추가해 피드 리더, AI 에이전트, 자동화 도구 모두 호환 가능하도록 구현
• 이중 피드 엔드포인트 구성: /feeds/changelog.json(사이트 자체 변경사항용)과 /feeds/patterns.json(Svelte 패턴용) 분리
• patterns.json에 쿼리 필터링 지원: ?since=5.54(버전 기준), ?category=syntax(카테고리), ?framework=react(마이그레이션 대상), ?lang=ja(다국어) 파라미터로 필터링
• 검색 시그니처 기반 자동화: 각 패턴의 search_signatures 배열에 grep 가능한 문자열(예: "use:action", "from 'svelte/action'")을 저장해 AI가 코드베이스를 직접 스캔 후 "writable() 스토어가 12개 파일에서 사용 중 → $state 클래스로 교체" 같은 제안 생성
• HTML 피드 자동발견: layout에 <link rel="alternate" type="application/feed+json"> 태그 추가해 피드 리더가 자동으로 발견 가능하게 설정
• 이중 언어 지원: 모든 패턴에 title, title_ja, summary, summary_ja 필드 포함해 소스 레벨에서 다국어 관리

Key Takeaway

정적 마이그레이션 가이드를 JSON Feed 같은 표준 형식의 기계가독 데이터로 전환하면, AI 에이전트가 "읽기 전용" 상태에서 "자동 감사" 능력으로 전환된다. 표준 선택의 중요성: 커스텀 포맷(.txt)보다 JSON Feed 1.1을 택함으로써 기존 툴 호환성, 자동발견, 확장성을 동시에 확보했다.