compound 스킬 목적: 작업 과정에서 검증된 인사이트를 즉시 문서화하여, 검색 가능한 지식 베이스를 구축한다. 개요 이 스킬은 인사이트가 확인되는 즉시 포착하여, YAML frontmatter 기반의 구조화된 문서로 저장한다. 카테고리별 단일 파일 아키텍처를 사용하며, 각 인사이트는 에 저장된다. --- <critical sequence name="insight-capture" enforce order="strict" 7단계 프로세스 <step number="1" required="true" Step 1: 트리거 감지 자동 감지 문구 (대화에서 인식): - "이거 잘 됐다" - "이 방식이 좋네" - "다음에도 이렇게 하자" - "이건 기록해두자" - "이 포맷이 먹혔다" - "이게 효과가 있었어" - "이렇게 하니까 됐어" - "기억해둬야 해" OR 수동: 커맨드 Non-trivial만 (재사용 가치 있는 인사이트): - 반복할 수 있는 패턴 - 다른 상황에도 적용 가능한 교훈 - 시행착오 끝에 발견한 방법 - 실전에서 검증된 접근법 - 구조적 개선을 가져온 발견 스킵 기준: - 이 상황에서만 통하는 일회성 방법 - 단순 사실 기록 (수치, 날짜 등…

\n description: \"인사이트가 도출된 날짜 (YYYY-MM-DD)\"\n\n insight_type:\n type: enum\n values:\n - workflow_pattern # 효율적인 작업 흐름 발견\n - problem_solving # 문제 해결 과정에서의 교훈\n - tool_discovery # 도구/기능 활용법 발견\n - automation_pattern # 자동화/효율화 패턴\n - communication_pattern # 소통/협업에서의 교훈\n - decision_learning # 의사결정에서의 교훈\n - debugging_insight # 디버깅/트러블슈팅 교훈\n - design_pattern # 설계/구조 패턴\n - learning_method # 효과적인 학습법 발견\n - productivity_hack # 생산성 향상 방법\n - mistake_lesson # 실수에서 배운 교훈\n - best_practice # 검증된 모범 사례\n description: \"인사이트의 유형\"\n\n component:\n type: enum\n values:\n # work\n - process\n - collaboration\n - meeting\n - documentation\n - planning\n # learning\n - skill-building\n - knowledge-management\n - study-method\n - mentoring\n # project\n - architecture\n - implementation\n - testing\n - deployment\n - code-review\n # tool\n - claude-code\n - mcp\n - ide\n - cli\n - automation\n # personal\n - habit\n - focus\n - time-management\n - reflection\n description: \"영역 내 하위 컴포넌트\"\n\n context:\n type: string\n min_length: 20\n max_length: 300\n description: \"어떤 상황에서 이 인사이트가 나왔는지 (1-3문장)\"\n\n key_learning:\n type: string\n min_length: 10\n max_length: 200\n description: \"핵심 교훈 한 문장\"\n\n impact:\n type: enum\n values: [critical, high, medium, low]\n description: \"인사이트의 영향 범위와 중요도\"\n\n tags:\n type: array[string]\n min_items: 1\n max_items: 8\n description: \"검색용 키워드 (lowercase, hyphen-separated)\"\n\noptional_fields:\n related_components:\n type: array[string]\n description: \"'domain/component' 형식\"\n evidence:\n type: array[string]\n status:\n type: enum\n values: [validated, hypothesis, superseded, archived]\n default: validated\n source_event:\n type: string\n action_items:\n type: array[string]\n\ndomain_component_mapping:\n work: [process, collaboration, meeting, documentation, planning]\n learning: [skill-building, knowledge-management, study-method, mentoring]\n project: [architecture, implementation, testing, deployment, code-review]\n tool: [claude-code, mcp, ide, cli, automation]\n personal: [habit, focus, time-management, reflection]\n\ncategory_mapping:\n workflow_pattern: \"knowledge/workflow-patterns/\"\n problem_solving: \"knowledge/problem-solving/\"\n tool_discovery: \"knowledge/tool-discoveries/\"\n automation_pattern: \"knowledge/tool-discoveries/\"\n communication_pattern: \"knowledge/communication/\"\n decision_learning: \"knowledge/decisions/\"\n debugging_insight: \"knowledge/problem-solving/\"\n design_pattern: \"knowledge/design-patterns/\"\n learning_method: \"knowledge/learning-methods/\"\n productivity_hack: \"knowledge/workflow-patterns/\"\n mistake_lesson: \"knowledge/problem-solving/\"\n best_practice: \"knowledge/best-practices/\"\n\nvalidation_rules:\n - \"date는 YYYY-MM-DD 형식\"\n - \"tags는 lowercase, hyphen-separated\"\n - \"domain-component 매핑이 유효해야 함\"\n - \"context는 구체적 상황 서술 (모호한 표현 금지)\"\n - \"key_learning은 다른 상황에도 적용 가능한 일반화된 교훈\"\n","content_type":"application/yaml; charset=utf-8","language":"yaml","size":3859,"content_sha256":"43146f6fcc68f69bb53a801e23579b02643686c073cd85414c9926768ea308ac"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"compound 스킬","type":"text"}]},{"type":"paragraph","content":[{"text":"목적:","type":"text","marks":[{"type":"strong"}]},{"text":" 작업 과정에서 검증된 인사이트를 즉시 문서화하여, 검색 가능한 지식 베이스를 구축한다.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"개요","type":"text"}]},{"type":"paragraph","content":[{"text":"이 스킬은 인사이트가 확인되는 즉시 포착하여, YAML frontmatter 기반의 구조화된 문서로 저장한다. 카테고리별 단일 파일 아키텍처를 사용하며, 각 인사이트는 ","type":"text"},{"text":"knowledge/[category]/[filename].md","type":"text","marks":[{"type":"code_inline"}]},{"text":"에 저장된다.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"paragraph","content":[{"text":"\u003ccritical_sequence name=\"insight-capture\" enforce_order=\"strict\">","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"7단계 프로세스","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"1\" required=\"true\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: 트리거 감지","type":"text"}]},{"type":"paragraph","content":[{"text":"자동 감지 문구 (대화에서 인식):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"이거 잘 됐다\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"이 방식이 좋네\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"다음에도 이렇게 하자\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"이건 기록해두자\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"이 포맷이 먹혔다\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"이게 효과가 있었어\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"이렇게 하니까 됐어\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"기억해둬야 해\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"OR 수동:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"/compound","type":"text","marks":[{"type":"code_inline"}]},{"text":" 커맨드","type":"text"}]},{"type":"paragraph","content":[{"text":"Non-trivial만 (재사용 가치 있는 인사이트):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"반복할 수 있는 패턴","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"다른 상황에도 적용 가능한 교훈","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"시행착오 끝에 발견한 방법","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"실전에서 검증된 접근법","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"구조적 개선을 가져온 발견","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"스킵 기준:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"이 상황에서만 통하는 일회성 방법","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"단순 사실 기록 (수치, 날짜 등)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"이미 문서화된 내용의 반복","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"아직 검증되지 않은 가설 \u003c/step>","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"2\" required=\"true\" depends_on=\"1\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: 컨텍스트 수집","type":"text"}]},{"type":"paragraph","content":[{"text":"대화 이력에서 추출:","type":"text"}]},{"type":"paragraph","content":[{"text":"필수 정보:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"domain","type":"text","marks":[{"type":"strong"}]},{"text":": work / learning / project / tool / personal","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"insight_type","type":"text","marks":[{"type":"strong"}]},{"text":": 인사이트 유형 (schema.yaml enum 참조)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"component","type":"text","marks":[{"type":"strong"}]},{"text":": 도메인 내 하위 컴포넌트 (schema.yaml enum 참조)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"context","type":"text","marks":[{"type":"strong"}]},{"text":": 어떤 상황에서 나온 인사이트인가 (1-3문장)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"key_learning","type":"text","marks":[{"type":"strong"}]},{"text":": 핵심 교훈 한 문장 (다른 상황에도 일반화 가능하게)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"impact","type":"text","marks":[{"type":"strong"}]},{"text":": critical / high / medium / low","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"tags","type":"text","marks":[{"type":"strong"}]},{"text":": 검색 키워드 (소문자, 하이픈 구분)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"추가 수집 항목:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"배경: 어떤 프로젝트/활동 중이었는가","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"시도한 것들: 효과 없었던 접근들","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"효과 있었던 것: 실제로 작동한 방법","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"작동 이유: 왜 효과적이었는가","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"재현 조건: 언제 이 방법을 쓸 수 있는가","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"BLOCKING 요건:","type":"text","marks":[{"type":"strong"}]},{"text":" domain, insight_type, 핵심 인사이트가 불분명한 경우 사용자에게 질문하고 응답을 기다린다:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"문서화를 위해 몇 가지 확인이 필요합니다:\n\n1. 어떤 도메인인가요? (work/learning/project/tool/personal)\n2. 인사이트 유형은? (예: workflow_pattern, problem_solving, tool_discovery...)\n3. 핵심 교훈을 한 문장으로 정리하면?\n\n[응답 후 계속 진행]","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003c/step>","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"3\" required=\"false\" depends_on=\"2\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3: 기존 문서 검색","type":"text"}]},{"type":"paragraph","content":[{"text":"knowledge/","type":"text","marks":[{"type":"code_inline"}]},{"text":" 에서 유사 인사이트 검색:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# domain, tags, insight_type 기준으로 병렬 검색\nGrep: pattern=\"domain: [domain]\" path=knowledge/ output_mode=files_with_matches\nGrep: pattern=\"tags:.*[keyword]\" path=knowledge/ output_mode=files_with_matches -i=true\nGrep: pattern=\"insight_type: [type]\" path=knowledge/ output_mode=files_with_matches","type":"text"}]},{"type":"paragraph","content":[{"text":"유사 문서 발견 시","type":"text","marks":[{"type":"strong"}]},{"text":" 사용자에게 선택지 제시 후 대기:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"유사 문서 발견: knowledge/[path]\n\n어떻게 할까요?\n1. 새 문서 생성 + 교차 참조 추가 (권장)\n2. 기존 문서 업데이트 (동일한 인사이트의 보완인 경우)\n3. 기타\n\n선택 (1-3): _","type":"text"}]},{"type":"paragraph","content":[{"text":"사용자 응답 대기 후 선택한 액션 실행.","type":"text"}]},{"type":"paragraph","content":[{"text":"유사 문서 없으면","type":"text","marks":[{"type":"strong"}]},{"text":" Step 4로 바로 진행. \u003c/step>","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"4\" required=\"true\" depends_on=\"2\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4: 파일명 생성","type":"text"}]},{"type":"paragraph","content":[{"text":"형식: ","type":"text"},{"text":"YYYYMMDD-[sanitized-insight-slug].md","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Sanitization 규칙:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"소문자","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"공백 → 하이픈","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"특수문자 제거 (하이픈 제외)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"80자 미만으로 truncate","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"예시:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"20260304-claude-code-skill-structure.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"20260304-mcp-server-debugging-pattern.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"20260304-prompt-iteration-framework.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" \u003c/step>","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"5\" required=\"true\" depends_on=\"4\" blocking=\"true\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 5: YAML 검증 (BLOCKING)","type":"text"}]},{"type":"paragraph","content":[{"text":"schema.yaml 기반으로 모든 필수 필드 검증.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"\u003cvalidation_gate name=\"yaml-schema\" blocking=\"true\">","type":"text"}]},{"type":"paragraph","content":[{"text":"검증 항목:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"domain","type":"text","marks":[{"type":"code_inline"}]},{"text":": schema.yaml의 enum 값 중 하나","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"date","type":"text","marks":[{"type":"code_inline"}]},{"text":": YYYY-MM-DD 형식","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"insight_type","type":"text","marks":[{"type":"code_inline"}]},{"text":": schema.yaml의 enum 값 중 하나","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"component","type":"text","marks":[{"type":"code_inline"}]},{"text":": 해당 domain에 매핑된 enum 값 중 하나 (","type":"text"},{"text":"domain_component_mapping","type":"text","marks":[{"type":"code_inline"}]},{"text":" 확인)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"context","type":"text","marks":[{"type":"code_inline"}]},{"text":": 20-300자, 구체적 상황 서술","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"key_learning","type":"text","marks":[{"type":"code_inline"}]},{"text":": 10-200자, 일반화 가능한 교훈","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"impact","type":"text","marks":[{"type":"code_inline"}]},{"text":": critical / high / medium / low","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"tags","type":"text","marks":[{"type":"code_inline"}]},{"text":": 1-8개, 소문자 하이픈 구분","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"검증 실패 시 Step 6 차단:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"YAML 검증 실패\n\n오류:\n- domain: 허용된 값이 아님 → work, learning, project, tool, personal 중 하나\n- component: domain에 허용되지 않는 컴포넌트 → schema.yaml 참조\n- tags: 대문자 포함 → 소문자로 변환 필요\n\n수정된 값을 제공해주세요.","type":"text"}]},{"type":"paragraph","content":[{"text":"GATE 강제:","type":"text","marks":[{"type":"strong"}]},{"text":" 모든 검증 통과 전까지 Step 6 진행 금지.","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003c/validation_gate> \u003c/step>","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"6\" required=\"true\" depends_on=\"5\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 6: 문서 작성","type":"text"}]},{"type":"paragraph","content":[{"text":"카테고리 디렉토리 결정:","type":"text","marks":[{"type":"strong"}]},{"text":" schema.yaml의 ","type":"text"},{"text":"category_mapping","type":"text","marks":[{"type":"code_inline"}]},{"text":"으로 insight_type → 저장 경로 매핑.","type":"text"}]},{"type":"paragraph","content":[{"text":"문서 생성:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"INSIGHT_TYPE=\"[검증된 YAML에서]\"\nCATEGORY_DIR=\"[category_mapping에서 매핑]\"\nFILENAME=\"[Step 4에서 생성]\"\nDOC_PATH=\"${CATEGORY_DIR}${FILENAME}\"\n\n# 디렉토리 없으면 생성\nmkdir -p \"${CATEGORY_DIR}\"\n\n# assets/resolution-template.md 기반으로 문서 작성\n# (Step 2에서 수집한 컨텍스트 + Step 5에서 검증한 YAML frontmatter)","type":"text"}]},{"type":"paragraph","content":[{"text":"결과:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"카테고리 디렉토리에 단일 파일 생성","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Enum 검증으로 일관된 분류 보장 \u003c/step>","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"\u003cstep number=\"7\" required=\"false\" depends_on=\"6\">","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 7: 교차 참조 & 패턴 감지","type":"text"}]},{"type":"paragraph","content":[{"text":"Step 3에서 유사 문서 발견된 경우:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# 기존 문서에 Related 섹션 추가\n# 새 문서에도 기존 문서 링크 추가","type":"text"}]},{"type":"paragraph","content":[{"text":"패턴 후보 감지:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"동일 카테고리에 유사 인사이트 3개 이상 존재하면:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"패턴 문서 후보 감지: [카테고리]에 유사 인사이트 X개\n→ patterns/ 문서로 종합하시겠습니까?","type":"text"}]},{"type":"paragraph","content":[{"text":"Critical Pattern 승격 조건 (자동 승격 금지, 사용자 결정):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"impact가 ","type":"text"},{"text":"critical","type":"text","marks":[{"type":"code_inline"}]},{"text":"인 경우","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"여러 도메인에 횡단 적용 가능한 경우","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"반드시 기억해야 하는 경우","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"이 경우 Decision Menu에서 \"2. 크리티컬 패턴에 추가\" 옵션에 주석 추가:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"이 인사이트는 크리티컬 패턴 승격을 고려해볼 만합니다","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003c/step>","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003c/critical_sequence>","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"paragraph","content":[{"text":"\u003cdecision_gate name=\"post-documentation\" wait_for_user=\"true\">","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Decision Menu After Capture","type":"text"}]},{"type":"paragraph","content":[{"text":"문서화 성공 후 선택지 제시 및 사용자 응답 대기:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"인사이트가 기록되었습니다.\n\n파일 생성:\n- knowledge/[category]/[filename].md\n\n다음 작업:\n1. 계속 진행 (권장)\n2. 크리티컬 패턴에 추가 - critical-patterns.md에 승격\n3. 관련 문서 연결 - 유사 인사이트와 교차 참조\n4. 기존 스킬에 추가 - .claude/skills/에 연결\n5. 문서 확인 - 생성된 내용 보기\n\n선택: _","type":"text"}]},{"type":"paragraph","content":[{"text":"각 옵션 처리:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Option 1: 계속 진행","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"현재 작업/워크플로우로 복귀","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"문서화 완료","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Option 2: 크리티컬 패턴에 추가","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"사용자가 선택하는 경우:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"반복 적용되는 패턴","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"절대 잊어서는 안 되는 교훈","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"비직관적이지만 필수적인 규칙","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"액션:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"문서에서 패턴 추출","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"assets/critical-pattern-template.md 형식으로 구조화","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"knowledge/patterns/critical-patterns.md","type":"text","marks":[{"type":"code_inline"}]},{"text":"에 추가 (순번 유지)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"해당 문서에 교차 참조 추가","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"확인: \"크리티컬 패턴에 추가되었습니다.\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Option 3: 관련 문서 연결","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"프롬프트: \"어떤 문서와 연결할까요? (파일명 또는 주제 설명)\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"knowledge/","type":"text","marks":[{"type":"code_inline"}]},{"text":"에서 대상 문서 검색","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"양방향 교차 참조 추가","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"확인: \"교차 참조가 추가되었습니다\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Option 4: 기존 스킬에 추가","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"프롬프트: \"어떤 스킬에 추가할까요?\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":".claude/skills/[skill-name]/","type":"text","marks":[{"type":"code_inline"}]},{"text":"의 적절한 파일에 링크와 설명 추가","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"확인: \"[skill-name] 스킬에 추가되었습니다\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Option 5: 문서 확인","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"생성된 문서 내용 표시","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Decision Menu 다시 제시","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"\u003c/decision_gate>","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"paragraph","content":[{"text":"\u003cintegration_protocol>","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"통합 지점","type":"text"}]},{"type":"paragraph","content":[{"text":"호출 트리거:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"/compound","type":"text","marks":[{"type":"code_inline"}]},{"text":" 커맨드 (주 인터페이스)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"대화 중 확인 문구 자동 감지","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"워크플로우 완료 후 수동 호출","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"호출하는 스킬/에이전트:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"없음 (terminal 스킬 - 다른 스킬에 위임하지 않음)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Handoff 조건:","type":"text","marks":[{"type":"strong"}]},{"text":" 호출 전 대화 이력에 충분한 컨텍스트가 있어야 함.","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003c/integration_protocol>","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"paragraph","content":[{"text":"\u003csuccess_criteria>","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"성공 기준","type":"text"}]},{"type":"paragraph","content":[{"text":"다음 모든 조건이 충족될 때 문서화 성공:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"YAML frontmatter 검증 통과 (모든 필수 필드, 올바른 형식, 유효한 enum 값)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"knowledge/[category]/[filename].md","type":"text","marks":[{"type":"code_inline"}]},{"text":"에 파일 생성됨","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"domain-component 매핑이 schema.yaml과 일치","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Context, What Worked, Why This Works 섹션이 구체적으로 작성됨","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"유사 문서 발견 시 교차 참조 추가됨","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"사용자에게 Decision Menu 제시 및 액션 확인됨","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"\u003c/success_criteria>","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"에러 처리","type":"text"}]},{"type":"paragraph","content":[{"text":"컨텍스트 부족:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"사용자에게 누락된 정보 질문","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"필수 정보 확보 전 진행 금지","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"YAML 검증 실패:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"구체적인 오류 항목 표시","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"수정된 값으로 재시도","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"통과할 때까지 차단","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"유사 인사이트 모호함:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"여러 후보 모두 표시","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"사용자 선택: 새 문서 / 기존 업데이트 / 별도 연결","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"카테고리 매핑 불확실:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"가장 근접한 카테고리 제안","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"사용자 확인 후 진행","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"실행 가이드라인","type":"text"}]},{"type":"paragraph","content":[{"text":"반드시 해야 하는 것:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"YAML frontmatter 검증 (Step 5 validation gate는 blocking)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"domain-component 매핑 유효성 확인","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"파일 작성 전 ","type":"text"},{"text":"mkdir -p","type":"text","marks":[{"type":"code_inline"}]},{"text":"로 디렉토리 생성","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"컨텍스트 누락 시 사용자에게 묻고 대기","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"key_learning은 다른 상황에도 적용 가능하게 일반화","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"절대 하지 말아야 하는 것:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"YAML 검증 건너뛰기 (validation gate는 blocking)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"모호한 설명으로 문서화 (검색 불가)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"가설이나 미검증 내용 문서화","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"critical pattern 자동 승격 (사용자 결정 필요)","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"예시 시나리오","type":"text"}]},{"type":"paragraph","content":[{"text":"사용자:","type":"text","marks":[{"type":"strong"}]},{"text":" \"Claude Code에서 스킬 만들 때 references/ 폴더에 예시를 넣었더니 훨씬 정확하게 따라하더라. 다음에도 이렇게 하자.\"","type":"text"}]},{"type":"paragraph","content":[{"text":"스킬 활성화:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"트리거 감지:","type":"text","marks":[{"type":"strong"}]},{"text":" \"다음에도 이렇게 하자\" → 자동 활성화","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"컨텍스트 수집:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"domain: tool","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"insight_type: tool_discovery","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"component: claude-code","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"context: \"Claude Code 스킬 작성 시 SKILL.md만 두는 것보다 references/ 폴더에 구체적 예시 파일을 함께 두었을 때 스킬 실행 정확도가 크게 향상됨\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"key_learning: \"AI 스킬/프롬프트 작성 시 추상적 지시보다 구체적 예시 파일을 함께 제공하면 실행 정확도가 높아진다\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"impact: high","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"tags: [claude-code, skill, references, accuracy, prompt-engineering]","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"기존 문서 검색:","type":"text","marks":[{"type":"strong"}]},{"text":" knowledge/tool-discoveries/ 검색","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"파일명 생성:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"20260304-skill-references-improve-accuracy.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"YAML 검증:","type":"text","marks":[{"type":"strong"}]},{"text":" 통과","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"문서 작성:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"knowledge/tool-discoveries/20260304-skill-references-improve-accuracy.md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"교차 참조:","type":"text","marks":[{"type":"strong"}]},{"text":" 없음 (유사 문서 없음)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"출력:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"인사이트가 기록되었습니다.\n\n파일 생성:\n- knowledge/tool-discoveries/20260304-skill-references-improve-accuracy.md\n\n다음 작업:\n1. 계속 진행 (권장)\n2. 크리티컬 패턴에 추가 - critical-patterns.md에 승격\n3. 관련 문서 연결 - 유사 인사이트와 교차 참조\n4. 기존 스킬에 추가 - .claude/skills/에 연결\n5. 문서 확인 - 생성된 내용 보기","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"compound","author":"@skillopedia","source":{"stars":17,"repo_name":"camp-2","origin_url":"https://github.com/ai-native-camp/camp-2/blob/HEAD/.claude/skills/compound/SKILL.md","repo_owner":"ai-native-camp","body_sha256":"bd7e2f1dde8ba990854d4687266bf096852eec9c47cc390d6736e6227566e008","cluster_key":"ea2e93565ebb93d1cebb004193d2863d097c7b20882c3bb6a59e719d9071754a","clean_bundle":{"format":"clean-skill-bundle-v1","source":"ai-native-camp/camp-2/.claude/skills/compound/SKILL.md","attachments":[{"id":"c912f981-a09e-538a-9da5-b212af496e59","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/c912f981-a09e-538a-9da5-b212af496e59/attachment.md","path":"assets/critical-pattern-template.md","size":491,"sha256":"9720e9634cd79d3708234f3ac42094fa633a455038ed6a9def21a43e135e7492","contentType":"text/markdown; charset=utf-8"},{"id":"5ea0fb2d-cdd9-567d-bf4f-6da78220904b","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/5ea0fb2d-cdd9-567d-bf4f-6da78220904b/attachment.md","path":"assets/resolution-template.md","size":1422,"sha256":"de85799e33338a54a6076d58de57f1868fd60f636c861313449954b9a2a37e03","contentType":"text/markdown; charset=utf-8"},{"id":"3f524f92-e47b-575a-94a1-35ec6b96a097","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/3f524f92-e47b-575a-94a1-35ec6b96a097/attachment.yaml","path":"schema.yaml","size":3859,"sha256":"43146f6fcc68f69bb53a801e23579b02643686c073cd85414c9926768ea308ac","contentType":"application/yaml; charset=utf-8"}],"bundle_sha256":"f1a2b2cc71713725ea6d44e6c41b047f185d82e3c4f37373a63141e5f96ca649","attachment_count":3,"text_attachments":3,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":".claude/skills/compound/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"general","category_label":"General"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"general","import_tag":"clean-skills-v1","description":"작업 중 발견한 인사이트를 구조화된 문서로 축적하여 나만의 지식 베이스를 복리로 성장시킨다","allowed-tools":["Read","Write","Bash","Grep"],"preconditions":["인사이트가 확인됨 (가설이 아닌 검증된 학습)","해당 인사이트가 재사용 가치가 있음"]}},"renderedAt":1782979625581}

compound 스킬 목적: 작업 과정에서 검증된 인사이트를 즉시 문서화하여, 검색 가능한 지식 베이스를 구축한다. 개요 이 스킬은 인사이트가 확인되는 즉시 포착하여, YAML frontmatter 기반의 구조화된 문서로 저장한다. 카테고리별 단일 파일 아키텍처를 사용하며, 각 인사이트는 에 저장된다. --- <critical sequence name="insight-capture" enforce order="strict" 7단계 프로세스 <step number="1" required="true" Step 1: 트리거 감지 자동 감지 문구 (대화에서 인식): - "이거 잘 됐다" - "이 방식이 좋네" - "다음에도 이렇게 하자" - "이건 기록해두자" - "이 포맷이 먹혔다" - "이게 효과가 있었어" - "이렇게 하니까 됐어" - "기억해둬야 해" OR 수동: 커맨드 Non-trivial만 (재사용 가치 있는 인사이트): - 반복할 수 있는 패턴 - 다른 상황에도 적용 가능한 교훈 - 시행착오 끝에 발견한 방법 - 실전에서 검증된 접근법 - 구조적 개선을 가져온 발견 스킵 기준: - 이 상황에서만 통하는 일회성 방법 - 단순 사실 기록 (수치, 날짜 등…