lofibrainwav/skill-lesson-index

Skill-Lesson Index — 교훈 도메인 카탈로그

원칙: 교훈의 SSOT는 metacognition.md. 이 파일은 포인터만 제공한다. 사용법: 스킬 호출 시 해당 도메인의 교훈 번호를 확인 → 필요하면 원본 참조. 갱신: 새 교훈 등록 시 해당 도메인에 번호 추가.

4층 스킬 생태계

metacognition.md (210+ 교훈, SSOT)
    │
    ├─→ bb/03-Skills/ (층1: 볼트 스킬, 52개 패턴 카드)
    │     └─ pattern-promoter.js 자동 승격
    │     └─ 소비자: agent-skill-registry.js fetchFromVault()
    │
    ├─→ kingdom/.claude/skills/ (층2: 에이전트 무장, 285개)
    │     └─ 5단 프로모션: Draft→Validate→Deploy→Registry→Bridge
    │     └─ 소비자: 29개 에이전트 런타임 (armAgent)
    │     └─ 관리자: 자룡이 (코드 도메인)
    │
    ├─→ bb/.claude/skills/ (층3: 세션 인스트럭션, 이 폴더)
    │     └─ Gotchas = 교훈 번호 포인터 (복사 금지, 교훈 28)
    │     └─ 소비자: Claude Code/Cowork 프롬프트 시스템
    │     └─ 관리자: 산이 (세션 도메인)
    │
    └─→ deer-flow/skills/ (층4: 리서치 변환, 17개)
          └─ skill-bridge.js가 층2에서 변환
          └─ 소비자: DeerFlow LangGraph load_skills()

원칙: 4개 층은 같은 교훈 원본을 다른 소비자가 다른 형태로 쓴다. 경쟁 아닌 파이프라인. 경계: 층2는 자룡이 영역 (kingdom/ 코드), 층3은 산이 영역 (bb/ 세션). 월권 금지.

승격 파이프라인 (교훈 → 스킬)

metacognition.md (원본 장부, SSOT)
    ↓ vault-autopilot 자동 요약
metacognition-digest.md (살아있는 사서)
    ↓ 반복 위반 시 승격 (교훈 268)
CLAUDE.md (전역 불변 규약, Hard Bans)
    ↓ 도메인별 포인터
