Merge pull request #12022 from KATO-Hiro/#12021

refactor: Optimize lychee link exclusion configuration (#12021)

Author: KATO-Hiro

.claude/rules/link-checking.md

@@ -0,0 +1,65 @@
+# Link Checking Guide
+
+## For Contributors: Writing Links
+
+### ❌ Do NOT Use HTML Comments
+
+Lychee ignores inline comments—they have no effect:
+
+```markdown
+<!-- markdown-link-check-disable -->
+[Link](https://example.com)  ← Still checked
+<!-- markdown-link-check-enable -->
+```
+
+### ✅ Write Standard Markdown
+
+```markdown
+[Title](https://example.com/path)
+```
+
+### CI Link Failures
+
+If a link fails in CI:
+
+1. Verify the URL is correct
+2. If unavailable, notify maintainers (don't use HTML comments)
+3. For entire pages with expected broken links, use config below
+
+---
+
+## For Maintainers: Configuration
+
+Exclude links via frequency-based judgment:
+
+### Domains (3+ occurrences) → `lychee.toml` `exclude`
+
+```toml
+exclude = [
+  "^https://www\\.estie\\.jp/",
+  "^https://openai\\.com/",
+]
+```
+
+### Pages (intentional broken links) → `lychee.toml` `exclude_path`
+
+```toml
+exclude_path = [
+  "docs/archived/broken_links\\.md",
+  "docs/archived/no_longer_available\\.md",
+]
+```
+
+### Individual URLs (<3 occurrences) → `.lycheeignore`
+
+```
+https://example.com/one-off-url
+https://another.example/specific-path
+```
+
+## When to Exclude
+
+- HTTP 403 (Forbidden) to automated requests
+- Authentication or cookies required
+- Rate limiting without retry support
+- Known dead links or archived mirrors

.claude/rules/tools.md

@@ -26,5 +26,5 @@
 
 | Tool | Version | Role | Constraints |
 |---|---|---|---|
-| lychee | 0.x (via lychee-action) | Automated link validation (GitHub Actions) | Configuration in `lychee.toml`. Do not run link checks locally with `curl` or `wget`. Weekly scheduled scan + PR checks. |
+| lychee | 0.x (via lychee-action) | Automated link validation (GitHub Actions) | Configuration in `lychee.toml` (domain patterns) and `.lycheeignore` (individual URLs). Does NOT support inline HTML comments (`<!-- markdown-link-check-disable -->`). See `.claude/rules/link-checking.md` for strategy. Weekly scheduled scan + PR checks. |
 | lychee-action | v2.8.0 | GitHub Actions integration for lychee | Used in `.github/workflows/` for link checking |

.github/workflows/link_checker.yml

@@ -2,7 +2,7 @@ name: Check Markdown links with scheduled job
 
 on:
   schedule:
-    - cron: "30 15 * * 2"  # Every Wednesday at 0:30 JST (Tue 15:30 UTC)
+    - cron: "30 15 * * 2" # Every Wednesday at 0:30 JST (Tue 15:30 UTC)
 
 jobs:
   lychee:
@@ -19,5 +19,6 @@ jobs:
 
       - uses: lycheeverse/lychee-action@8646ba30535128ac92d33dfc9133794bfdd9b411 # v2.8.0
         with:
-          args: --cache --max-cache-age 14d --quiet "docs/**/*.md" "monthly_changelog/**/*.md" "README.md" "CONTRIBUTING.md"
+          args: --cache --max-cache-age 14d --quiet "docs/**/*.md" "README.md"
+            "CONTRIBUTING.md"
           fail: true

.github/workflows/link_checker_for_modified_files.yml

@@ -1,6 +1,6 @@
 name: Check Markdown links for modified files
 
-on: [pull_request]
+on: [ pull_request ]
 
 jobs:
   lychee:
@@ -16,7 +16,6 @@ jobs:
         with:
           files: |
             docs/**/*.md
-            monthly_changelog/**/*.md
             README.md
             CONTRIBUTING.md
 
@@ -31,5 +30,6 @@ jobs:
       - uses: lycheeverse/lychee-action@8646ba30535128ac92d33dfc9133794bfdd9b411 # v2.8.0
         if: steps.changed-files.outputs.any_changed == 'true'
         with:
-          args: --cache --max-cache-age 14d --quiet ${{ steps.changed-files.outputs.all_changed_files }}
+          args: --cache --max-cache-age 14d --quiet ${{
+            steps.changed-files.outputs.all_changed_files }}
           fail: true

.lycheeignore

@@ -0,0 +1,11 @@
+http://127.0.0.1:8000/
+https://codepen.io/uchi8977/full/gbpGOzY
+https://codezine.jp/article/detail/23366
+https://dev.classmethod.jp/articles/atcoder_change_color_brown/
+https://dic.nicovideo.jp/a/%E3%83%9E%E3%83%AB%E3%82%B3%E3%83%95%E3%82%A2%E3%83%AB%E3%82%B4%E3%83%AA%E3%82%BA%E3%83%A0
+https://forest.watch.impress.co.jp/docs/news/1422840.html
+https://hackall.tech/
+https://levtech.jp/media/detail_831/
+https://nadesi.com/top/
+https://upura.github.io/everyday-kaggle-news/
+https://weeklykagglenews.substack.com

docs/archived/migrate_servers.md

@@ -4,8 +4,6 @@ title: サーバの移行中
 
 [Heroku](https://www.heroku.com)の無料プラン終了に伴い、サーバの移行が検討されているサービス・ツールなどを掲載しています。新しいサーバでの稼働を確認した段階で、元のページに戻す予定です。
 
-<!-- markdown-link-check-disable -->
-
 ## Webアプリ、Webサイト
 
 ### 問題を解く
@@ -68,5 +66,3 @@ title: サーバの移行中
     <div align="center">
       <img loading = "lazy" src="../../images/related_contest_sites/leetcode/leetcode_stats.png" alt="leetcode stats">
     </div>
-
-<!-- markdown-link-check-enable -->

docs/archived/outdated_information.md

@@ -85,8 +85,6 @@ title: 更新停止の可能性が高い
 
 ### コンテストの成績を見る
 
-<!-- markdown-link-check-disable -->
-
  - [AtCoder Heuristic Statistics](https://heuristic-statistics.herokuapp.com/) - [AtCoder Heuristic Contest](https://atcoder.jp/contests/archive?ratedType=0&category=1200&keyword=AtCoder+Heuristic+Contest)のレーティング分布を表示する。
 
     - 理由: 記載なし。
@@ -96,8 +94,6 @@ title: 更新停止の可能性が高い
       <img loading = "lazy" src="../../images/web_app/atcoder_heuristic_statistics.png" alt="atcoder heuristic statistics">
     </div>
 
-<!-- markdown-link-check-enable -->
-
 - [AtCoderマラソンランキング](https://tomerun.github.io/atcoder_marathon_ranking/index.html) - マラソン系コンテストの順位を[AtCoder レースランキング](https://atcoder.jp/posts/170)と同じ形式でポイント化し、ランキングをつける。
 
     - 理由: 記載なし。
@@ -170,8 +166,6 @@ title: 更新停止の可能性が高い
 
 ### コンテスト後の情報収集・発信
 
-<!-- markdown-link-check-disable -->
-
 - [AtCoder Friend Finder](http://atcoder-friend-finder.herokuapp.com/) - [Twitter](https://twitter.com/)でフォローしている[AtCoder](https://atcoder.jp/)ユーザを表示する。
 
     - 理由: 記載なし。
@@ -184,8 +178,6 @@ title: 更新停止の可能性が高い
     !!! warning "注意"
         2021年6月以降、更新が行われていない可能性がある。
 
-<!-- markdown-link-check-enable -->
-
 ## Bot
 
 ### 問題の解答状況・記録を確認する
@@ -365,8 +357,6 @@ title: 更新停止の可能性が高い
 
 ### コンテストに参加する
 
-<!-- markdown-link-check-disable -->
-
 - [Coder's Calendar](https://chrome.google.com/webstore/detail/coders-calendar/bageaffklfkikjigoclfgengklfnidll?hl=ja&gl=UA) - 開催予定のコンテスト情報を表示する。[Codechef](https://www.codechef.com/)、 [HackerEarth](https://www.hackerearth.com/)、[Hackerrank](https://www.hackerrank.com/)、[Topcoder](https://www.topcoder.com/)、[Codeforces](https://codeforces.com/)、[CSAcademy](https://csacademy.com/)、 [LeetCode](https://leetcode.com/)、[Kaggle](https://www.kaggle.com/)などにも対応している。
     - 確認した日: 2025/03/08
 
@@ -381,8 +371,6 @@ title: 更新停止の可能性が高い
       <img loading = "lazy" src="../../images/chrome_extension/coding_schedule.jpg" alt="coding schedule">
     </div>
 
-<!-- markdown-link-check-enable -->
-
 - [KONTESTS](https://chrome.google.com/webstore/detail/kontests/agpdemlkalmmeenclchlajdcmbcacoea?hl=ja&gl=UA) - コンテスト情報を表示する。[Codeforces](https://codeforces.com/)、Codeforces::Gym、[TopCoder](https://www.topcoder.com/)、[CSAcademy](https://csacademy.com/)にも対応している。
     - 確認した日: 2025/03/08
 
@@ -502,14 +490,10 @@ title: 更新停止の可能性が高い
 - [大実験！ChatGPTは競プロの問題を解けるのか (2024年5月版)](https://e869120.hatenablog.com/entry/2024/05/15/100804) - 筆者がオリジナルの問題を作成し、GPT-4oの回答性能を実験・調査している。
 - [競技プログラミングとChatGPTを含むAIについて](https://chokudai.hatenablog.com/entry/2022/12/07/161959) - [ChatGPT](https://openai.com/blog/chatgpt/)の公開に伴い、[AtCoder](https://atcoder.jp/)社長の[chokudai](https://twitter.com/chokudai)さんが個人的な見解を述べた記事。AIの実力、競技性や教育への影響、コンテストでの使用の是非などについて言及されている。
 
-<!-- markdown-link-check-disable -->
-
 - [ChatGPTに競技プログラミングさせてみた【AtCoder】](https://qiita.com/relu/items/6cc9467748d580f50cfd) - [ChatGPT](https://openai.com/blog/chatgpt/)を利用して、[AtCoder](https://atcoder.jp/)で出題された問題を解いている記事。
 - [GPT-4は青色コーダーの夢を見るか](https://qiita.com/autotaker1984/items/2929937cd1fea6137d1f) - [GPT-4](https://openai.com/research/gpt-4)を利用して、[AtCoder](https://atcoder.jp/)の過去問をどこまで解けるか調査した記事。AIで解くのが難しい問題の種類や競技プログラミングにおける活用の方向性についても言及されている。
 - [ChatGPT3.5&4.0で競技プログラミングAtCoderの問題のスキル推定を検証しました](https://note.com/chatgpt_nobdata/n/n2d5769ebb622) - AtCoder Beginners Contest (通称ABC)のA〜C問題を対象として、解くために必要なスキルを推定・検証している記事。
 
-<!-- markdown-link-check-enable -->
-
 ### 実装テクニックを学ぶ
 
 #### C&#43;&#43;

docs/articles/algorithm.md

@@ -135,9 +135,7 @@ title: アルゴリズムを学ぶ
 
 - [LISでも大活躍！ DPの配列使いまわしテクニックを特集](https://qiita.com/drken/items/68b8503ad4ffb469624c) - 動的計画法において、配列を再利用することで、メモリの節約や根本的な計算量の改善につなげる方法をまとめた記事。ナップサック問題や最長増加部分列問題などが題材として扱われている。
 - [知名度がいまいち分かってないNextDPというテクニックについて](https://qiita.com/H20/items/922cc0a17ba5817f26d7) - 直前の状態のみ関心があり、そこから遷移する場合に高速化・省メモリ化を図る方法・Pythonの実装例が紹介されている。
-<!-- markdown-link-check-disable -->
 - [DP高速化:累積和](https://drken1215.hatenablog.com/archive/category/DP%E9%AB%98%E9%80%9F%E5%8C%96%3A%E7%B4%AF%E7%A9%8D%E5%92%8C) - [drken](https://atcoder.jp/users/drken)さんによる過去問の解説集。動的計画法を用いる問題の計算量改善に累積和が効果的な例題がまとめられている。
-<!-- markdown-link-check-enable -->
 
 ### 全方位木DP
 

docs/articles/club_activities.md

@@ -29,12 +29,8 @@ title: 部活・サークル・同好会・オンサイトイベントに参加
 - [実装力底上げを目指して、社内で「バーチャルコンテスト」を開催している話](https://note.com/dev_onecareer/n/n5f486629806d) - 株式会社ワンキャリアの有志がさらなる技術力向上を目指して、社内バーチャルコンテストの企画・実践内容を紹介した記事。
 - [社内ヒューリスティックコンテスト@アルゴ合宿2023 開催レポート](https://media.algo-artis.com/posts/bN4vP1cR) - 株式会社 ALGO ARTISの合宿で社内ヒューリスティックコンテストが開催された経緯・当日の様子・問題の解法まで紹介されている。
 
-<!-- markdown-link-check-disable -->
-
 - [AtCoder のコンテストスポンサーを通して、「とにかく強い仲間を集めたい」「もっと良い仕組みを作り、世の中の豊かさを増やしたい」「本気で物事に取り組んできた人に門戸を広げたい」と、叶えたいことを全てやろうとする話](https://www.estie.jp/blog/entry/2025/10/16/122042) - 株式会社estie の有志がAtCoderでのコンテスト開催・スポンサー活動を通して実現したいことや、それらの活動の背景にある思いがつづられている。
 
-<!-- markdown-link-check-enable -->
-
 ## セミナーの開催案内
 
 - [2026年度 第1回ORセミナー『競技プログラミングとOR: 研究と実務に活かす競プロスキル』](https://smms.kktcs.co.jp/smms2/event/orsj/92) - 競技プログラミングの面白さ・取り組む意義に加えて、研究や実務での活用事例が紹介される予定。
@@ -53,35 +49,23 @@ title: 部活・サークル・同好会・オンサイトイベントに参加
 
 #### 2025
 
-<!-- markdown-link-check-disable -->
-
 - [CodeQUEEN 2025 に協賛しました！弊社メンバーが入賞しました！](https://www.estie.jp/blog/entry/2025/08/06/101041) - [CodeQUEEN 2025 決勝](https://atcoder.jp/contests/codequeen2025-final-Public)の協賛者による当日レポート。入賞者のコメントやスポンサーとしての活動内容がまとめられている。
 
-<!-- markdown-link-check-enable -->
-
 - [CodeQUEEN 2025 参加記](https://momoharahara.hatenadiary.com/entry/2025/08/03/003143) - 同大会の優勝者による参加記。予選突破から決勝参加までの練習方針と内容、当日のコンテストや懇親会・オフ会などを振り返っている。
 - [CodeQUEEN2025決勝に出場しました！【4位！】](https://ayuna-stpyko.github.io/my_blog/archive/20250806.html)、[CodeQUEEN2025の決勝に行った話](https://note.com/rieul/n/nc12ca268c87c) - 同大会決勝の入賞者・参加者による参加記。予選通過前後の状況・大会直前の練習内容・当日のコンテストの考察と振り返り・懇親会・オフ会などに言及されている。
 
 #### 2024
 
-<!-- markdown-link-check-disable -->
-
 - [「CodeQUEEN 2024」決勝にスポンサーとして参加してきました！](https://note.e-seikatsu.info/n/n58a992f584f4) - 昨年に続き、[CodeQUEEN 2024 決勝](https://atcoder.jp/contests/codequeen2024-final-N9tn8QqD)の協賛者が当日を振り返った記事。主にコンテストの表彰式・懇親会について言及している。
 
-<!-- markdown-link-check-enable -->
-
 - [総勢217名の女性競技プログラマーが参加　女性競技プログラミングコンテスト「CodeQUEEN」結果発表](https://prtimes.jp/main/html/rd/p/000000048.000028415.html) - 同コンテストの開催経緯と優勝者・上位入賞者のコメントがまとめられている。
 - [CodeQUEEN2024で優勝しました](https://www.forcia.com/blog/002983.html) - 同コンテストの優勝者が当日を振り返った参加記。配点に基づいた戦略・各問題の図解に加え、スポンサー活動にも言及されている。
 - [CodeQUEEN 2024参加記](https://momoharahara.hatenadiary.com/entry/2024/08/07/122348) - [CodeQUEEN 2024 決勝](https://atcoder.jp/contests/codequeen2024-final-N9tn8QqD)の参加記。本番までの練習内容・コンテスト当日の振り返り・各種イベント・オフ会などについてまとめられている。
 
 #### 2023
 
-<!-- markdown-link-check-disable -->
-
 - [「CodeQUEEN 2023」にスポンサーとしておじゃましてきました！](https://note.e-seikatsu.info/n/n423fde3ccf32) - [CodeQUEEN 2023 決勝](https://atcoder.jp/contests/codequeen2023-final-open)の協賛者が当日を振り返った記事。スポンサー参加の経緯、会場のスナップショット、スポンサーセッション、座談会、コンテストおよび結果発表・表彰式、懇親会の様子がまとめられている。
 
-<!-- markdown-link-check-enable -->
-
 - [CodeQUEEN2023でスポンサーをしたり優勝したりした話](https://www.forcia.com/blog/002760.html) - [CodeQUEEN 2023 決勝](https://atcoder.jp/contests/codequeen2023-final-open)に、個人と会社の両方の立場からイベントの参加内容を報告している記事。スポンサー参加までの経緯やコンテストの振り返りだけでなく、同イベントから高校生のインターンの受け入れと実務的な成果につながったことも言及されている。
     - [CodeQUEEN2023決勝に出場しました！](https://ayuna-stpyko.github.io/my_blog/archive/20231023.html)、[女性オンリーオンサイトイベント【CodeQUEEN 2023】に参加した話](https://d-burioden.hateblo.jp/entry/2023/10/23/220439)、[CodeQUEEN 2023 決勝 参加記](https://abvi.hatenablog.com/entry/2024012600) - 同イベントの参加記。オンサイトイベントへの参加決定までの経緯・コンテストの振り返り・各種イベント・オフ会などについてまとめられている。
 

docs/articles/heuristic.md

@@ -194,12 +194,8 @@ title: ヒューリスティック問題を解く
 
 #### コンテスト企画者の振り返り
 
-<!-- markdown-link-check-disable -->
-
 - [企画者目線で振り返るestie プログラミングコンテスト2022](https://www.estie.jp/blog/entry/2022/12/14/110000) - [matsu7874](https://atcoder.jp/users/matsu7874)さんが、企画・運営の立場から[estie プログラミングコンテスト2022（AtCoder Heuristic Contest 014）](https://atcoder.jp/contests/ahc014)を振り返った記事。
 
-<!-- markdown-link-check-enable -->
-
 - [ALGO ARTISプログラミングコンテスト writerインタビュー  アルゴリズムエンジニア松尾が語るコンテストの舞台裏](https://media.algo-artis.com/posts/8A4hMugo) - [ALGO ARTIS プログラミングコンテスト2023（AtCoder Heuristic Contest 020）](https://atcoder.jp/contests/ahc020)のwriterである[terry_u16](https://atcoder.jp/users/terry_u16)さんへのインタビュー記事。コンテスト開催までの経緯、問題の作成・調整の過程とコンテスト当日の状況などがまとめられている。
     - [1000人を熱狂させる問題はこうして作る – AHC Writer の奮闘記](https://note.com/algoartis/n/na09ebec91106) - [ALGO ARTIS プログラミングコンテスト2025 冬（AtCoder Heuristic Contest 041）](https://atcoder.jp/contests/ahc041)における問題の準備からコンテスト当日までの流れが時系列順に紹介されている。
 
@@ -245,11 +241,7 @@ title: ヒューリスティック問題を解く
 
 - [AWS上にマラソンマッチ用のジャッジ環境を作った](https://yunix-kyopro.hatenablog.com/entry/2022/07/02/134251) - ヒューリスティック型コンテストにおいて、大量のテストケースをAWS環境で処理する方法が紹介されている記事。
 
-    <!-- markdown-link-check-disable -->
-
-    - [「AWS上にマラソンマッチ用のジャッジ環境を作った」をChatGPTに投げて、Lambdaを使ったAHC用のジャッジ環境を作る。](https://shindannin.hatenadiary.com/entry/2023/06/19/100655) - [ChatGPT](https://openai.com/blog/chatgpt/)による質問・回答を繰り返しながら、AWS環境の構築過程とエラーへの対処方法が紹介されている。
-
-    <!-- markdown-link-check-enable -->
+        - [「AWS上にマラソンマッチ用のジャッジ環境を作った」をChatGPTに投げて、Lambdaを使ったAHC用のジャッジ環境を作る。](https://shindannin.hatenadiary.com/entry/2023/06/19/100655) - [ChatGPT](https://openai.com/blog/chatgpt/)による質問・回答を繰り返しながら、AWS環境の構築過程とエラーへの対処方法が紹介されている。
 
 - [私のスコア問題評価環境](https://topcoder-tomerun.hatenablog.jp/entry/2024/04/06/201915) - [tomerun](https://atcoder.jp/users/tomerun)さんが、大量のテストケースを低価格で評価する方法(AWS Batch)を紹介している。