Communitygithub.com

SamuelChien/mega-skills-collection

기존 지식 시스템에 새로운 도메인을 추가합니다. 대화를 통해 도메인별 구성을 도출하고, 기존 아키텍처를 유지 및 연결하면서 도메인 폴더, 템플릿, 어휘를 생성합니다.

mega-skills-collection란 무엇인가요?

이 스킬은 기존 지식 시스템(예: 개인 위키, 메모 시스템)에 새로운 지식 도메인을 안전하게 추가하기 위한 AI 에이전트(Claude Code, Cursor 등)를 위한 상세한 워크플로우입니다. 기존 시스템을 교체하지 않고 구성(composition) 방식으로 확장합니다. 대화를 통해 사용자의 요구와 도메인 특성을 파악하고, 그로부터 도메인 전용 설정(어휘 매핑, 차원 위치, 스키마, 폴더 구조)을 유도합니다. 위키 링크, 허브 MOC, 설명 필드로 구성된 공유 그래프를 통해 새 도메인이 기존 도메인과 공존하면서 연결되도록 보장합니다. 이 스킬은 다중 도메인 구성, 충돌 검사, 점진적 컨텍스트 로딩과 같은 원칙을 적용하여 시스템이 확장되어도 일관성과 유지보수성을 유지합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/add-domain

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

당신은 기존 지식 시스템을 새로운 도메인으로 확장하고 있습니다. 이는 대체가 아닌 구성(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개의 후속 질문을 합니다:

  1. 어휘 확인 -- "[사용자의 용어]라고 말씀하셨는데, 개별 인사이트를 의미하나요 아니면 더 긴 항목을 의미하나요?"
  2. 교차 도메인 연결 패턴 -- "[새 도메인] 노트가 [기존 도메인] 노트와 연결되나요? 어떻게요?"

차원에 대해 직접 묻지 마십시오. 자연스러운 대화에서 신호를 찾으십시오.


3단계: 도메인 구성 유도

3a. 신호를 도메인 조정 가능 차원에 매핑

각 조정 가능 차원에 대해 새 도메인의 위치를 결정합니다:

  • 사용자 신호(최우선 순위)
  • ${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md에서 가장 가까운 사용 사례 프리셋
  • 시스템 수준 차원에서의 연쇄

3b. 어휘 매핑 구축

변환 테이블에 대해 ${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md를 읽습니다.

우선 순위:

  1. 대화에서 얻은 사용자의 고유 용어
  2. 사용 사례 프리셋 어휘
  3. 가장 가까운 참조 도메인 혼합

새 도메인에 대한 완전한 매핑을 구축합니다:

보편 용어새 도메인 용어출처
노트[용어][사용자 / 프리셋 / 혼합]
추출 / 축소[용어][사용자 / 프리셋 / 혼합]
연결 / 반영[용어][사용자 / 프리셋 / 혼합]
MOC[용어][사용자 / 프리셋 / 혼합]
설명[용어][사용자 / 프리셋 / 혼합]
주제[용어][사용자 / 프리셋 / 혼합]
인박스[용어][사용자 / 프리셋 / 혼합]

3c. 도메인별 스키마 설계

기본 노트 스키마(설명, 주제)에서 시작하여 도메인별 필드를 추가합니다:

_schema:
  entity_type: "[도메인]-노트"
  applies_to: "[도메인-폴더]/*.md"
  required:
    - 설명
    - 주제
  optional:
    - [대화 신호 기반 도메인별 필드]
  enums:
    [필드]:
      - [도메인 관련 값]

3d. 충돌 검사

이는 다중 도메인 구성에 중요합니다. 다음을 확인합니다:

  1. 파일 이름 고유성 -- 새 도메인의 노트 제목이 기존 노트와 충돌하지 않아야 합니다. 위키 링크는 전체 워크스페이스에서 파일 이름으로 확인되므로 모든 파일 이름은 고유해야 합니다.

  2. 스키마 필드 이름 -- 새 도메인 필드가 기존 도메인 필드와 충돌하지 않아야 합니다. 두 도메인이 동일한 필드 이름(예: type)을 사용하는 경우 열거형 값이 상호 배타적이거나 필드가 호환 가능한 의미를 가져야 합니다.

  3. 템플릿 이름 -- 새 도메인 템플릿이 기존 템플릿과 다른 이름을 가져야 합니다.

  4. 폴더 이름 -- 새 도메인 폴더가 기존 폴더와 충돌하지 않아야 합니다.

충돌이 감지되면 진행하기 전에 해결합니다.


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단계: 검증

새 도메인 파일에 대한 커널 검사

새 도메인 파일에 대해 커널 검증을 실행합니다:

  1. 모든 새 파일에 YAML 프론트매터가 유효함
  2. 새 파일의 위키 링크가 확인됨(교차 도메인 링크 포함)
  3. 새 도메인 MOC가 허브에서 도달 가능함
  4. 설명 필드가 존재함
  5. 주제 바닥글이 도메인 MOC를 참조함

구성 검증

  1. 필드 충돌 없음 -- 모든 템플릿에서 필드 이름을 grep하여 의미적 충돌이 없는지 확인
  2. 허브 도달 가능성 -- 허브 MOC가 모든 도메인 MOC에 연결되고, 모든 도메인 MOC가 해당 노트에 연결됨
  3. 교차 도메인 링크 테스트 -- 새 도메인에서 기존 도메인으로의 테스트 링크를 생성하고 확인되는지 확인
  4. 파일 이름 고유성 -- 모든 도메인에서 중복 파일 이름이 없는지 확인:
    find . -name "*.md" -exec basename {} \; | sort | uniq -d
    

완료 확인

새로 추가된 도메인으로 시스템이 작동하는지 확인:

  1. 새 템플릿을 사용하여 캡처 워크플로우 시뮬레이션
  2. 새 도메인에서 기존 도메인으로의 교차 도메인 링크 확인
  3. 허브 MOC가 모든 도메인을 나열하는지 확인
  4. 새 도메인 컨텍스트에 도메인 가이드가 포함되는지 확인

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

관련 스킬