당신은 기존 지식 시스템을 새로운 도메인으로 확장하고 있습니다. 이는 대체가 아닌 구성(composition)입니다. 새 도메인은 고유한 어휘, 스키마, 처리 패턴을 유지하면서 기존 도메인과 공존해야 합니다. 공유 그래프(위키 링크, 허브 MOC, 설명 필드)가 모든 것을 연결합니다.
당신의 임무
새로운 지식 도메인 추가: $ARGUMENTS
참조 파일
유도 단계에서 다음 파일들을 읽으십시오:
구성 규칙:
${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md-- 테스트 4(다중 도메인 구성)가 패턴을 검증합니다${CLAUDE_PLUGIN_ROOT}/reference/three-spaces.md-- 3-공간 아키텍처(도메인 간 공유)${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md-- 도메인 구성에 대한 일관성 검증
도메인 구성:
${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md-- 도메인 고유 용어 매핑${CLAUDE_PLUGIN_ROOT}/reference/tradition-presets.md-- 사전 검증된 도메인 구성${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md-- 구성이 포함된 3가지 프리셋${CLAUDE_PLUGIN_ROOT}/reference/dimension-claim-map.md-- 차원 위치에 대한 연구 근거${CLAUDE_PLUGIN_ROOT}/reference/failure-modes.md-- 도메인 취약점 매트릭스
검증:
${CLAUDE_PLUGIN_ROOT}/reference/kernel.yaml-- 12개의 불가결한 기본 요소${CLAUDE_PLUGIN_ROOT}/reference/validate-kernel.sh-- 커널 검증 스크립트
1단계: 기존 시스템 스캔
자동화. 추가하기 전에 무엇이 있는지 이해합니다.
1a. 시스템 구성 읽기
ops/derivation.md에서 다음을 읽습니다:
- 현재 차원 위치
- 어휘 매핑
- 플랫폼 및 자동화 수준
- 활성 기능 블록
ops/config.yaml에서 현재 구성 값을 읽습니다.
1b. 기존 도메인 목록화
모든 현재 지식 도메인을 식별합니다:
- 기본 노트 폴더 및 해당 도메인 어휘
- 기존 보조 도메인(폴더, 템플릿, MOC)
- 도메인별 사용 중인 스키마 필드
1c. 차원 유형 식별
8개 차원 각각을 시스템 수준 또는 도메인 조정 가능으로 분류합니다:
| 차원 | 유형 | 근거 |
|---|---|---|
| 조직 | 시스템 수준 | 평면/계층형은 전체 워크스페이스에 적용됨 |
| 자동화 | 시스템 수준 | 훅과 스킬은 워크스페이스 전체 인프라임 |
| 탐색 깊이 | 시스템 수준 | 허브 MOC 구조는 공유됨 |
| 세분성 | 도메인 조정 가능 | 도메인에 따라 다른 세분성이 필요할 수 있음 |
| 처리 | 도메인 조정 가능 | 연구는 과중하게, 관계는 가볍게 필요함 |
| 유지보수 | 도메인 조정 가능 | 도메인 성장 속도에 따라 다른 조건 임계값 |
| 스키마 | 도메인 조정 가능 | 도메인별 필드가 다양함 |
| 연결 | 도메인 조정 가능 | 일부 도메인은 의미 검색이 필요하고 다른 도메인은 그렇지 않음 |
시스템 수준 차원은 기존 시스템에 의해 고정됩니다. 도메인 조정 가능 차원은 새 도메인에 대해 달라질 수 있습니다.
2단계: 대화
새로운 도메인을 이해하기 위해 1-3번의 대화 차례. 각 차례마다 AskUserQuestion을 사용합니다.
시작 질문
새 도메인에 대해 하나의 집중된 질문을 합니다:
"[ARGUMENTS의 도메인 힌트]에 대해 알려주세요 -- 어떤 종류의 것을 추적할 것이며, 이것이 기존 [현재 도메인 어휘] 작업과 어떻게 관련되나요?"
두 번째 부분이 중요합니다: 도메인 간 관계를 이해하는 것이 구성 결정을 주도합니다.
신호 추출
사용자가 응답할 때 도메인 조정 가능 차원에 대한 신호를 추출합니다:
| 신호 | 차원 | 위치 |
|---|---|---|
| "사람에 대한 빠른 메모" | 세분성 | 보통 |
| "세션에 대한 심층 분석" | 처리 | 과중 |
| "핵심 순간만 기억" | 처리 | 가벼움 |
| "자주 다시 방문하고 업데이트함" | 유지보수 | 엄격한 임계값 |
| "한 번 캡처하면 대부분 정적" | 유지보수 | 느슨한 임계값 |
| "항목 간 패턴 찾기 필요" | 연결 | 명시적+암시적 |
또한 추출합니다:
- 볼륨 추정 -- 처리 배치당 노트 수
- 시간적 역학 -- 콘텐츠가 얼마나 빨리 변하는지
- 어휘 -- 사용자의 노트, 프로세스, 구성에 대한 고유 용어
- 교차 도메인 관계 -- 이것이 기존 도메인과 어떻게 연결되는지
후속 전략
첫 응답 후 1-2개의 후속 질문을 합니다:
- 어휘 확인 -- "[사용자의 용어]라고 말씀하셨는데, 개별 인사이트를 의미하나요 아니면 더 긴 항목을 의미하나요?"
- 교차 도메인 연결 패턴 -- "[새 도메인] 노트가 [기존 도메인] 노트와 연결되나요? 어떻게요?"
차원에 대해 직접 묻지 마십시오. 자연스러운 대화에서 신호를 찾으십시오.
3단계: 도메인 구성 유도
3a. 신호를 도메인 조정 가능 차원에 매핑
각 조정 가능 차원에 대해 새 도메인의 위치를 결정합니다:
- 사용자 신호(최우선 순위)
${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md에서 가장 가까운 사용 사례 프리셋- 시스템 수준 차원에서의 연쇄
3b. 어휘 매핑 구축
변환 테이블에 대해 ${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md를 읽습니다.
우선 순위:
- 대화에서 얻은 사용자의 고유 용어
- 사용 사례 프리셋 어휘
- 가장 가까운 참조 도메인 혼합
새 도메인에 대한 완전한 매핑을 구축합니다:
| 보편 용어 | 새 도메인 용어 | 출처 |
|---|---|---|
| 노트 | [용어] | [사용자 / 프리셋 / 혼합] |
| 추출 / 축소 | [용어] | [사용자 / 프리셋 / 혼합] |
| 연결 / 반영 | [용어] | [사용자 / 프리셋 / 혼합] |
| MOC | [용어] | [사용자 / 프리셋 / 혼합] |
| 설명 | [용어] | [사용자 / 프리셋 / 혼합] |
| 주제 | [용어] | [사용자 / 프리셋 / 혼합] |
| 인박스 | [용어] | [사용자 / 프리셋 / 혼합] |
3c. 도메인별 스키마 설계
기본 노트 스키마(설명, 주제)에서 시작하여 도메인별 필드를 추가합니다:
_schema:
entity_type: "[도메인]-노트"
applies_to: "[도메인-폴더]/*.md"
required:
- 설명
- 주제
optional:
- [대화 신호 기반 도메인별 필드]
enums:
[필드]:
- [도메인 관련 값]
3d. 충돌 검사
이는 다중 도메인 구성에 중요합니다. 다음을 확인합니다:
-
파일 이름 고유성 -- 새 도메인의 노트 제목이 기존 노트와 충돌하지 않아야 합니다. 위키 링크는 전체 워크스페이스에서 파일 이름으로 확인되므로 모든 파일 이름은 고유해야 합니다.
-
스키마 필드 이름 -- 새 도메인 필드가 기존 도메인 필드와 충돌하지 않아야 합니다. 두 도메인이 동일한 필드 이름(예:
type)을 사용하는 경우 열거형 값이 상호 배타적이거나 필드가 호환 가능한 의미를 가져야 합니다. -
템플릿 이름 -- 새 도메인 템플릿이 기존 템플릿과 다른 이름을 가져야 합니다.
-
폴더 이름 -- 새 도메인 폴더가 기존 폴더와 충돌하지 않아야 합니다.
충돌이 감지되면 진행하기 전에 해결합니다.
4단계: 구성 규칙 확인
검증된 구성 패턴에 대해 ${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md(테스트 4: 다중 도메인 구성)를 읽습니다.
각 구성 규칙을 확인합니다:
규칙 1: 위키 링크가 공유 네임스페이스에서 모호함 없이 확인됨
모든 노트 파일 이름은 모든 도메인에서 고유해야 합니다. 새 도메인의 명명 규칙이 기존 규칙과 호환되어야 합니다.
규칙 2: 허브 MOC가 모든 도메인 MOC에 연결됨
기존 허브 MOC(index.md 또는 이에 상응하는 파일)에는 새 도메인의 진입점 MOC가 포함되도록 업데이트되어야 합니다. 계층 구조는 다음과 같습니다:
허브 -> 기존 도메인 MOC
-> 새 도메인 MOC
규칙 3: 교차 도메인 반영(리플렉트)이 모든 노트 폴더 검색
연결 찾기(반영)가 활성화된 경우 모든 도메인을 검색해야 합니다. 새 도메인의 노트가 기존 도메인의 노트와 연결될 수 있습니다. 의미 검색 컬렉션에는 새 도메인 폴더가 포함되어야 합니다.
규칙 4: 도메인별 처리가 공존 가능
새 도메인이 기존 도메인과 다른 처리 강도를 필요로 하는 경우 파이프라인은 노트 유형별로 라우팅해야 합니다. 연구 노트에는 과중 처리, 관계 노트에는 가벼운 처리 등.
규칙 5: 컨텍스트 파일 로딩은 점진적
새 도메인의 방법론 가이드는 해당 도메인에서 작업할 때만 로드되어야 하며, 모든 세션 시작 시 로드되지 않아야 합니다. 이는 도메인이 축적됨에 따라 컨텍스트 비대를 방지합니다.
일관성 검사
${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md를 통해 새 도메인의 구성을 실행합니다:
- 새 도메인 구성과 시스템 수준 차원 간의 하드 제약 조건 위반
- 새 도메인별 소프트 제약 조건 경고
- 기존 도메인에 대한 연쇄 효과
5단계: 제안 제시
사용자에게 정확히 무엇이 생성될지 그리고 기존 시스템과 어떻게 연결되는지 보여줍니다.
출력 형식:
=== 도메인 추가 제안 ===
새 도메인: [도메인 이름]
어휘: [핵심 용어 매핑]
--- 생성될 내용 ---
폴더 구조:
[도메인-폴더]/ <- [설명]
index.md <- 도메인 허브 MOC
[도메인-인박스]/ <- 캡처 영역 (처리 >= 보통인 경우)
템플릿/[도메인]-노트.md <- 도메인 스키마가 포함된 노트 템플릿
--- 기존 시스템과의 연결 ---
- 허브 MOC (index.md): [[domain-index]]에 대한 링크와 함께 [새 도메인] 섹션 추가
- 교차 도메인 링크: [새 도메인] 노트는 [기존 도메인] 노트에 링크할 수 있으며 그 반대도 가능
- 공유 인프라: self/, ops/, 템플릿/은 공유 상태 유지
- 의미 검색: [현재 볼륨에서 새 컬렉션 추가 / 필요하지 않음]
--- 변경되지 않는 내용 ---
- 기존 [도메인] 폴더: 변경 없음
- 기존 템플릿: 변경 없음
- 기존 MOC 계층 구조: 변경 없음 (허브는 하나의 새 링크만 얻음)
- self/ 공간: 공유 (methodology.md가 다중 도메인 패턴으로 업데이트됨)
- ops/ 공간: 공유 (derivation.md가 도메인 추가로 업데이트됨)
--- 도메인 구성 ---
| 차원 | 위치 | 근거 |
|-----------|----------|-----------|
| 세분성 | [값] | [이유] |
| 처리 | [값] | [이유] |
| 유지보수 | [값] | [이유] |
| 스키마 | [값] | [이유] |
| 연결 | [값] | [이유] |
| (시스템 수준 차원은 기존 시스템에서 상속) |
--- 스키마 미리보기 ---
[새 도메인 템플릿에 대한 _schema 블록 표시]
--- 어휘 매핑 ---
| 보편 | 새 도메인 | 기존 도메인 |
|-----------|-----------|-----------------|
| 노트 | [용어] | [기존 용어] |
| ... | ... | ... |
이것을 생성할까요? 진행하기 전에 조정할 수 있습니다.
=== 제안 종료 ===
진행하기 전에 사용자 승인을 기다립니다.
6단계: 생성
새 도메인의 인프라를 생성합니다. 순서가 중요합니다. 이후 아티팩트는 이전 아티팩트를 참조합니다.
1단계: 도메인 폴더 구조
도메인의 노트 폴더와 선택적 인박스 폴더를 생성합니다:
mkdir -p [도메인-폴더]
mkdir -p [도메인-인박스] # 처리 >= 보통인 경우
2단계: 도메인 노트 템플릿
유도된 _schema 블록, 필수 및 선택 필드, 주석과 예제의 도메인 어휘와 함께 templates/[도메인]-note.md를 생성합니다.
3단계: 도메인 허브 MOC
[도메인-폴더]/index.md를 생성합니다:
---
description: [도메인 어휘의 진입점 설명]
type: moc
---
# 색인
[도메인 어휘의 오리엔테이션 단락]
## [도메인:주제]
(주제는 노트가 축적됨에 따라 나타납니다)
## 시작하기
1. 첫 번째 [도메인:노트]를 캡처하세요
2. 이 허브에 연결하세요
4단계: 도메인 가이드
이 도메인에서 작업할 때 로드되는 도메인별 방법론 문서를 생성합니다. Claude Code의 경우: .claude/skills/[도메인]-가이드/SKILL.md 또는 컨텍스트 파일의 섹션. 다른 플랫폼의 경우: 독립 실행형 가이드 파일.
가이드는 다음을 다룹니다:
- 이 도메인에서 캡처하는 방법
- 처리 방법(유도된 강도로)
- 교차 도메인 연결 시기
- 도메인별 품질 기준
- 도메인 어휘 참조
5단계: 허브 MOC 업데이트
기존 허브 MOC(index.md)에 새 도메인을 추가합니다:
## [새 도메인 이름]
- [[도메인-색인]] -- [이 도메인이 추적하는 내용에 대한 설명]
6단계: 컨텍스트 파일 업데이트
컨텍스트 파일에 추가합니다:
- 도메인 라우팅: [도메인]에서 작업할 때 [도메인 가이드] 로드
- 어휘: 새 도메인 용어가 어휘 참조에 추가됨
- 처리: 처리 강도가 다른 경우 라우팅 문서화
- 교차 도메인 연결: 도메인 간 연결 시기 및 방법
7단계: self/methodology.md 업데이트
다중 도메인 작업 패턴 추가:
- 도메인 간 전환 방법
- 교차 도메인 연결 생성 시기
- 도메인별 처리 트리거
8단계: ops/derivation.md 업데이트
도메인 추가 문서화:
- 새 도메인 이름 및 어휘
- 근거가 포함된 도메인 조정 가능 차원 위치
- 확인된 구성 규칙
- 교차 도메인 연결 패턴
- 추가 날짜 및 컨텍스트
9단계: 의미 검색 업데이트(구성된 경우)
qmd 또는 이에 상응하는 것이 구성된 경우:
# 도메인 폴더에 새 컬렉션 추가
qmd 업데이트
qmd 임베드
새 컬렉션을 포함하도록 .mcp.json 또는 이에 상응하는 구성을 업데이트합니다.
10단계: 도메인 처리 스킬(처리 >= 보통인 경우)
새 도메인이 자체 처리 스킬을 필요로 하는 경우(처리 강도 또는 어휘가 기존 도메인과 다른 경우), 축소/반영/확인 스킬의 도메인 적응 버전을 생성합니다.
기존 스킬이 노트 유형별로 다중 도메인 라우팅을 처리할 수 있는 경우 복제를 생성하는 대신 업데이트합니다.
7단계: 검증
새 도메인 파일에 대한 커널 검사
새 도메인 파일에 대해 커널 검증을 실행합니다:
- 모든 새 파일에 YAML 프론트매터가 유효함
- 새 파일의 위키 링크가 확인됨(교차 도메인 링크 포함)
- 새 도메인 MOC가 허브에서 도달 가능함
- 설명 필드가 존재함
- 주제 바닥글이 도메인 MOC를 참조함
구성 검증
- 필드 충돌 없음 -- 모든 템플릿에서 필드 이름을 grep하여 의미적 충돌이 없는지 확인
- 허브 도달 가능성 -- 허브 MOC가 모든 도메인 MOC에 연결되고, 모든 도메인 MOC가 해당 노트에 연결됨
- 교차 도메인 링크 테스트 -- 새 도메인에서 기존 도메인으로의 테스트 링크를 생성하고 확인되는지 확인
- 파일 이름 고유성 -- 모든 도메인에서 중복 파일 이름이 없는지 확인:
find . -name "*.md" -exec basename {} \; | sort | uniq -d
완료 확인
새로 추가된 도메인으로 시스템이 작동하는지 확인:
- 새 템플릿을 사용하여 캡처 워크플로우 시뮬레이션
- 새 도메인에서 기존 도메인으로의 교차 도메인 링크 확인
- 허브 MOC가 모든 도메인을 나열하는지 확인
- 새 도메인 컨텍스트에 도메인 가이드가 포함되는지 확인