logo hsb.horse

Architecture Decision Record

ADR

採用した理由を残す、短く構造化された意思決定の記録。

年別

採用 #search #pagefind #architecture #i18n

Pagefindによるサイト内検索導入方針

静的サイト向け全文検索としてPagefindを採用し、言語別検索ページとビルド連携を標準化する。

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

採用 #content #glossary #blog #information-architecture #seo

ブログ記事と知識記事を分離するGlossary導入方針

時系列記事は blog、長期参照の知識記事は glossary に分離し、URL・コレクション・一覧導線を独立運用する。

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

採用 #content #snippets #blog #information-architecture #seo

軽量な実用メモを管理する Snippets コレクション導入方針

ブログほど長くない実用メモを snippets に分離し、/snippets と /{lang}/snippets で一覧・詳細を提供する。

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

採用 #pwa #i18n

PWA manifestの多言語対応

manifestを言語ごとに分岐し、lang/name/short_nameを適切にローカライズする。

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

採用 #seo #metadata #aio #structured-data #i18n

SEO/メタデータおよびAIO最適化方針

title/description、canonical/hreflang、OGP/Twitter、構造化データの出力を統一し、検索結果とAI要約の再利用性を高める。

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

採用 #analytics #ga4 #partytown #performance #privacy

Partytown と Google Analytics(GA4)導入方針

GA4(G-WZ3RT34EZZ)を Partytown 経由で導入し、主スレッド負荷を抑えつつページビュー計測を開始する。

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

採用 #tools #architecture #routing #i18n

個別ツール追加の実装方針

ツール追加時のルーティング、feature責務、i18n配置ルールを定義する。

2026-02-07-007-tools-implementation-structure

採用 #design #ux #responsive #tailwind

画面サイズ別レイアウトポリシー(モバイルファースト)

2段階ブレイクポイントによるモバイルファースト設計を標準とする。

2026-02-06-001-mobile-first-layout-policy

採用 #tooling #quality #git-hook

lefthookによるGit Hook自動化

コミット時とPush時にBiomeのフォーマットとリントを自動実行するため、lefthookを採用する。

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

採用 #astro #i18n #seo #architecture

Astroサイトの多言語URL設計とi18n戦略

日本語をデフォルト(ルート)に維持し、追加言語をサブディレクトリで配信する。

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

採用 #tools #content #architecture

ツール一覧の管理方式

ツール一覧はYAMLのContent Collectionで管理し、個別ツールページは実装で作る。

2026-02-05-002-tools-catalog-strategy

採用 #blog #content #architecture

ブログContent Collection設計

ブログ記事をMarkdown/MDXで管理するためのスキーマと運用ルールを定義する。

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

採用 #docs #process

ADRの運用方針

ファイル命名、言語運用、掲載スキーマを整理する。

2026-02-04-001-adr-structure