Files

T

Antigravity Agent c24165b8bc refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조

에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-11 11:05:56 +09:00

5.3 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

title

브라우저 렌더링 파이프라인(Critical Rendering Path)

매 한 줄

"매 HTML/CSS/JS 의 화면 픽셀로 도달하는 순차적 stage chain". 매 Parse → Style → Layout → Paint → Composite 의 5단계 — 매 stage 의 cost 의 understand 의 LCP/INP/CLS 의 optimize 의 critical path.

매 핵심

매 5 stages

Parse: HTML → DOM, CSS → CSSOM (parallel, but CSS blocks render).
Style: DOM + CSSOM → Render Tree (visible nodes only — display:none excluded).
Layout (Reflow): geometry 계산 — x/y/width/height.
Paint: pixel 채우기 — color, image, shadow, text.
Composite: layer 합성 — GPU 의 transform/opacity 의 처리.

매 blocking resources

CSS: render-blocking — CSSOM 의 완성 의 wait.
JS (sync): parser-blocking — DOM 의 build 의 pause.
JS (async): 매 download parallel, execute when ready (parser pause).
JS (defer): 매 download parallel, execute after DOMContentLoaded.

매 layer-promote triggers

transform: translateZ(0) / will-change: transform.
position: fixed (modern Chromium).
<video>, <canvas>, animated transform/opacity.

💻 패턴

Critical CSS inlining

<head>
  <style>
    /* above-the-fold CSS only — 14KB 이내 */
    body { margin: 0; font-family: system-ui; }
    .hero { height: 100vh; background: #000; }
  </style>
  <link rel="preload" href="/main.css" as="style"
        onload="this.onload=null;this.rel='stylesheet'">
</head>

Composite-only animation (cheap)

/* O — composite layer 만 — 60fps 안정 */
.card { transition: transform 200ms, opacity 200ms; }
.card:hover { transform: translateY(-4px); opacity: 0.9; }

/* X — layout + paint trigger — jank */
.bad { transition: top 200ms, height 200ms; }

Reflow 의 batch (read-then-write)

// X — interleave read/write — forced reflow per write
elements.forEach(el => {
  const w = el.offsetWidth;          // read (force layout)
  el.style.width = (w * 2) + 'px';   // write (invalidate)
});

// O — batch read, then batch write
const widths = elements.map(el => el.offsetWidth);
elements.forEach((el, i) => el.style.width = (widths[i] * 2) + 'px');

Resource priority hint

<link rel="preload" href="/font.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preconnect" href="https://api.example.com">
<img src="/hero.jpg" fetchpriority="high">
<img src="/below-fold.jpg" loading="lazy" fetchpriority="low">

Web Vitals 의 측정 (PerformanceObserver)

new PerformanceObserver((list) => {
  for (const entry of list.getEntries()) {
    if (entry.name === 'first-contentful-paint') console.log('FCP', entry.startTime);
  }
}).observe({ type: 'paint', buffered: true });

new PerformanceObserver((list) => {
  const lcp = list.getEntries().at(-1);
  console.log('LCP', lcp.renderTime || lcp.loadTime);
}).observe({ type: 'largest-contentful-paint', buffered: true });

`content-visibility` (off-screen skip)

/* 매 viewport 밖 section 의 layout/paint 의 skip */
.section { content-visibility: auto; contain-intrinsic-size: 800px; }

`requestIdleCallback` 의 non-critical work

requestIdleCallback(() => {
  prefetchRoutes();
  reportAnalytics();
}, { timeout: 2000 });

매 결정 기준

상황	Approach
LCP 느림	Critical CSS inline + preload hero image + `fetchpriority="high"`
INP 느림	long task 의 break (`scheduler.yield()`), event handler 의 simplify
CLS 발생	image/iframe 의 width/height 의 명시, `font-display: optional`
Animation jank	`transform/opacity` 만 의 사용, `will-change` 의 sparingly
Long list	`content-visibility: auto` + `contain-intrinsic-size`

기본값: 매 Critical CSS inline (14KB), JS defer, image lazy + dimensions, transform-only animation.

🔗 Graph

부모: Web Vitals
응용: 성능 최적화(Reflow & Repaint)

🤖 LLM 활용

언제: Web Vitals regression 의 분석, layout thrash 의 detect, optimization 의 prioritize. 언제 X: Real User Monitoring (RUM) 의 raw data 의 aggregate (specialized tooling 의 use).

❌ 안티패턴

모든 element 에 will-change: 매 GPU memory 의 explosion — 매 sparingly.
Sync JS 의 <head>: 매 parser block — 매 defer 의 사용.
@import chain: 매 sequential CSS load — 매 <link> 의 use.
Layout-trigger animation: 매 top/left/width 의 transition — 매 transform 의 substitute.

🧪 검증 / 중복

Verified (web.dev/learn/performance, Chrome DevTools docs, Ilya Grigorik CRP).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — CRP 5 stages + composite animation + Web Vitals 의 정리

5.3 KiB Raw Blame History