ContextualWisdomLab · seonghobae · Jul 8, 2026 · Jul 9, 2026 · Jul 11, 2026
diff --git a/.jules/palette.md b/.jules/palette.md
@@ -13,3 +13,7 @@
 ## 2024-06-25 - Directory Listing Navigation Landmark
 **Learning:** Generated directory listings act as navigation regions, and screen readers benefit when the listing is announced separately from the page's main content.
 **Action:** Wrap generated directory listing `<ul>` elements in `<nav aria-label="Directory listing">` while keeping the surrounding semantic `<main>` structure.
+
+## 2026-23-08 - ARIA Label Language Match
+**Learning:** Ensure that ARIA labels match the document's `lang` attribute. When `lang="ko"`, having English ARIA labels (like "Directory listing") causes screen readers to read English text with Korean pronunciation rules, leading to poor accessibility.
+**Action:** Always verify that semantic descriptors and ARIA labels are localized to match the document's primary language.
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
@@ -214,7 +214,7 @@ fun process_dir(curr_dir: File){
      <body>
        <main>
          <h1>${curr_dir.getName().escapeHtml()}</h1>
-         <nav aria-label="Directory listing">
+         <nav aria-label="디렉토리 목록">
          <ul>
             <li><a style="display:block; width:100%" href="./.." aria-label="상위 디렉토리로 이동"><span aria-hidden="true">&#x21B0;</span> ..</a></li>
 """ 

diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
@@ -148,7 +148,7 @@ class MainTest {
         assertTrue(indexFile.exists())
         val htmlContent = indexFile.readText()
         assertTrue(htmlContent.contains("<html lang=\"ko\">"))
-        assertTrue(htmlContent.contains("<nav aria-label=\"Directory listing\">"))
+        assertTrue(htmlContent.contains("<nav aria-label=\"디렉토리 목록\">"))
         assertTrue(htmlContent.contains("<main>"))
         assertTrue(htmlContent.contains("</main>"))
         assertTrue(htmlContent.contains("aria-label=\"상위 디렉토리로 이동\""))