ContextualWisdomLab · seonghobae · Aug 12, 2026 · Aug 12, 2026
diff --git a/.jules/palette.md b/.jules/palette.md
@@ -65,3 +65,7 @@
 
 **Learning:** `<meta name="color-scheme" content="light dark">`는 페이지가 두 색상 체계를 지원한다는 사실을 알리지만, 지원 브라우저의 탭 바나 상태 표시줄 색상 자체를 각 체계에 맞춰 지정하지는 않습니다.
 **Action:** 생성 HTML에 light/dark `prefers-color-scheme` 미디어 조건이 있는 `theme-color` 메타데이터를 함께 내보내고, 두 정확한 값이 기존 `color-scheme`, CSP 및 robots 계약과 함께 유지되는지 회귀 테스트하십시오.
+
+## 2024-08-16 - 명확한 페이지 컨텍스트를 위한 문서 제목(Title) 개선
+**Learning:** 파일 서버 탐색 시 `<title>` 요소에 단순히 디렉토리 이름만 제공하면, 사용자가 여러 탭을 열어두었거나 화면 판독기를 통해 창을 전환할 때 해당 페이지가 '디렉토리 목록'임을 즉시 인지하기 어려워 접근성 및 사용성이 저하됩니다.
+**Action:** 항상 `<title>` 요소에 페이지의 목적을 명확히 알 수 있는 접미사(예: " - 디렉토리 목록")를 추가하여, 브라우저 탭 이름만으로도 컨텍스트를 제공할 수 있도록 하십시오.
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
@@ -410,7 +410,7 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
         <!-- 보안 향상: 리퍼러를 통한 디렉토리 경로 노출 방지 -->
         <meta name="referrer" content="no-referrer">
         <meta name="robots" content="noindex, nofollow">
-        <title>${directoryName.escapeHtml()}</title>
+        <title>${directoryName.escapeHtml()} - 디렉토리 목록</title>
         <style>${CSS_CONTENT}</style>
      </head>
      <body>

diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
@@ -942,7 +942,7 @@ class MainTest {
         val indexHtml = File(fakeRoot, "index.html")
         assertTrue(indexHtml.exists())
         val content = indexHtml.readText()
-        assertTrue(content.contains("<title>Root</title>"))
+        assertTrue(content.contains("<title>Root - 디렉토리 목록</title>"))
         assertTrue(content.contains("<h1>Root</h1>"))
     }