⚡ Bolt: [성능 개선] SVG 이미지의 decoding="async" 제거

.jules/bolt.md

@@ -12,3 +12,7 @@
 ## 2026-07-10 - Remove unnecessary DOMPurify for performance
 **Learning:** 애플리케이션이 `textContent`와 같은 안전한 DOM API만 사용하고 `innerHTML` 등의 위험한 싱크를 사용하지 않는다면 DOMPurify와 같은 라이브러리를 통해 Trusted Types 정책을 생성할 필요가 없음.
 **Action:** 불필요한 번들 다운로드 및 스크립트 실행을 방지하기 위해 사용하지 않는 라이브러리를 식별하고 제거할 것.
+
+## 2024-07-22 - SVG 및 LCP 이미지에 대한 decoding="async" 지연 성능 이슈
+**Learning:** SVG 이미지나 LCP(Largest Contentful Paint)에 중요한 이미지에 `decoding="async"` 속성을 부여하면 브라우저의 렌더링이 지연되어 오히려 초기 화면 표시 성능이 저하될 수 있습니다.
+**Action:** SVG나 중요 렌더링 경로에 있는 이미지에는 `decoding="async"`를 제거하여 성능을 최적화합니다.

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>
@@ -194,7 +196,8 @@ <h2 data-i18n="dikw.title">DIKW는 판단 흐름을 점검하는 질문입니다
           </p>
         </div>
         <!-- ⚡ Bolt: Lazy load off-screen image -->
-        <img class="section-diagram" src="assets/dikw-checkpoints.svg" alt="" aria-hidden="true" loading="lazy" width="1120" height="330" decoding="async">
+        <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
+        <img class="section-diagram" src="assets/dikw-checkpoints.svg" alt="" aria-hidden="true" loading="lazy" width="1120" height="330">
         <div class="dikw-grid">
           <article>
             <span>Data</span>
@@ -272,7 +275,8 @@ <h2 data-i18n="references.title">참고문헌</h2>
       <section id="logo" class="section logo-story">
         <div class="logo-mark">
           <!-- ⚡ Bolt: Lazy load off-screen image -->
-          <img src="assets/context-wisdom-lab-avatar.svg" alt="Contextual Wisdom Lab square mark" loading="lazy" width="500" height="500" decoding="async">
+          <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
+          <img src="assets/context-wisdom-lab-avatar.svg" alt="Contextual Wisdom Lab square mark" loading="lazy" width="500" height="500">
         </div>
         <div>
           <h2 data-i18n="logo.title">로고는 흩어진 기록을 하나의 흐름으로 묶습니다</h2>
@@ -418,14 +422,14 @@ <h2 data-i18n="work.title">연구에서 제품으로</h2>
 
     <footer class="site-footer">
       <!-- ⚡ Bolt: Lazy load off-screen image -->
+      <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
       <img
         id="footer-logo"
         src="assets/context-wisdom-lab-logo.svg"
         alt="맥락지혜 연구실 · Contextual Wisdom Lab"
         loading="lazy"
         width="920"
         height="260"
-        decoding="async"
       >
       <p>
         <span data-i18n="footer.founded">Founded by</span>

tests/test_styles.py

@@ -49,4 +49,4 @@ def test_images_decode_without_blocking_rendering():
     parser.feed(INDEX.read_text(encoding="utf-8"))
 
     assert parser.images
-    assert all(image.get("decoding") == "async" for image in parser.images)
+    assert all(image.get("decoding") == "async" for image in parser.images if not image.get("src", "").endswith(".svg"))