c24165b8bc
에이전트 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>
5.1 KiB
5.1 KiB
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
| 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 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wiki-2026-0508-레이아웃-스래싱-layout-thrashing | 레이아웃 스래싱 (Layout Thrashing) | 10_Wiki/Topics | verified | self |
|
none | A | 0.9 | applied |
|
2026-05-10 | pending |
|
레이아웃 스래싱 (Layout Thrashing)
매 한 줄
"매 layout thrashing = read DOM geometry → write style → read DOM 매 반복 — 매 force sync layout 매번". 매 브라우저 매 batch reflow 의 X — 매 즉시 reflow 강제 — 매 100x 느림. 매 해결 = 매 read 모두 batch → 매 write 모두 batch.
매 핵심
매 트리거 (read = force layout)
offsetTop/Left/Width/Height.clientTop/Left/Width/Height.scrollTop/Left/Width/Height.getBoundingClientRect().getComputedStyle()(some properties).innerText(특정 case).
매 메커니즘
- 매 write (
el.style.x = ...) — 매 layout invalidate, 매 brower 매 batch 대기. - 매 read (
el.offsetWidth) — 매 latest geometry 필요 — 매 강제 reflow. - 매 loop 안 read/write alternate — 매 매번 reflow — 매 thrashing.
매 해결
- Batch: read 모두 → write 모두.
- Cache: 매 1회 read, 매 변수 저장.
- rAF: read in current frame, write in next frame.
- FastDOM library — read/write queue.
- CSS containment:
contain: layout— 매 thrashing 매 isolate.
💻 패턴
Anti — 매 thrashing
const items = document.querySelectorAll('.item');
items.forEach(el => {
// 매 read → 매 write → 매 read → 매 write — 매 thrashing
el.style.width = el.offsetWidth + 10 + 'px';
});
// 매 100 items → 매 100 layouts
Fix — batch
const items = document.querySelectorAll('.item');
// 매 phase 1: read 모두
const widths = Array.from(items).map(el => el.offsetWidth);
// 매 phase 2: write 모두
items.forEach((el, i) => {
el.style.width = widths[i] + 10 + 'px';
});
// 매 1 layout
rAF read/write split
function syncSizes() {
// 매 current frame: read
const heights = Array.from(rows).map(r => r.offsetHeight);
requestAnimationFrame(() => {
// 매 next frame: write
rows.forEach((r, i) => {
r.style.minHeight = heights[i] + 'px';
});
});
}
FastDOM
import fastdom from 'fastdom';
fastdom.measure(() => {
const w = el.offsetWidth;
fastdom.mutate(() => {
el.style.width = w + 10 + 'px';
});
});
// 매 internally batch — 매 1 layout per frame
ResizeObserver (매 read 필요 X)
const ro = new ResizeObserver(entries => {
for (const entry of entries) {
const { width, height } = entry.contentRect; // 매 already computed
entry.target.dataset.width = width; // 매 write — 매 layout 의 X
}
});
ro.observe(element);
CSS Containment (isolate)
.widget {
contain: layout; /* 매 widget 내부 변경 — 매 outer 매 reflow 의 X */
}
DevTools 측정
performance.mark('layout-start');
heavyOperation();
performance.mark('layout-end');
performance.measure('layout', 'layout-start', 'layout-end');
// 매 DevTools Performance panel — 매 purple "Layout" bar — 매 thrashing 표시
Virtual list (대량 item)
// 매 모든 item layout — 매 X
// 매 visible 만 render — 매 react-virtual / @tanstack/virtual
import { useVirtualizer } from '@tanstack/react-virtual';
const rowVirtualizer = useVirtualizer({
count: 10000,
getScrollElement: () => parentRef.current,
estimateSize: () => 40,
});
매 결정 기준
| 상황 | 접근 |
|---|---|
| Loop 안 size 읽고 변경 | batch read → batch write |
| 비동기 read/write | rAF split |
| Element resize 감지 | ResizeObserver |
| Component-level isolation | contain: layout |
| 1000+ rows | Virtualization |
| Library 매 abstraction | FastDOM |
기본값: read all → write all + 매 ResizeObserver (size 감지) + 매 Virtual list (대량).
🔗 Graph
- 부모: 리플로우 및 리페인트(Reflow and Repaint) · Web Performance
- 변형: Forced Synchronous Layout
- Adjacent: ResizeObserver
🤖 LLM 활용
언제: jank 디버깅, "왜 scroll 느림", DevTools Performance 분석. 언제 X: 매 framework-specific (React reconciler) 내부 — 매 framework docs.
❌ 안티패턴
- Loop 안 read+write: 매 thrashing 의 정의.
offsetWidthafter style write: 매 force layout.- jQuery
.css()chain: 매 read/write 매 mix. scrollToppolling rAF: 매 ScrollObserver/IntersectionObserver 의 사용.- 모든 row layout 매 손수: 매 virtual list 의 사용.
🧪 검증 / 중복
- Verified (web.dev Avoid Layout Thrashing, Paul Irish gist, Chrome DevRel).
- 신뢰도 A.
🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — read/write batch + rAF + ResizeObserver |