⚡ Bolt: 최상단 SVG 이미지 LCP 성능 개선

.jules/bolt.md

@@ -12,3 +12,6 @@
 ## 2026-07-10 - Remove unnecessary DOMPurify for performance
 **Learning:** 애플리케이션이 `textContent`와 같은 안전한 DOM API만 사용하고 `innerHTML` 등의 위험한 싱크를 사용하지 않는다면 DOMPurify와 같은 라이브러리를 통해 Trusted Types 정책을 생성할 필요가 없음.
 **Action:** 불필요한 번들 다운로드 및 스크립트 실행을 방지하기 위해 사용하지 않는 라이브러리를 식별하고 제거할 것.
+## 2026-07-27 - LCP 최적화를 위한 초기 SVG 이미지의 동기 디코딩
+**Learning:** `decoding="async"`는 메인 스레드 블로킹을 방지하지만, 뷰포트 내(above-the-fold) 핵심 LCP 요소인 경우 오히려 렌더링을 지연시킬 수 있다.
+**Action:** 초기 렌더링에 필요한 중요 SVG 이미지에서는 `decoding="async"`를 제거하고, 오직 `loading="lazy"` 속성을 가진 오프스크린 이미지에만 비동기 디코딩을 적용한다.

CHANGELOG.md

@@ -1,6 +1,7 @@
 # CHANGELOG
 
 ## [Unreleased]
+- **성능 최적화**: 뷰포트 최상단 핵심 SVG 이미지들의 `decoding="async"` 속성을 제거하여 브라우저가 LCP(최대 콘텐츠 풀 페인트) 요소를 더 빠르게 렌더링할 수 있도록 개선했습니다.
 - **보안 개선**: 컴포넌트 갤러리의 인라인 스크립트와 스타일을 외부 파일로 분리하고, 엄격한 Content-Security-Policy를 적용해 XSS 방어를 강화했습니다.
 - **성능 회귀 복원**: 오프스크린 `.section` 렌더링을 `content-visibility: auto`로 지연하고, 일반 섹션은 600px·콘텐츠가 큰 DIKW/projects 섹션은 1000px의 `contain-intrinsic-size` placeholder를 유지해 초기 렌더링 비용과 스크롤바 이동을 함께 줄였습니다.
 - **보안 개선**: Trusted Types 기반 CSP 강화: 잠재적인 DOM 기반 XSS 공격을 방지하기 위해 `require-trusted-types-for 'script'` 지시어 추가

index.html

@@ -29,7 +29,8 @@
     <a href="#top" class="skip-link" data-i18n="nav.skipToContent">본문으로 건너뛰기</a>
     <header class="site-header">
       <a class="brand" href="#top" aria-label="Contextual Wisdom Lab home">
-        <img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44" decoding="async">
+        <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
+        <img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44">
         <span>Contextual Wisdom Lab</span>
       </a>
       <nav class="site-nav" aria-label="Primary navigation">
@@ -64,7 +65,8 @@ <h1 data-i18n="hero.title">맥락지혜 연구실</h1>
         </div>
 
         <div class="hero-visual">
-          <img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high" decoding="async">
+          <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
+          <img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high">
           <div class="ladder" role="list" aria-label="Data to wisdom ladder">
             <div class="ladder-row" role="listitem">
               <span>Data</span>

tests/test_styles.py

@@ -44,9 +44,18 @@ def test_tall_sections_reserve_larger_intrinsic_block_size():
 
 
 def test_images_decode_without_blocking_rendering():
-    """All site images opt into asynchronous decoding."""
+    """Site images opt into asynchronous decoding, except for LCP above-the-fold images."""
     parser = _ImageParser()
     parser.feed(INDEX.read_text(encoding="utf-8"))
 
     assert parser.images
-    assert all(image.get("decoding") == "async" for image in parser.images)
+    lazy_images = [img for img in parser.images if img.get("loading") == "lazy"]
+    critical_images = [img for img in parser.images if img.get("loading") != "lazy"]
+
+    # Critical above-the-fold images should NOT have async decoding for LCP optimization
+    for img in critical_images:
+        assert img.get("decoding") != "async", f"Critical image {img.get('src')} has decoding='async'"
+
+    # Lazy-loaded images must have async decoding
+    for img in lazy_images:
+        assert img.get("decoding") == "async", f"Lazy image {img.get('src')} missing decoding='async'"