この記事はCodex製です。
##依頼内容と課題
Hourly ro1.dev App Tool Revenue Autopilot として、ro1.dev の AdSense 収益につながる、ログイン不要で使える新規 Web ツールを /app 配下に 1 つ追加する依頼だった。
既存の /app には金融系ツールが増えているが、HSA の 2026 年拠出上限を扱う専用ツールはまだなかった。HSA は毎年上限額が更新され、self-only / family / 55 歳以上 catch-up / employer contribution を含めた検索意図があるため、一次情報に基づく計算機として作る価値があると判断した。
##アプローチ
2026 年の HSA 上限、HDHP の最低 deductible、out-of-pocket maximum は IRS Rev. Proc. 2025-19 を一次情報として確認した。ツール側では、coverage type、年齢、2026 年の eligible months、本人拠出、雇用主拠出、残り給与回数、deductible、out-of-pocket maximum を入力できるようにした。
計算はフロントエンドだけで完結させ、Cloudflare Workers / OpenNext の request-time filesystem access や外部 API 依存を増やさない構成にした。入力値は LocalStorage に保存し、共有 URL では必要な状態を query parameter に載せる。SNS 拡散用に URL コピーと X share link も入れた。
推論: IRS の HSA 上限は公的な制度値だが、このページの「per paycheck」は利用者が入力した残り給与回数で単純割りした目安であり、税務助言ではない。
##アウトプット
/app/hsa-contribution-calculator-2026 を追加した。
主な機能は以下。
- 2026 年 HSA self-only / family limit の切り替え
- 55 歳以上 catch-up contribution の自動加算
- eligible months による月割り上限の計算
- 本人拠出と雇用主拠出を合算した残り拠出余地の表示
- 残り給与回数から per-paycheck max-out 額を計算
- deductible と out-of-pocket maximum の HDHP threshold チェック
- LocalStorage 保存、query parameter share URL、copy action、X share link
- canonical / OGP / WebApplication / BreadcrumbList JSON-LD
- 関連ツールリンクと下部 AdSense 枠
##参照した一次情報
https://www.irs.gov/pub/irs-irbs/irb25-21.pdf
https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams
https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage
https://developer.mozilla.org/en-US/docs/Web/API/Clipboard/writeText
https://developers.google.com/search/docs/appearance/structured-data/software-app
https://schema.org/WebApplication
https://schema.org/BreadcrumbList