# CLAUDE.md

## 나는 누구인가
- **이름:** 김민성 (kimminsung)
- **하는 일:** BIM SW 시니어 개발자. 25년간 3D 뷰어·에디터·모델링툴, DWG·CAD 엔진 개발.
- **핵심 가치:** 기능은 좁히되 **품질·아키텍처는 타협 없음.** MVP식이라도 스파게티 금지. 차근차근.

## 나의 역할들

### 파라메트릭 모델링 도구 개발자
- **하는 일:** Revit의 토목 버전 파라메트릭 모델링 도구를 설계·개발.
- **주요 관심사:** 토목 구조물(MVP: 거더교) 모델링, 선형·GIS 연동, 증분 인터랙티브 파라메트릭.
- **기술 자산:** C# 자체 3D 엔진(sweep/loft/boolean 등 솔리드 연산). Rust 재설계 검토 중.

### ParaWiki 큐레이터
- **하는 일:** AI가 읽고 활용할 수 있는 파라메트릭 모델링 지식 저장소를 Obsidian 기반으로 구축.
- **주요 관심사:** AI 친화적 구조, 빠른 인덱싱·링크, 잠정 설계 원칙과 연결되는 자료 우선 수집.

## 나의 비전과 목표
- **이루고자 하는 것:** 토목 엔지니어링 특성을 반영한 파라메트릭 모델링 도구를 시장에 공급.
- **두 단계 전략:**
  1. ParaWiki — "AI를 위한 세컨드 브레인" 지식 저장소 구축.
  2. AI와 함께 토목용 파라메트릭 모델링 도구 개발.
- **타겟 독자/고객:** 토목 설계자, 시공사.

## AI에게 기대하는 것
- **전부.** 개념 QA, 코드 초안 생성, 아키텍처 제안, 논문→구현 번역, 코드 리뷰·리팩터링.
- ParaWiki의 자료를 근거로 답할 것.
- 제품 스펙을 확정하기 전에 **저장소 구축**을 우선 도울 것.

## 작업 규칙
- **언어:** 한국어로 작성. **중요 용어는 영어 병기** (예: 선형(alignment)).
- **톤:** 간결·명료. 장황한 설명·불필요한 예시 나열 금지.
- **질문:** 한 번에 **2~3개 이하**, 각 질문은 한 줄.
- **결과물 형태:** AI가 활용하기 좋은 구조가 1순위. 사람은 최상위 index 링크로 접근.
- **잠정 설계 원칙 (수집·개발의 나침반):**
  1. 비(非)패밀리 조립 단위
  2. 증분 인터랙티브 파라메트릭(incremental)
  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` 참조.