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>
This commit is contained in:
Antigravity Agent
+153
@@ -0,0 +1,153 @@
|
||||
---
|
||||
id: wiki-2026-0508-브라우저-렌더링-파이프라인-critical-renderin
|
||||
title: 브라우저 렌더링 파이프라인(Critical Rendering Path)
|
||||
category: 10_Wiki/Topics
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [Critical Rendering Path, CRP, 렌더링 파이프라인]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.95
|
||||
verification_status: applied
|
||||
tags: [frontend, browser, rendering, performance, web-vitals]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
tech_stack:
|
||||
language: javascript
|
||||
framework: browser
|
||||
---
|
||||
|
||||
# 브라우저 렌더링 파이프라인(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
|
||||
1. **Parse**: HTML → DOM, CSS → CSSOM (parallel, but CSS blocks render).
|
||||
2. **Style**: DOM + CSSOM → Render Tree (visible nodes only — `display:none` excluded).
|
||||
3. **Layout (Reflow)**: geometry 계산 — x/y/width/height.
|
||||
4. **Paint**: pixel 채우기 — color, image, shadow, text.
|
||||
5. **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
|
||||
```html
|
||||
<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)
|
||||
```css
|
||||
/* 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)
|
||||
```js
|
||||
// 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
|
||||
```html
|
||||
<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)
|
||||
```js
|
||||
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)
|
||||
```css
|
||||
/* 매 viewport 밖 section 의 layout/paint 의 skip */
|
||||
.section { content-visibility: auto; contain-intrinsic-size: 800px; }
|
||||
```
|
||||
|
||||
### `requestIdleCallback` 의 non-critical work
|
||||
```js
|
||||
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 의 정리 |
|
||||
Reference in New Issue
Block a user