Architecture Decision Record

ADR

채택한 이유를 남기는 짧고 구조화된 의사결정 기록.

연도별

Pagefind 사이트 검색 도입 방침

정적 사이트용 전문 검색으로 Pagefind를 채택하고, 로케일별 검색 라우트와 빌드 연계를 표준화한다.

2026-02-08-008-pagefind-site-search

시계열 글은 blog, 장기 참조용 지식 글은 glossary로 분리하고 URL·컬렉션·목록 동선을 독립 운영한다.

2026-02-08-009-glossary-content-separation-policy

블로그 글로 보기엔 짧은 실용 메모를 snippets로 분리하고, /snippets 및 /{lang}/snippets에 목록/상세 페이지를 제공한다.

2026-02-08-010-snippets-content-collection-design

로케일별 manifest를 생성하여 lang/name/short_name을 현지화합니다.

2026-02-08-011-pwa-manifest-locale-strategy

title/description, canonical/hreflang, OGP/Twitter, 구조화 데이터 출력을 일원화해 검색 결과와 AI 요약에서 재사용성을 높인다.

2026-02-07-005-seo-metadata-aio-strategy

GA4(G-WZ3RT34EZZ)를 Partytown 경유로 도입해 메인 스레드 부담을 줄이면서 페이지뷰 측정을 시작한다.

2026-02-07-006-partytown-google-analytics-integration

커밋 및 푸시 시점에 Biome 포맷팅과 린트를 자동 실행하기 위해 lefthook을 도입한다.

2026-02-06-004-lefthook-git-hooks-automation

일본어를 기본(루트)으로 유지하고 추가 언어는 하위 디렉터리 접두사로 제공한다.

2026-02-05-001-astro-i18n-url-strategy

Markdown/MDX 기반 블로그 글 관리를 위한 스키마와 운영 규칙을 정의한다.

2026-02-05-003-blog-content-collection-design

명명 규칙, 언어 전략, 목록 스키마를 정의한다.

2026-02-04-001-adr-structure