logo hsb.horse

Architecture Decision Record

ADR

Short, structured decisions that capture why we chose a path.

By year

2026
Accepted #search #pagefind #architecture #i18n

Pagefind site search adoption policy

Adopt Pagefind for static full-text search and standardize localized search routes with build integration.

2026-02-08-008-pagefind-site-search
Accepted #content #glossary #blog #information-architecture #seo

Glossary introduction policy to separate blog posts and knowledge entries

Separate time-series posts in blog from long-lived reference content in glossary, with distinct URLs, collections, and index flows.

2026-02-08-009-glossary-content-separation-policy
Accepted #content #snippets #blog #information-architecture #seo

Snippets collection policy for lightweight practical notes

Separate practical notes that are too short for blog posts into snippets, with index/detail routes at /snippets and /{lang}/snippets.

2026-02-08-010-snippets-content-collection-design
Accepted #pwa #i18n

PWA manifest i18n strategy

Generate locale-specific manifests with localized lang/name/short_name.

2026-02-08-011-pwa-manifest-locale-strategy
Accepted #seo #metadata #aio #structured-data #i18n

SEO, metadata, and AIO optimization policy

Standardize title/description, canonical/hreflang, OGP/Twitter, and structured data to improve discoverability in both search and AI-generated summaries.

2026-02-07-005-seo-metadata-aio-strategy
Accepted #analytics #ga4 #partytown #performance #privacy

Partytown + Google Analytics (GA4) integration policy

Introduce GA4 (G-WZ3RT34EZZ) via Partytown to start pageview measurement while minimizing main-thread impact.

2026-02-07-006-partytown-google-analytics-integration
Accepted #tools #architecture #routing #i18n

Tool implementation structure policy

Define routing, feature boundaries, and i18n ownership for adding individual tools.

2026-02-07-007-tools-implementation-structure
Accepted #design #ux #responsive #tailwind

Screen-size layout policy (mobile-first)

Adopt a two-tier breakpoint mobile-first design as the standard.

2026-02-06-001-mobile-first-layout-policy
Accepted #tooling #quality #git-hook

Git Hook Automation with lefthook

Adopt lefthook to automatically run Biome formatting and linting at commit and push time.

2026-02-06-004-lefthook-git-hooks-automation
Accepted #astro #i18n #seo #architecture

i18n URL strategy for an Astro site

Keep Japanese as the default (root) and serve additional languages under subdirectory prefixes.

2026-02-05-001-astro-i18n-url-strategy
Accepted #tools #content #architecture

Tools catalog management

Manage the tools list with YAML Content Collection and build individual tools as implemented pages.

2026-02-05-002-tools-catalog-strategy
Accepted #blog #content #architecture

Blog content collection design

Define the schema and operating rules for managing blog posts in Markdown/MDX.

2026-02-05-003-blog-content-collection-design
Accepted #docs #process

ADR conventions

Define naming, language strategy, and listing schema.

2026-02-04-001-adr-structure