위키 콘텐츠 및 작업 규칙 정비

- wiki/ 초기 페이지 추가 (index, log, 주요 개념 9종) - Output/, wiki/ 하위 CLAUDE.md 규칙 파일 추가 - .gitignore 추가 (.obsidian, .claude, raw, Backup 등 제외) - CLAUDE.md 프로젝트 규칙 갱신 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 11:14:46 +09:00
parent 9d0e948bfd
commit 0324c6d102
14 changed files with 565 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,13 @@
+# Obsidian & editor workspace
+.obsidian/
+.claude/
+.usage/
+
+# Local backups
+Backup/
+
+# Raw sources (license/ownership concerns — not redistributed)
+raw/
+
+# Default Obsidian welcome note
+환영합니다!.md
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -39,3 +39,24 @@
  3. 선형·GIS 기반 좌표계
  자료 편입 시 이 원칙 중 최소 하나와 연결되는지 확인.
 - **MVP 원칙:** 기능은 좁힘 + 품질·아키텍처는 타협 없음. 철근 설계는 v2로 미룸.
+
+## 위키 운영 규칙 (Karpathy LLM Wiki 패턴)
+
+폴더 구조:
+- `raw/` — **불변 원본.** 인풋 유형별 하위 폴더(ai-research/papers/standards/tools/notes). 이 아래 파일은 **절대 수정·삭제 금지.**
+- `wiki/` — **AI가 컴파일하는 위키 페이지.** 여기만 생성/수정 가능. `index.md`, `log.md` 포함.
+- `Output/` — **결과물** (아키텍처 문서, 코드 초안, 조사 보고서 등).
+
+**10대 규칙:**
+1. `raw/`는 절대 수정 금지 (불변 원본).
+2. wiki 페이지 생성·삭제 시 `wiki/index.md` 필수 업데이트.
+3. 모든 오퍼레이션마다 `wiki/log.md`에 기록.
+4. 내부 참조는 **wikilink** 형식 (`[[페이지명]]`).
+5. 모든 wiki 페이지 상단에 **YAML frontmatter** (title, tags, sources, updated).
+6. 모순 발견 시 **양쪽 소스 모두 인용.**
+7. 소스 요약은 **사실만**, 해석은 개념 페이지에서.
+8. 질의 시 `wiki/index.md` 먼저, `raw/`는 마지막 수단.
+9. **새 페이지보다 기존 페이지 업데이트 우선.**
+10. `index.md` 항목은 **한 줄, 120자 이내.**
+
+각 주요 폴더의 세부 규칙은 해당 폴더의 `CLAUDE.md` 참조.
--- a/Output/CLAUDE.md
+++ b/Output/CLAUDE.md
@@ -0,0 +1,14 @@
+# Output/ — 결과물 저장소
+
+`wiki/`의 지식을 활용해 만들어지는 산출물.
+
+## 하위 구성 (생기는 대로 추가)
+- `architecture/` — 아키텍처 설계 문서 (예: 파라메트릭 엔진 모듈 구성).
+- `code/` — 코드 초안·프로토타입 (알고리즘 구현, 자료구조 실험).
+- `specs/` — 기능 스펙, API 설계.
+- `reports/` — 조사 보고서, 비교 분석, 의사결정 기록.
+
+## 규칙
+- 각 산출물 상단에 **출처 위키 페이지**(wikilink)와 **잠정 설계 원칙 연결**을 명시.
+- 산출물이 변경되면 관련 위키 페이지도 재검토.
+- 큰 의사결정은 `reports/`에 ADR(Architecture Decision Record) 형식으로 남김.
--- a/wiki/CLAUDE.md
+++ b/wiki/CLAUDE.md
@@ -0,0 +1,39 @@
+# wiki/ — AI 컴파일 위키
+
+## 파일 종류
+- `index.md` — 모든 위키 페이지의 한 줄 인덱스 (120자 이내).
+- `log.md` — 모든 오퍼레이션(생성·수정·삭제) 기록.
+- `{페이지}.md` — 개념/주제별 위키 페이지.
+
+## 페이지 작성 규칙
+
+모든 위키 페이지는 **YAML frontmatter**로 시작:
+
+```yaml
+---
+title: 페이지 제목
+tags: [tag1, tag2]
+sources:
+  - raw/ai-research/2026-04-14_xxx.md
+  - raw/papers/yyy.pdf
+updated: 2026-04-14
+principles: [비패밀리, 증분, 선형-GIS]  # 잠정 설계 원칙과 연결 (해당 시)
+---
+```
+
+- 내부 링크는 **wikilink**: `[[B-Spline]]`, `[[거더교]]`.
+- 소스를 요약할 때는 **사실만**. 해석·추론은 개념 페이지의 "해석" 섹션에서, 출처를 명시하며.
+- 모순되는 소스가 있으면 **양쪽 모두 인용**하고 차이를 기록.
+- **새 페이지보다 기존 페이지 업데이트를 우선.** 기존 페이지가 있는지 `index.md`에서 먼저 확인.
+
+## 오퍼레이션 규칙
+
+위키 페이지를 생성·수정·삭제할 때마다:
+1. `index.md`를 업데이트한다 (생성/삭제 시).
+2. `log.md`에 한 줄 기록한다.
+
+## 질의 응답 시
+- **먼저 `index.md`를 읽는다.**
+- 필요한 페이지만 열어본다.
+- 위키에 없으면 `raw/`를 검색한다 (최후의 수단).
+- 답변 후 새로 알게 된 것이 있으면 위키 페이지를 업데이트한다.
--- a/솔버.md
+++ b/솔버.md
@@ -0,0 +1,54 @@
+---
+title: GCS 기하학적 구속조건 솔버 (Geometric Constraint Solver)
+tags: [solver, GCS, D-Cubed, constraint, geometry]
+sources:
+  - raw/ai-research/레빗(Revit) 파라메트릭 모델링의 핵심 솔버(Solver)와 연산 아키텍처에 관한 심층 연구.md
+  - raw/ai-research/Google AI Ultra 로 업그레이드시 구현가능성.md
+updated: 2026-04-14
+principles: [증분]
+---
+
+# GCS 기하학적 구속조건 솔버 (Geometric Constraint Solver)
+
+## 요약
+GCS는 점·선·곡선 등 유클리드 객체에 부여된 거리·각도·직교·접선 등의 제약조건을 **모두 만족하는 좌표값**을 대화형 속도로 할당하는 대수학적 솔버. 산업 표준은 **Siemens D-Cubed 2D/3D DCM** (개발: John Owen, EGS → UGS → Siemens).
+
+## 사실 (Facts)
+
+### 문제의 수학적 성격
+- 본질은 **다변수 비선형 연립방정식**을 대화형 속도로 푸는 문제.
+- 주된 전략: **"방향성 대수적 그래프 축소 기법(Graph-reduction directed algebraic approach)"**.
+
+### 해결 절차 (2단계)
+1. **제약조건 그래프 분석:** 객체=노드, 제약=엣지로 그래프 생성 → 풀기 쉬운 하위 문제로 분해(Decomposition), 해결 계획(Solution Plan) 수립.
+2. **수치 해석 수행:** 비선형 구속은 반복 수치해석으로 수렴. 기법: **Newton-Raphson, Gauss-Newton, Levenberg-Marquardt**.
+
+### 자코비안 행렬 분석
+- 편미분 **Jacobian** 행렬의 **랭크 분석**으로 현재 형상의 **자유도(DOF)**를 실시간 계산.
+- 이를 통해 **완전 구속 / 불완전 구속(under-constrained) / 과구속(over-constrained)** 상태를 진단.
+- 과구속 시 **중복 구속(Redundancy)** 식별 후 경고.
+
+### 불가능 토폴로지 예외 처리
+- 예: 삼각형에서 두 변의 합 < 나머지 한 변이면 즉시 "조건 만족 불가"로 연산 중단.
+
+### 구동/피구동 차원 (Driving / Driven)
+- 사용자 입력이 형상을 제어하는 구동 치수 vs 결과로 도출되는 피구동 치수의 **위계**를 솔버가 설정.
+
+### D-Cubed 컴포넌트 (Revit 채택)
+- **2D DCM** — 치수·평면 구속 (Revit 스케치/패밀리 에디터의 핵심).
+- **3D DCM** — 공간 구속.
+- **CDM** — 충돌 진단(Collision Detection Manager). BVH 등 공간 분할 + 정밀 부동소수점 제어 기반.
+- **PGM** — 프로파일 형상 관리(Profile Geometry Manager). 견고한 위상 처리(B-rep, Half-edge 등) 요구.
+
+### 자체 구현 난이도 (출처 2)
+- D-Cubed 류 솔버를 밑바닥부터 구현하려면: 그래프 분해·비선형 수치해석·Jacobian 분석 + B-rep/Half-edge 위상 시스템 + BVH 충돌 엔진. **전문 수학자·엔지니어가 수년간** 매달려야 하는 기반 기술 영역.
+
+## 해석 (Interpretation)
+
+- 토목용 파라메트릭도 GCS가 필요하되, **선형(alignment)과 GIS 좌표계에 내재된 구속**을 일급 시민으로 다뤄야 한다. Revit의 GCS는 평면 건축 스케치를 전제로 최적화되어 있어 선형 기반 토목 구속의 일관된 표현에는 빈틈이 있을 수 있음.
+- 자체 구현은 비현실적일 가능성이 크다 → **기존 커널(D-Cubed 라이선스, OpenCascade 오픈소스 등)과의 통합 전략**을 라이선스·비용 관점에서 조사 필요.
+- **증분 인터랙티브 원칙**과 관련: 그래프 분해 단계가 효율적일수록 증분 재계산이 가능. 분해·계획(Solution Plan)의 재사용성이 핵심 설계 포인트.
+
+## 관련 페이지
+- [[Revit 파라메트릭 아키텍처]]
+- [[PCE 파라메트릭 변경 엔진]]
--- a/엔진.md
+++ b/엔진.md
@@ -0,0 +1,65 @@
+---
+title: PCE 파라메트릭 변경 엔진 (Parametric Change Engine)
+tags: [solver, PCE, dependency-graph, DAG, propagation]
+sources:
+  - raw/ai-research/레빗(Revit) 파라메트릭 모델링의 핵심 솔버(Solver)와 연산 아키텍처에 관한 심층 연구.md
+  - raw/ai-research/Google AI Ultra 로 업그레이드시 구현가능성.md
+updated: 2026-04-14
+principles: [증분]
+---
+
+# PCE 파라메트릭 변경 엔진 (Parametric Change Engine)
+
+## 요약
+Revit의 거시 계층 엔진. 모델 내 모든 매개변수·요소의 관계를 **종속성 그래프(Graph of Dependencies)**로 유지하고, 변경을 연쇄 전파해 뷰·도면·일람표의 **양방향 연관성(Bidirectional Associativity)**을 보장. 오토데스크 독자 개발.
+
+## 사실 (Facts)
+
+### 종속성 그래프와 전파 메커니즘
+1. **상태 변경(Triggering):** 사용자가 파라미터를 수정.
+2. **연쇄 전파(Propagation):** PCE가 그래프를 추적해 종속 노드를 **무효화(Invalidated)** 마킹.
+3. **재평가(Re-evaluation):** 무효 노드 재계산. 기하 갱신이 필요하면 [[GCS 기하학적 구속조건 솔버|GCS(D-Cubed)]] 호출.
+
+### 바인딩 구조
+- Revit 객체는 **절대 좌표가 아닌 상대값 + 호스트-게스트(Host-Hosting) 관계**로 바인딩.
+- 모든 객체·주석·치수선은 단일 빌딩 모델 DB의 **포인터** 역할.
+
+### DAG 요구사항과 순환 의존성
+- 종속성 그래프는 **Directed Acyclic Graph (DAG)** 이어야 함.
+- 매개변수 A→B→C→A 순환 발생 시 솔버는 **교착 상태(Deadlock) / 무한 루프**에 빠짐 → 시스템 크래시 가능.
+- Revit은 입력 단계에서 **구문 분석 + 위상 정렬(Topological sorting)**로 순환 감지 시 "Cyclic dependency exists" 에러를 반환하고 **하향식 강제 차단**.
+- 부작용: 자기 참조적(Self-referential) 피드백 루프 생성을 원천 차단 → 설계 자유도 제약.
+
+### 성능 병목 — 직렬화(Serialization)
+- 그래프 연산은 **본질적으로 직렬화**: A의 결과가 나와야 B, B가 나와야 C.
+- 따라서 **멀티스레드·GPU 가속의 한계.** 단일 코어 CPU **클럭 속도 + L1/L2/L3 캐시** 성능이 최대 병목.
+- Nav isworks 간섭검토(단순 기하 충돌)가 GPU 가속되는 것과 대조적.
+- MEP 네트워크처럼 긴 종속 사슬이 있으면 성능이 극도로 저하.
+
+### 외부 엔진과의 충돌
+- **FEM (구조해석):** Revit은 형태 중심, Robot Structural Analysis 등은 중심축 기반 분석 모델 필요 → 변환 시 파라메트릭 논리 손실 · 편심(Eccentricity) 정보 불일치.
+- **에너지/환경 최적화:** 수만 번 반복 필요 → 매 반복마다 전체 종속성 그래프 재구축 → 시뮬레이션 시간 기하급수적 증가. 실무자는 **Dynamo / Grasshopper**로 우회.
+
+### 자체 구현 시 소프트웨어 공학적 난제 (출처 2)
+- 순환 의존성 통제(실시간 구문 분석 + 위상 정렬 안전장치).
+- 단일 코어 CPU 캐싱을 극한으로 끌어올리는 **C++/Rust 기반 메모리 아키텍처** 필요.
+
+### HFDM / Project Quantum (미래 방향)
+- Autodesk Amar Hanspal·Brian Mathews가 주도. 이후 **Plasma / AEC Data Model API**로 계승.
+- **고주파 데이터 관리(High-Frequency Data Management)**: 파일(RVT) 단위 트랜잭션 → 클라우드 기반 객체 단위 분산.
+- 효과: 종속성 재계산을 **마이크로서비스·클라우드 노드로 병렬 분산** → CPU 병목 해소.
+- 솔버가 **오픈 API 마이크로서비스**로 진화 (Speckle 등 오픈소스 협업 데이터 허브와 결합).
+
+## 해석 (Interpretation)
+
+- PCE의 직렬화 병목은 우리 **증분 인터랙티브 파라메트릭** 원칙이 정면으로 돌파해야 할 지점. 토목은 선형에 수백~수천 객체가 종속되므로 Revit식 접근은 스케일 문제.
+- 대안 탐색 방향:
+  1. **증분 갱신 알고리즘** — 전체 DAG 재평가 대신 변경의 영향 경계(영향권, cone of influence)만 재계산. 반응형 프로그래밍(Reactive Programming), Incremental Computation 문헌 조사 필요.
+  2. **데이터 지역성 최적화** — Rust 재설계 검토 중인 엔진은 메모리 배치(Structure-of-Arrays, Entity-Component 등)로 캐시 효율 극대화 가능.
+  3. **분산 아키텍처** — HFDM 방향성을 처음부터 반영하면 로컬/클라우드 하이브리드가 가능.
+- 순환 의존성 차단은 정책적으로 동의. 다만 토목은 선형·지형과 구조물 간 양방향 상호작용이 자연스러우므로 **"순환처럼 보이지만 실제로는 고정점(fixed-point) 수렴 문제"**를 구분해 다룰 필요가 있을 수 있음.
+
+## 관련 페이지
+- [[Revit 파라메트릭 아키텍처]]
+- [[GCS 기하학적 구속조건 솔버]]
+- [[파라메트릭 취약성 Davis 5가지]]
--- a/wiki/Revit
+++ b/wiki/Revit
@@ -0,0 +1,49 @@
+---
+title: Revit 조립 단위 분류 (Family / Group / Assembly / Parts / In-Place)
+tags: [revit, assembly, family, group, parts, non-family]
+sources:
+  - raw/ai-research/2026-04-14T100417+0900_Revit X 방식 말고,  BIM 모델링, 비(非)패밀리 조립 단위.md
+updated: 2026-04-14
+principles: [비패밀리]
+---
+
+# Revit 조립 단위 분류 (Family / Group / Assembly / Parts / In-Place)
+
+## 요약
+"패밀리(Family) 말고 조립 단위"에 가장 가까운 Revit 개념은 **Assembly(어셈블리)**. Revit은 구성 단위를 5가지로 나눈다: **Family / Group / Assembly / Parts / In-Place**. 각각의 목적이 다르며, "비패밀리 조립 단위" 표현은 실무에서 **"Assembly 기반 BIM 모델링"**으로 번역된다.
+
+## 사실 — 5가지 조립 단위 비교 (Facts)
+
+| 구분 | 개념 | 주 용도 | 장점 | 한계 |
+|---|---|---|---|---|
+| **Family (패밀리)** | 재사용 가능한 부품 정의 | 문·창호·가구·장비 등 표준 객체 | 재사용성 높음, 규격 관리 쉬움 | 조립체 전체를 다루는 데 한계 |
+| **Group (그룹)** | 여러 요소를 묶은 반복 단위 | 동일 배치 반복, 평면 패턴 | 배치 속도 빠름, 수정 편함 | 시공용 조립체 문서화에 약함 |
+| **Assembly (어셈블리)** | 시공/도면 기준 조립 단위 | 모듈, 철골, 코어, 욕실 pod 등 | 조립체별 도면·스케줄 관리 가능 | 범용 부품 재사용에 약함 |
+| **Parts (파트)** | 시스템 요소의 세분화된 분해 단위 | 벽·바닥·지붕의 분할 관리 | 공종별·구간별 관리 유리 | 독립 조립체 개념과 다름 |
+| **In-Place (인플레이스)** | 현장 전용 1회성 요소 | 특수 형상·1회성 객체 | 빠른 특수 형상 구현 | 재사용성·관리성 낮음 |
+
+## 핵심 구분
+- **Family** = 부품 중심
+- **Group** = 배치 중심
+- **Assembly** = 시공 단위 중심
+- **Parts** = 분해 관리 중심
+- **In-Place** = 예외 형상 중심
+
+## 실무 선택 기준
+- 표준 부품 반복이 많음 → **Family**
+- 한 번에 묶이는 모듈이 중요 → **Assembly**
+- 같은 형식의 반복 배치가 많음 → **Group**
+- 벽체 분해/공종별 분리 필요 → **Parts**
+- 특수 1회성 형상 → **In-Place**
+
+## 해석 (Interpretation)
+
+- **우리 원칙 "비패밀리 조립 단위"**의 Revit 내 가장 가까운 원형은 **Assembly**. 다만 Revit의 Assembly는 여전히 **컴포지트 객체 묶음** 수준이며, 토목의 선형 종속·지형 반응·긴 1회성 구조물을 표현하기에는 부족할 가능성이 높다.
+- Revit Assembly의 강점(**조립체별 도면·스케줄 자동화**)은 그대로 차용할 만하다. 토목 거더교는 경간·벤트·거더·슬래브가 "현장 조립체" 단위로 묶이므로 시공 단위 개념이 잘 맞는다.
+- Revit Assembly의 한계(**범용 재사용 부족, 파라메트릭 자체 정의 부재**)는 우리 툴에서 보완 대상. 즉 **"파라메트릭 정의 + 어셈블리식 조립 단위 + 선형 종속성"**을 하나로 합친 새 1급 객체가 필요할 수 있다.
+- [[파라메트릭 취약성 Davis 5가지|Davis의 #5 재사용 장벽]]과 함께 본다: 패밀리의 높은 재사용 ROI 전제가 깨지는 토목에서는, 재사용성을 낮추고 **개별 조립체의 문서화·파라메트릭 제어**를 강화하는 Assembly 방향이 자연스러운 귀결.
+
+## 관련 페이지
+- [[Revit 파라메트릭 아키텍처]]
+- [[파라메트릭 취약성 Davis 5가지]]
+- [[특징 형상 기반 모델링 FBM]] — Assembly를 넘어선 대안. 생성 규칙 자체를 자산화.
--- a/아키텍처.md
+++ b/아키텍처.md
@@ -0,0 +1,34 @@
+---
+title: Revit 파라메트릭 아키텍처
+tags: [revit, parametric, architecture, hub]
+sources:
+  - raw/ai-research/레빗(Revit) 파라메트릭 모델링의 핵심 솔버(Solver)와 연산 아키텍처에 관한 심층 연구.md
+  - raw/ai-research/Google AI Ultra 로 업그레이드시 구현가능성.md
+updated: 2026-04-14
+principles: [비패밀리, 증분, 선형-GIS]
+---
+
+# Revit 파라메트릭 아키텍처
+
+## 요약
+Revit의 파라메트릭 시스템은 **두 층의 솔버**로 구성된다. 미시 계층의 **[[GCS 기하학적 구속조건 솔버]]**(기하/치수 구속을 수학적으로 해결)와 거시 계층의 **[[PCE 파라메트릭 변경 엔진]]**(모델 전체 종속성을 추적·전파). 이 구조는 "Revise Instantly"라는 제품 정체성의 연산적 구현이다.
+
+## 사실 (Facts)
+
+- Revit은 오토데스크의 완전한 파라메트릭 BIM 플랫폼. 1997년 PTC 출신 Leonid Raiz·Irwin Jungreis가 "Charles River Software"로 창업, 2000년 Revit 1.0 출시, 2002년 오토데스크가 **약 1억 3,300만 달러**에 인수.
+- GCS 엔진으로 **Siemens의 D-Cubed 2D DCM**(Dimensional Constraint Manager)을 라이선스해 내장. 2D DCM 외에도 **3D DCM / CDM(충돌 진단) / PGM(프로파일 형상 관리)** 등 D-Cubed 컴포넌트를 광범위 도입.
+- PCE는 오토데스크가 독자 개발. 전 모델에 걸친 매개변수·요소 종속성을 **Graph of Dependencies**로 유지하고 변경을 연쇄 전파.
+- 핵심 기술 계보: **Sketchpad (Sutherland, 1963) → Pro/ENGINEER (PTC, 1988) → Revit 1.0 (2000)**.
+- 아날로그적 선조: Gaudí의 **현수선 모형**, Moretti의 **Stadium N (1960)**.
+
+## 해석 (Interpretation)
+
+- **두 층 분리**는 우리 설계에도 유효한 패턴이다. 국지적 기하 구속 해결과 전역 종속성 전파를 분리하면 복잡도가 관리된다.
+- 그러나 Revit PCE는 **[[PCE 파라메트릭 변경 엔진|본질적으로 직렬화 구조]]**라 멀티코어·GPU 가속이 어렵다. 이는 우리의 **증분 인터랙티브 파라메트릭** 원칙이 풀어야 할 과제.
+- 건축(벽·창·지붕) 시맨틱 중심으로 설계되어 **패밀리 재사용 전제**를 깔고 있음. 토목은 이 전제가 깨진다 → **비패밀리 조립 단위** 원칙의 출발점.
+
+## 관련 페이지
+- [[GCS 기하학적 구속조건 솔버]]
+- [[PCE 파라메트릭 변경 엔진]]
+- [[파라메트릭 취약성 Davis 5가지]]
+- [[Revit 조립 단위 분류]]
--- a/wiki/index.md
+++ b/wiki/index.md
@@ -0,0 +1,37 @@
+---
+title: ParaWiki Index
+updated: 2026-04-14
+---
+
+# ParaWiki Index
+
+모든 위키 페이지의 한 줄 인덱스. 각 항목은 120자 이내.
+
+## 설계 원칙 허브
+(아직 없음)
+
+## 개념 (Concepts)
+- [[Revit 파라메트릭 아키텍처]] — Revit 솔버 구조 개요. GCS(미시)와 PCE(거시) 두 층 + 역사·인수 기록.
+- [[GCS 기하학적 구속조건 솔버]] — 기하/치수 제약을 푸는 솔버. Siemens D-Cubed 2D/3D DCM 기반, Jacobian·수치해석.
+- [[PCE 파라메트릭 변경 엔진]] — Revit 거시 엔진. DAG·직렬 전파·순환 의존성 차단·HFDM 미래 방향.
+- [[파라메트릭 취약성 Davis 5가지]] — Daniel Davis의 파라메트릭 브리틀니스 5가지 비판(2013 박사논문).
+- [[Revit 조립 단위 분류]] — Family/Group/Assembly/Parts/In-Place 5가지 비교. "비패밀리"는 Assembly에 가까움.
+- [[특징 형상 기반 모델링 FBM]] — Feature 중심 토목 모델링. 패밀리 대체. 온톨로지·DFMA 결합, 효율 40%↑.
+- [[증분형 갱신 알고리즘 LPG]] — LPG 기반 G_new=G_old⊕ΔG. Esser 연구. 데이터 전송 90%↓, 동시성 해결.
+- [[선형 GIS 기반 좌표계]] — IfcAlignment(IFC 4.3) 일급 시민, LRS/Station, Geo-BIM, ISO 19148.
+
+## 도메인: 교량 (Bridge)
+(아직 없음)
+
+## 기하·수학 (Geometry & Math)
+(아직 없음)
+
+## 도구·엔진 (Tools & Engines)
+(아직 없음)
+
+## 표준·스펙 (Standards & Specs)
+(아직 없음)
+
+---
+
+**규칙:** 새 위키 페이지 생성 시 해당 카테고리 아래 한 줄로 추가. 예: `- [[B-Spline]] — 파라메트릭 곡선 표현의 표준. NURBS의 특수 케이스.`
--- a/wiki/log.md
+++ b/wiki/log.md
@@ -0,0 +1,21 @@
+# ParaWiki Log
+
+모든 위키 오퍼레이션 기록. 시간 역순(최신이 위).
+
+형식: `- YYYY-MM-DD [action] 페이지명 — 한 줄 설명`
+
+액션: `create` / `update` / `delete` / `rename` / `merge` / `meta` (구조·규칙 변경)
+
+---
+
+- 2026-04-14 create [[선형 GIS 기반 좌표계]] — IfcAlignment·LRS·Geo-BIM 컴파일. 원칙: 선형-GIS.
+- 2026-04-14 create [[증분형 갱신 알고리즘 LPG]] — Esser LPG 증분 그래프 변환 컴파일. 원칙: 증분.
+- 2026-04-14 create [[특징 형상 기반 모델링 FBM]] — FBM·온톨로지·DFMA 컴파일. 원칙: 비패밀리.
+- 2026-04-14 update [[Revit 조립 단위 분류]] — FBM 링크 추가.
+- 2026-04-14 create [[Revit 조립 단위 분류]] — Family/Group/Assembly/Parts/In-Place 분류 컴파일. 원칙: 비패밀리.
+- 2026-04-14 update [[Revit 파라메트릭 아키텍처]] — 조립 단위 분류 링크 추가.
+- 2026-04-14 create [[파라메트릭 취약성 Davis 5가지]] — Davis 5가지 취약성 컴파일. 원칙 연결: 비패밀리·증분.
+- 2026-04-14 create [[PCE 파라메트릭 변경 엔진]] — PCE 구조·DAG·순환의존성·HFDM 컴파일. 원칙 연결: 증분.
+- 2026-04-14 create [[GCS 기하학적 구속조건 솔버]] — D-Cubed 기반 GCS 컴파일. 원칙 연결: 증분.
+- 2026-04-14 create [[Revit 파라메트릭 아키텍처]] — Revit 솔버 아키텍처 허브 페이지 컴파일.
+- 2026-04-14 meta — 위키 구조 초기화 (raw/, wiki/, Output/). Karpathy LLM Wiki 패턴 적용.
--- a/좌표계.md
+++ b/좌표계.md
@@ -0,0 +1,71 @@
+---
+title: 선형(Alignment) 및 GIS 기반 좌표계
+tags: [alignment, GIS, LRS, IfcAlignment, geo-BIM, first-class, IFC-4.3]
+sources:
+  - raw/ai-research/비(非)패밀리 조립 단위, 증분형 갱신 알고리즘 및 선형·GIS 통합 좌표계의 기술적 패러다임 전환.md
+updated: 2026-04-14
+principles: [선형-GIS]
+---
+
+# 선형(Alignment) 및 GIS 기반 좌표계
+
+## 요약
+건축 BIM은 데카르트 좌표계(X,Y,Z) 기반. 토목은 **선형(Alignment)을 따라 정의되는 스테이션(Station)·체이닝(Chainage) 기반의 선형 위치 참조 시스템(LRS)**이 주도. **IFC 4.3**은 `IfcAlignment`를 **일급 시민(First-class Citizen)**으로 격상. 선형·GIS는 모델링의 출발점이자 뼈대.
+
+## 사실 (Facts)
+
+### 선형의 세 가지 관점 (IFC 4.3 기준)
+선형은 단순 기하선이 아니라 복합 정보의 뼈대:
+
+- **기하학적 관점:** 도로·철도 선형의 기하학적 곡선 조합.
+- **기구학적(Kinematic) 관점:** 차량 주행 안정성을 위한 **설계 속도**, **캔트(Cant)** 변화율.
+- **참조 시스템 관점:** 시설물 모든 구성 요소가 **선형으로부터의 오프셋(Offset)**으로 위치 정의.
+
+### 핵심 표준·개념
+- **`IfcAlignment`** — IFC 4.3의 선형 엔티티. 일급 시민 격상.
+- **LRS (Linear Referencing System)** — 선형 위치 참조 시스템. 스테이션/체이닝 기반.
+- **ISO 19148** — 선형 참조 국제 표준.
+
+### BIM × GIS 통합 ("Geo-BIM")
+
+| 통합 레이어 | 주요 기능 | 데이터 형식·표준 |
+|---|---|---|
+| 데이터 | 지형(DTM), 지질 데이터, 주변 시설물 | IFC, CityGML, Shapefile |
+| 컴퓨팅 | 공간 분석, 가시권 분석, 수리 해석 | Agentic GIS, Spatial Analytics |
+| 의미(Semantic) | 객체 ID 매핑, 시맨틱 웹 연동 | RDF, OWL, SPARQL |
+| 선형 | 선형 위치 참조, 구간별 오프셋 관리 | ISO 19148, IfcAlignment |
+
+### GIS vs BIM 기하 표현 불일치
+- **GIS:** 주로 **레이어 중심 2D** 또는 LOD2 수준 단순화 3D.
+- **BIM:** 객체 중심 정밀 **B-Rep (Boundary Representation)**.
+- 해결 시도: IFC 모델을 **지식 그래프(RDF)**로 변환 → GIS 데이터와 온톨로지 매칭.
+
+### 물리적 동기화 사례 — PSC 거더 교량
+- 제작 과정에서 **캠버(Camber)·횡방향 변형** 발생 → 선형과 오차.
+- 선형 기반 파라메트릭으로 **실측 변형 데이터를 모델에 입력** → 바닥판 두께·거더 배치 각도 자동 조정.
+- 설계안 표시 도구 → **디지털 트윈**으로 진화하는 기제.
+
+### 응용 — 파라메트릭 자동화
+- **철근·프리스트레스 덕트 자동 배치:** 선형 곡률과 단면 변화에 따라 3D 공간 궤적 자동 생성. 공간 곡선 덕트는 **평면 곡선 + 종단 곡선의 차이 연산**으로 생성.
+- **Rebar Clash Detection 100% 자동화** → 정확도 10%↑, 시공 재작업 감소.
+- (참고) 철근은 우리 MVP 제외(v2). 이 응용은 참조용으로만.
+- **LCA (Life-Cycle Assessment):** 경간·단면 변경에 따른 콘크리트·철강 사용량 자동 계산 → **탄소 배출량 실시간 분석**.
+
+## 해석 (Interpretation)
+
+- 선형·GIS를 **일급 시민으로** 다룬다는 것은 엔진 자료구조에서 선형이 단순 참조 엔티티가 아니라, **모든 조립체의 모(parent) 좌표계** 역할을 한다는 뜻. 이는 [[Revit 파라메트릭 아키텍처|Revit의 데카르트 기반 건축 시맨틱]]과 본질적으로 다름.
+- IFC 4.3 `IfcAlignment` 채택은 **전략적 결정**. 자체 좌표 스키마를 만들 필요 없이 국제 표준과의 상호운용성 확보.
+- [[특징 형상 기반 모델링 FBM|FBM]]과의 결합: Feature 생성 규칙은 **"선형 위의 스테이션 함수 f(s)와 단면 함수 g(s)"**로 자연스럽게 표현 가능.
+- [[증분형 갱신 알고리즘 LPG|LPG 증분 갱신]]과의 결합: 선형 변경 시 영향받는 **스테이션 범위**만 증분 재계산 → 대규모 교량에서 실시간 인터랙티브 가능.
+- 디지털 트윈 진화는 장기 비전으로 보관. MVP는 설계·시공 단계에서의 선형 종속 모델링에 집중.
+
+## 수집 우선순위 (raw/ 편입 대상)
+- IFC 4.3 스펙 (buildingSMART) → `raw/standards/`
+- ISO 19148 LRS → `raw/standards/`
+- IfcAlignment 구현 예제 (OpenBridge, Civil 3D) → `raw/tools/`
+- Geo-BIM 통합 논문 → `raw/papers/`
+
+## 관련 페이지
+- [[특징 형상 기반 모델링 FBM]]
+- [[증분형 갱신 알고리즘 LPG]]
+- [[Revit 파라메트릭 아키텍처]]
--- a/wiki/증분형
+++ b/wiki/증분형
@@ -0,0 +1,57 @@
+---
+title: 증분형 갱신 알고리즘 (Labeled Property Graph, LPG)
+tags: [incremental, LPG, graph-transformation, Speckle, CDE, concurrency]
+sources:
+  - raw/ai-research/비(非)패밀리 조립 단위, 증분형 갱신 알고리즘 및 선형·GIS 통합 좌표계의 기술적 패러다임 전환.md
+updated: 2026-04-14
+principles: [증분]
+---
+
+# 증분형 갱신 알고리즘 (Labeled Property Graph, LPG)
+
+## 요약
+전통 파라메트릭은 매개변수 변경 시 **종속성 그래프 전체를 재계산(Full Regeneration)**. 토목 대규모 모델에서는 시스템 프리징 초래. 해법은 BIM 모델을 **레이블 지정 속성 그래프(LPG)**로 표현하고 **그래프 변환(Graph Transformation)**으로 증분(Δ)만 적용하는 방식. Sebastian Esser et al. 연구.
+
+## 사실 (Facts)
+
+### 전체 재생성의 한계
+- 선형의 미세 변화가 수천 개 거더 세그먼트·교각·기초를 동시 변경해야 하면 **시스템 프리징**.
+- 즉각적 결과 확인·대안 검토(인터랙티브) 불가.
+
+### LPG 기반 증분 수식
+$$G_{new} = G_{old} \oplus \Delta G$$
+
+- BIM 모델 = **노드(객체) + 엣지(관계)** 집합.
+- 설계 변경 = **그래프 변환 (Addition / Deletion / Modification).**
+
+### 알고리즘 3단계
+1. **객체 식별·매핑 (Object Identification & Mapping):** 전역 고유 식별자(**GUID**) 기반으로 두 버전 간 객체 1:1 매칭.
+2. **차이점 분석 (Diffing):** 노드 속성값 변화 + 엣지 연결 구조 변화 식별.
+3. **그래프 변환 규칙 적용:** 변경 부분만 타겟 모델에 적용. 전체 모델 무결성 유지하며 갱신.
+
+### 정량 효과
+- 모놀리식(Monolithic) 파일 기반 전송 대비 **데이터 전송량 90% 이상 감소.**
+- 객체 수준 동기화로 **동시성 제어(Concurrency Control)** 해결 — 복수 설계자가 다른 파트를 동시 수정 가능.
+
+### 분산 협업 플랫폼 맥락
+- **Speckle** 등 오픈소스 협업 환경은 계층적 데이터 구조로 객체 단위 관리.
+- 계층 구조의 한계(복잡한 객체 간 관계 표현 약함)를 극복하기 위해 **그래프 기반 데이터 구조 접목** 추세.
+
+### 사용자 체감
+- 10분 대기 → 0.1초 즉시 반응. **설계자의 창의성·의사결정 질에 결정적 차이.**
+
+## 해석 (Interpretation)
+
+- LPG 기반 증분은 [[PCE 파라메트릭 변경 엔진|Revit PCE의 직렬화 병목]]을 정면 돌파하는 접근. Revit은 전체 DAG 재평가 → LPG는 변경 부분집합(ΔG)만 적용.
+- 우리 엔진(Rust 재설계 검토)은 처음부터 **LPG를 내부 모델로 채택**하는 것이 유력. 이는 메모리 배치·캐시 효율·분산 아키텍처와 자연스럽게 맞물림.
+- GUID 기반 객체 식별은 **저장소·시공 생애주기 전체**(IFC GlobalId 등)와 정합 → 외부 표준과의 연동도 용이.
+- Speckle류 플랫폼 조사는 우선순위: `raw/tools/` 에 Speckle 문서·API 레퍼런스 편입 필요.
+- **공통 데이터 환경(CDE)·BIM 레벨 3** 진입 조건과 직결 — 단순 성능 개선이 아니라 협업 모델의 전제 기술.
+
+## 주요 인물·문헌
+- **Sebastian Esser et al.** — LPG 기반 BIM 증분 업데이트 연구. (구체 논문은 `raw/papers/` 로 후속 수집 대상.)
+
+## 관련 페이지
+- [[PCE 파라메트릭 변경 엔진]]
+- [[특징 형상 기반 모델링 FBM]]
+- [[선형 GIS 기반 좌표계]]
--- a/wiki/특징
+++ b/wiki/특징
@@ -0,0 +1,51 @@
+---
+title: 특징 형상 기반 모델링 (Feature-based Modeling, FBM)
+tags: [FBM, feature, ontology, DFMA, non-family, modular]
+sources:
+  - raw/ai-research/비(非)패밀리 조립 단위, 증분형 갱신 알고리즘 및 선형·GIS 통합 좌표계의 기술적 패러다임 전환.md
+updated: 2026-04-14
+principles: [비패밀리]
+---
+
+# 특징 형상 기반 모델링 (Feature-based Modeling, FBM)
+
+## 요약
+FBM은 단순한 기하 형상이 아닌 **"특정 엔지니어링 목적을 수행하는 기능적 단위(Feature)"**를 모델링의 핵심 요소로 삼는 패러다임. 토목의 저 ROI 패밀리 문제를 대체하기 위한 방안. 거더·받침·신축이음은 **파일화된 패밀리가 아니라 선형·단면의 수학적 관계로 생성되는 특징 형상**으로 존재.
+
+## 사실 (Facts)
+
+### 건축 vs 토목의 근본 차이 (소스 원문 표)
+
+| 비교 항목 | 건축용 패밀리 (Revit 기반) | 토목 조립 단위 (I-BIM 지향) |
+|---|---|---|
+| 모델링 철학 | 상향식(Bottom-up) 라이브러리 조합 | 하향식(Top-down) 알고리즘 구동 |
+| 기하학적 복잡성 | 정형화된 유클리드 기하학 | 비정형 선형·지형 종속적 기하학 |
+| 매개변수 관계 | 객체 내부 매개변수 중심 | 외부 참조 선형·좌표계 중심 |
+| 재사용성 단위 | 정적 라이브러리 파일 | 동적 특징 형상 생성 규칙(Feature Rule) |
+| 데이터 구조 | 계층적 트리 구조 | 상호 연결된 그래프 구조 |
+
+### FBM의 핵심 원리
+- **Feature = 엔지니어링 목적을 수행하는 기능적 단위.** 단순한 기하 형상이 아님.
+- 토목 예시: 거더·교량 받침·신축 이음장치는 독립 파일이 아니라 **선형과 단면 정보의 수학적 관계로 생성**되는 특징 형상.
+- 특징 온톨로지(Feature Ontology)와 결합 시 설계 BIM을 시공 중심 FBM으로 변환 가능 — 누락되기 쉬운 시공 상세(예: 벽체 관통부 기하·공간 맥락)를 자동 추출.
+
+### 모듈화 분해 + DFMA (Design for Manufacture and Assembly)
+- 고속철도(HSR) 연속교 사례: 교량 구조 + 시공 기계(캔틸레버 시공용 **행잉 바스켓**)를 **시공 단계별 원칙에 따라 모듈 단위로 분해**.
+- 프리캐스트(PC) 부품: 표준 모듈을 **2차적으로 분할(Secondary Splitting)** 하여 파라메트릭 모듈 생성 → 공장 생산성 + 현장 조립성 동시 고려.
+
+### 정량 효과 (소스 제시)
+- 전통 방식 대비 **모델링 효율 40% 이상 향상**.
+- 프로젝트 기간 **약 10% 단축**.
+
+## 해석 (Interpretation)
+
+- FBM은 우리의 **비패밀리 조립 단위** 원칙의 이론적 구체화. [[Revit 조립 단위 분류|Revit의 Assembly]]는 여전히 "컴포지트 객체 묶음" 수준인 반면, FBM은 **생성 규칙 자체를 자산화**한다.
+- "정적 라이브러리 파일 축적"에서 "동적 생성 알고리즘(Generative Algorithm) 개발·공유" 문화로의 전환 — 이것이 우리 툴의 1급 객체 설계 방향. 즉, 파라메트릭 정의 + 어셈블리 조립 + 선형 종속을 합친 **Feature**가 중심.
+- 온톨로지 결합은 자료 수집 체계에도 함의: `raw/standards/` 에 **IFC, ISO 19148, 시맨틱 웹(RDF/OWL)** 관련 소스를 우선 수집해야 함.
+- DFMA 관점은 **설계자·시공사 양쪽 사용자**를 아우르는 근거 제공. MVP 사용자 범위와 정합.
+
+## 관련 페이지
+- [[Revit 조립 단위 분류]]
+- [[파라메트릭 취약성 Davis 5가지]]
+- [[선형 GIS 기반 좌표계]]
+- [[증분형 갱신 알고리즘 LPG]]
--- a/wiki/파라메트릭
+++ b/wiki/파라메트릭
@@ -0,0 +1,39 @@
+---
+title: 파라메트릭 취약성 — Daniel Davis의 5가지 (Brittleness)
+tags: [critique, davis, brittleness, methodology]
+sources:
+  - raw/ai-research/레빗(Revit) 파라메트릭 모델링의 핵심 솔버(Solver)와 연산 아키텍처에 관한 심층 연구.md
+updated: 2026-04-14
+principles: [비패밀리, 증분]
+---
+
+# 파라메트릭 취약성 — Daniel Davis의 5가지 (Brittleness)
+
+## 요약
+Daniel Davis(RMIT, 2013 박사 논문 *Modelled on Software Engineering*)는 파라메트릭 모델링이 소프트웨어 프로그래밍과 같은 취약성을 공유한다고 논증. 명시적 함수(explicit functions)로 구축된 모델이 **비선형·즉흥적 설계 변경**에서 어떻게 무너지는지를 5가지 축으로 정리. Rick Smith의 견해를 확장한 것.
+
+## 사실 — 5가지 취약성 (Facts)
+
+| 취약성 | 설명 |
+|---|---|
+| **1. 과도한 사전 인지 부하 (Front-loading)** | 초기부터 제약 논리·변수 상호작용을 완벽히 프로그래밍·디버깅해야 함. 방향이 확정되지 않은 초기 단계의 과투자는 기회비용 손실. |
+| **2. 유연성 예측의 모순 (Anticipating Flexibility)** | 유연하려면 "무엇이 변할지"를 사전 예측해 매개변수를 할당해야 함. 탐구가 목적이면서 닫힌 구속으로 미래를 미리 정의해야 하는 모순. |
+| **3. 명시적 함수의 파괴 (Fragility of Explicit Functions)** | 예측 못한 위상(topology) 변경 시 솔버 그래프가 도미노처럼 붕괴. 함수 구조 수정보다 **백지에서 재모델링이 더 빠른** 현상. |
+| **4. 변경의 시각적 맹점 (Change Blindness)** | 트리가 깊을수록 상위 매개변수 하나의 수정이 하위 수백 개에 어떤 연쇄 반응을 일으켰는지 **시각적·직관적 파악 불가**. |
+| **5. 재사용과 공유의 장벽 (Problematic Reuse)** | 동료가 구축한 패밀리·스크립트의 명시적 함수망을 완전히 이해하지 못하면 수정·재사용은 오류 위험. |
+
+## 해석 (Interpretation)
+
+- Davis의 5가지는 우리 원칙의 **직접적 근거**가 된다.
+- **#5 (재사용 장벽)** + **#2 (유연성 예측 모순)** → 토목의 저재사용 현장에서 **패밀리 재사용 전제가 깨지는** 실증적 이유. **비패밀리 조립 단위** 원칙을 지지.
+- **#3 (위상 변경에 취약)** → 파라메트릭 모델이 처음부터 위상 변화를 가정하지 않는 구조를 갖기 때문. 토목은 지형·선형 변경이 잦음 → **위상 변경에 견디는 구조** 설계가 우리 과제.
+- **#4 (시각적 맹점)** → 증분 갱신 시 **영향 받는 객체를 시각적으로 하이라이트**하는 UX가 필수. 단순 인터랙티브보다 "어디가 바뀌었는지 보여주는" 인터랙티브가 요구됨.
+- **#1 (사전 인지 부하)** → MVP 원칙(기능 축소, 품질 타협 없음)과 결합하면: 초기 모델링 단계에 과투자를 강요하지 않는 **점진적 구체화(progressive specification)** UX가 필요.
+
+## 원전
+- Davis, Daniel (2013). *Modelled on Software Engineering: Flexible Parametric Models in the Practice of Architecture*. PhD thesis, RMIT University.
+- Smith, Rick — 원형 견해 제공자.
+
+## 관련 페이지
+- [[Revit 파라메트릭 아키텍처]]
+- [[PCE 파라메트릭 변경 엔진]]