44e26d6972
- CLAUDE.md 생성 (볼트 운영 규칙, Karpathy LLM Wiki 10가지 규칙) - 나의 핵심 맥락.md 생성 (아키텍트 프로필, 세컨드 브레인 목적, 핵심 소스) - raw/ 구조 정립 (book/기존 설계원칙 보존, articles/repos/notes/ 추가) - wiki/ 초기화 (index.md, log.md, concepts/sources/patterns/ 폴더) - output/ 초기화 - LLMWiki/ 기존 프롬프트 패턴 파일 보존 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
CLAUDE.md
AI가 이 볼트에서 작업할 때 매번 읽는 파일.
나는 누구인가
- 25년 경력 소프트웨어 아키텍트
- 소프트웨어 설계 및 구현 관리
- 핵심 가치: 변경이 아닌 추가로 시스템을 진화시킨다 (가산적 아키텍처)
나의 역할들
소프트웨어 아키텍트
- 하는 일: 시스템 설계, 구현 방향 결정, 기술 판단
- 주요 관심사: 가산적 설계 — 기존 코드를 건드리지 않고 기능을 추가하는 구조
세컨드 브레인 큐레이터
- 하는 일: 진화하는 소프트웨어 관련 지식을 수집·정리·연결
- 주요 관심사: AI가 읽고 실천할 수 있는 형태로 지식을 구조화
나의 비전과 목표
- 이루고자 하는 것: 가산적 아키텍처를 실천 가능한 설계 원칙으로 체계화하고, AI와 함께 그 원칙 위에서 소프트웨어를 개발한다
- 핵심 지식 소스:
- Software Design for Flexibility — Hanson & Sussman (MIT Press, 2021)
- Essence of Software — Daniel Jackson (essenceofsoftware.com)
AI에게 기대하는 것
- 이 볼트의 내용을 읽고, 가산적 설계 원칙에 맞게 코드를 생성할 것
- 설계 의도를 먼저 파악하고, 그 의도에 맞는 구현을 제안할 것
- 임시 방편 코드는 명시적으로 표시하고, 이유를 남길 것
- 아키텍트가 판단할 수 있도록 선택지와 근거를 제시할 것
작업 규칙
- 언어: 한국어로 소통하고 기록한다
- 톤: 간결하게, 핵심만
- 결과물: AI가 생성 → 아키텍트가 검증
- 기록: 설계 결정에는 반드시 이유를 남긴다
볼트 구조
| 폴더 | 역할 |
|---|---|
raw/ |
불변 원본 — 절대 수정 금지 |
wiki/ |
AI가 컴파일하는 위키 |
output/ |
생성된 결과물 |
위키 운영 규칙 (Karpathy LLM Wiki 패턴)
raw/는 절대 수정 금지 — 추가만 가능- wiki 페이지 생성/삭제 시
wiki/index.md필수 업데이트 - 모든 오퍼레이션마다
wiki/log.md에 기록 - 내부 참조는
[[wikilink]]형식 - 모든 wiki 페이지에 YAML frontmatter 필수
- 모순 발견 시 양쪽 소스 모두 인용
- 소스 요약은 사실만 — 해석은
wiki/concepts/에서 - 질의 시
wiki/index.md먼저,raw/는 마지막 수단 - 새 페이지보다 기존 페이지 업데이트 우선
- index 항목은 한 줄, 120자 이내