bb/.claude/skills/*/SKILL.md (층3 실행 매뉴얼, Gotchas = 포인터)
    ↓ pattern-promoter.js
bb/03-Skills/ (층1 패턴 카드) → kingdom/ skills (층2 에이전트 무장)

도메인별 교훈 맵

vault-health (Obsidian/Vault 관리)

교훈: 1, 37, 38, 39, 40, 47, 50, 53, 63, 77, 98, 109, 150, 151, 154, 157, 234 핵심: 플러그인은 data.json 확인, nested repo 필터, CSS snippet UI토글, wikilink basename match

safe-commit (Git 안전)

교훈: 24, 36, 48, 83, 88, 91, 100, 161, 246, 297, 305 핵심: git add . 금지, worktree 필수, 완료=remote 도착, 5단 검증

cmux-orchestrator (멀티 에이전트)

교훈: 26, 55, 70, 82, 83, 101, 105, 106, 123, 125, 126, 162, 164, 173, 175, 266 핵심: GATE 시스템, 재귀 호출 금지, surface 영역 분리, concurrency cap

paperclip (이슈 트래커)

교훈: 68, 75, 76, 98, 119, 153 핵심: identifier 추측 금지, graceful fallback, 육하원칙 기록

session-protocol (세션 시작/종료)

교훈: 30, 32, 33, 41, 42, 63, 71, 76, 89, 109, 197, 198 핵심: 실측 먼저, bb/기 kingdom/파 분리, 측정→계획→실행

test-guard (테스트 규약)

교훈: 22, 25, 45, 62, 73, 93, 96, 97, 100, 113, 140, 141, 142, 143, 145 핵심: E2E=실행패턴 재현, mock≠실전, catch빈블록 금지, rate limiting

dependency-audit (의존성 관리)

교훈: 19, 20, 27, 68, 78, 79, 104, 108, 110, 129, 138, 144, 146, 147, 199, 210 핵심: DI 전파, fallback은 실행가능해야, 새 도구=런타임 확인, 공급망 공격

agent-dispatch (에이전트 배정/라우팅)

교훈: 34, 55, 56, 57, 58, 80, 82, 84, 85, 111, 112, 114, 116, 120, 126, 130, 131, 132, 155, 156 핵심: 명장에 명마, 로컬우선, 3-tier 라우팅, 외부AI=재료수집용

infra-ops (인프라 운영)

교훈: 29, 64, 65, 86, 87, 90, 92, 95, 128, 149, 158, 159, 160, 165, 199, 200, 208, 209 핵심: 관측 독립, 단일장애점 cascade, MemoryMax, tail 파싱 금지

philosophy (진선미/氣波/메타인지)

교훈: 23, 28, 43, 44, 46, 49, 51, 52, 59, 60, 69, 72, 121, 124, 161, 233, 268, 269, 297 핵심: SSOT는 하나, 진선미 기준, 환류루프 폐합, 출처위조 금지

층2 Kingdom 스킬 ↔ 층3 세션 스킬 매핑

층2(kingdom/ 285개)와 층3(bb/.claude/ 4+개)는 소비자가 다르지만 같은 교훈 도메인을 공유한다. 아래는 agent-skill-registry.js AGENT_SKILL_MAP 기준 핵심 13개 kingdom 스킬과 층3 도메인의 대응.

| Kingdom 스킬 (층2) | 에이전트 | 대응 층3 도메인 | 공유 교훈 | |---|---|---|---| | search-first | Architect, Decomposer | session-protocol | 109, 154 | | context-architecture | Architect | philosophy | 28, 233 | | cost-aware-llm-pipeline | Coder | infra-ops | 199, 200 | | dev-tool-belt | Coder | safe-commit | 83, 246 | | accuracy-verification | Reviewer | test-guard | 97, 161 | | verification-loop | Reviewer | test-guard | 297, 305 | | automated-debugging | FailureAgent | dependency-audit | 104, 129 | | health-monitor | FailureAgent, Watchdog | infra-ops | 92, 158 | | agent-teams | TeamLead | agent-dispatch | 55, 82 | | capability-registry | TeamLead | agent-dispatch | 120, 126 | | obsidian-sync | ResearchAgent | vault-health | 37, 38, 234 | | docker-patterns | Deployer | infra-ops | 86, 87 | | verify-agents | Watchdog | test-guard | 113, 140 |

볼트 스킬 (층1, bb/03-Skills/) 대응

| 볼트 스킬 (층1) | 에이전트 | 대응 층3 도메인 | |---|---|---| | bmad-battle-doctrine | TeamLead | philosophy | | compounding-engineering | Coder | philosophy | | defensive-guard-placement | Coder | safe-commit | | accuracy-rules | Reviewer | test-guard | | silent-failure-detection | Reviewer, Watchdog | infra-ops | | golden-synergy | Decomposer | agent-dispatch | | guardrail-pattern | FailureAgent | safe-commit | | debugging | FailureAgent | dependency-audit | | three-tool-synergy-strategy | ResearchAgent | philosophy | | nested-repo-query-pollution | Deployer | vault-health | | session-cleanup-checklist | Watchdog | session-protocol | | stateful-stateless-mismatch | Architect | dependency-audit |

미분류 (단발성/특수)

교훈: 2, 3, 4, 35, 54, 61, 66, 67, 94, 99, 102, 103, 107, 117, 118, 122, 127, 133, 134, 135, 136, 137, 139, 148, 152, 163

See Also

• [[metacognition]] — 교훈 원본 (SSOT)
• [[metacognition-digest]] — 자동 생성 요약
• CLAUDE.md — 승격된 불변 규약