From 9d0e948bfd8a0aff20293f04a6371d48d0fefba1 Mon Sep 17 00:00:00 2001 From: minsung Date: Tue, 14 Apr 2026 09:38:57 +0900 Subject: [PATCH] =?UTF-8?q?Add=20=EB=82=98=EC=9D=98=20=ED=95=B5=EC=8B=AC?= =?UTF-8?q?=20=EB=A7=A5=EB=9D=BD.md=20and=20CLAUDE.md=20for=20ParaWiki=20f?= =?UTF-8?q?oundation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ParaWiki는 AI가 읽고 활용할 파라메트릭 모델링 지식 저장소로, 최종 산출물은 토목용 파라메트릭 모델링 도구. 이번 커밋은 프로젝트의 핵심 맥락과 AI 작업 지침을 확정. - MVP: 거더교, 설계자·시공사 대상, 철근 설계는 v2 이후 - 잠정 설계 원칙 3가지(비패밀리/증분 인터랙티브/선형·GIS) - 저장소 작성 규칙: 한국어+영어 병기, AI 우선 구조 Refs #1 Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 41 +++++++++++++++++++++++++++++++++++++++++ 나의 핵심 맥락.md | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 73 insertions(+) create mode 100644 CLAUDE.md create mode 100644 나의 핵심 맥락.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..0975f36 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,41 @@ +# 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로 미룸. diff --git a/나의 핵심 맥락.md b/나의 핵심 맥락.md new file mode 100644 index 0000000..26076eb --- /dev/null +++ b/나의 핵심 맥락.md @@ -0,0 +1,32 @@ +# 나의 핵심 맥락 + +## 1. 나는 누구인가 +BIM SW 시니어 개발자. 25년간 3D 뷰어·에디터·모델링툴, DWG·CAD 엔진 개발. +현재 자산: C# 자체 3D 엔진 (sweep/loft/boolean 등 솔리드 연산 가능, 파라메트릭 아님, 성숙도 낮음). Rust 재설계 검토 중. + +## 2. 무엇을 만드는가 +두 단계로 나눈다. +- **ParaWiki (지금 만드는 것)**: AI가 읽고 활용할 수 있는 파라메트릭 모델링 지식 저장소. "AI를 위한 세컨드 브레인". +- **토목용 파라메트릭 모델링 도구 (다음 단계)**: Revit의 토목 버전. 건축이 아닌 **토목 구조물** 중심. ParaWiki를 재료로 AI와 함께 개발. + +## 3. 왜 저장소부터 만드는가 +파라메트릭 모델링 개발에는 방대한 도서·논문·수학이 필요하다. AI가 양질의 골든 저장소를 읽고 개발을 도울 수 있어야 한다. + +## 4. MVP 범위 +- **구조물:** 거더교(Girder Bridge) +- **사용자:** 설계자, 시공사 +- **철근 설계:** 제외 (v2 이후). + +MVP는 **기능을 좁히는 것**이지 **대충 만드는 것이 아니다**. 기능은 적게, 품질·아키텍처는 타협 없이 간다. + +## 5. 잠정 설계 원칙 (자료 수집의 나침반) +1. **비(非)패밀리 조립 단위** — 토목은 패밀리 재사용 ROI가 낮다. 대체 단위를 탐색. +2. **증분 인터랙티브 파라메트릭(incremental)** — 파라미터 변경 시 전체 재생성이 아닌 증분 갱신. +3. **선형·GIS 기반 좌표계** — 선형(alignment)과 외부지형이 모델링의 출발점. 일급 시민으로 다룸. + +자료 수집 시 세 원칙 중 최소 하나와 연결되는지 확인. 원칙은 자료가 쌓이며 갱신. + +## 6. 저장소 작성 규칙 +- **재료:** 현재는 AI로 조사한 문서가 주 소스. +- **언어:** 한국어 작성, 중요 용어는 영어 병기 (예: 선형(alignment)). +- **구조:** AI가 잘 활용할 수 있는 구조 1순위. 사람은 최상위 index의 링크로 접근 (사람도 결국 AI로 질의).