ruby-skill

name	ruby-skill
version	1
description	러비스킬(러셀+비트겐슈타인). 코딩·문서·콘텐츠를 분해→평가→아름다운 상위 설계로 승격. 러셀 구조분해+비트겐슈타인 의미검증 이중 프레임. 트리거: 러비스킬, ruby skill, 러비, 상위설계, 아름다운설계, 논리분해, 구조분해, 의미검증, 코드리뷰, 문서리뷰, 콘텐츠리뷰, 러셀, 비트겐슈타인, 분해해줘, 평가해줘, 올려줘, 상위설계해줘, 아름답게해줘, decompose, elevate, review. NOT: 단순디버깅(→직접수행), 사업전략(→biz-skill), UI설계(→ui-designer), 히트패턴(→hit-skill).

Ruby Skill — 러비스킬 (러셀 + 비트겐슈타인)

핵심 공식: 러셀로 뼈대를 자르고, 비트겐슈타인으로 살아있는 의미를 검증하면, 아름다운 상위 설계가 가능하다.

Skill Boundaries

• 하는 것 — 러비스킬(러셀+비트겐슈타인).
• 안 하는 것 — 단순디버깅(→직접수행), 사업전략(→biz-skill), UI설계(→ui-designer), 히트패턴(→hit-skill).

아름다움 정의: 목적에 대해 최소 구조로 최대 의미를 내는 상태

---

When to Use

• 사용자가 "분해해줘", "평가해줘", "올려줘", "상위설계해줘", "아름답게해줘" 같은 표현으로 발동
• 도메인 작업이 필요한 시점
• 안 쓸 때 — 단순디버깅(→직접수행), 사업전략(→biz-skill), UI설계(→ui-designer), 히트패턴(→hit-skill).

Prerequisites

#	체크	미충족 시
1	대상·입력 명확 (스킬 발동 의도 확인)	1줄 확인 후 진입
2	references/ 폴더 접근 가능	inline fallback

⛔ 절대 규칙

#	규칙	이유
1	디테일 누락 = FAIL	분해 단계에서 원본 요소를 하나라도 빠뜨리면 상위 설계가 왜곡됨
2	매핑 테이블 선행	원본 → 분해 결과의 완전한 매핑을 먼저 출력, 확인 후 평가 진행
3	무단 삭제 금지	요소 제거 시 반드시 "왜 제거하는가" 명시. 삭제 아닌 _archive 이동
4	이중 검증 필수	러셀(구조) + 비트겐슈타인(의미) 모두 통과해야 상위 설계 인정

---

3모드

모드	트리거	실행
진단	"분해해줘", "분석해줘"	분해→매핑테이블→현재 상태 6축 진단
평가	"평가해줘", "리뷰해줘"	진단 + 이중 검증(러셀+비트겐슈타인) + 병목 식별
상위설계	"올려줘", "상위설계해줘", "아름답게해줘"	평가 + 상위 설계안 제시 (기본 모드)

모드 미지정 시 → 상위설계 모드 (풀코스)

---

실행 파이프라인

Phase 0: 도메인 판별

입력을 보고 도메인 판별 → references/domain-adapters.md 로드

• 코딩 / 문서 / 콘텐츠 / 하이브리드

Phase 1: 러셀 분해 (구조의 칼)

references/russell-frame.md 로드 후 실행

단계	내용
1-1	원자적 단위 분해: 더 이상 나눌 수 없는 단위까지 환원
1-2	유형 분류: 각 단위의 추상 수준(type level) 태깅
1-3	기술 분석: 모호한 표현 → 존재/유일성/속성 3분해
1-4	공리 추출: 이 산출물이 암묵적으로 가정하는 것 명시화
1-5	불필요 추상화 식별: Russell's Razor로 제거 후보 마킹

산출물: 매핑 테이블 (원본 요소 → 분해 결과, 누락 없음 확인)

Phase 2: 비트겐슈타인 검증 (의미의 체)

references/wittgenstein-frame.md 로드 후 실행. Phase 1의 매핑 테이블을 입력으로 사용 — 각 원자 요소에 대해 의미 검증을 수행한다. 구조(러셀)가 통과해도 의미(비트겐슈타인)가 실패할 수 있으므로, 매핑 테이블의 모든 행을 2-1~2-5로 검증.

조건부 병렬: Phase 1(러셀 분해) 완료 후, Phase 2(비트겐슈타인 검증)와 Phase 3(승격 설계)는 Phase 1 매핑 테이블을 공유 입력으로 병렬 착수 가능. Phase 2 결과가 Phase 3을 뒤집을 경우만 Phase 3 수정.

단계	내용
2-1	그림이론 체크: 표현과 현실의 동형성 검증
2-2	언어게임 체크: 용어가 사용 맥락에서 일관적인가
2-3	규칙 따르기 체크: 컨벤션이 실제 관행과 일치하는가
2-4	삶의 형식 체크: 팀/사용자/독자의 맥락을 반영하는가
2-5	사적 언어 체크: 저자 외에도 이해 가능한가

산출물: 8항 검증 결과 (통과/미통과 + 이유)

Phase 3: 6축 판정

references/beauty-criteria.md 로드 후 실행

축	◎/△/✕	근거
목적성
방향성
정합성
최소성
확장성
사용적합성

병목 축 식별 → 판정 문장 생성 + 상위 설계 방향 결정

판정 문장 생성 (모든 모드에서 필수):

1. ✕ 또는 최저 △ 축 식별
2. beauty-criteria "병목 축별 상위 설계 방향"에서 방향 추출
3. 현재 Level(L0~L4)과 목표 Level 갭 명시
4. 한 문장으로 종합: "[현재 Level]. [병목 축]이 [목표 Level] 도달을 막고 있다 — [구체적 증상]."

Phase 4: 상위 설계안 제시 (상위설계 모드만)

항목	내용
현재 Level	L0~L4 판정 (beauty-criteria 참조)
목표 Level	최소 L2, 가능하면 L3~L4
병목 해결안	가장 낮은 축부터 구체적 개선안
디테일 보존 매트릭스	필수 출력 — 원본의 모든 원자 요소를 행으로, 운명(유지/변환/제거)·변환 내용·사유를 열로 하는 표. Before/After 컬럼을 통합하여 1회 작성으로 보존 확인+변경 대조 동시 수행. 누락 행 = FAIL

검증 통합: 디테일 보존 매트릭스에 Before/After 컬럼을 통합. 별도 Before/After 검증 단계 제거 — 매트릭스 1회 작성으로 보존 확인+변경 대조 동시 수행.

Phase 5: 자기검증

체크	내용
누락 체크	매핑 테이블의 모든 원본 요소가 상위 설계에 반영되었는가
논리 검증	상위 설계 자체를 러셀 분해로 재검증
의미 검증	상위 설계를 비트겐슈타인 체크로 재검증
실행 가능성	제안이 실제로 구현/적용 가능한가

Phase 6: 리포트 변환 (3-Layer)

Phase 15 분석 완료 후, 중간 산출물을 그대로 출력하지 않는다. 아래 리포트 구조로 재구성한다. 분석 엔진(Phase 15)은 "분석", 이 단계는 "표현" — 역할 분리.

🚨 MUST cascade → shaper-skill

모든 산출물 shaper-skill MUST 경유. → shaper-skill/references/_common/cascade-must.md

논리 4요소 활용

상위 설계 과정에서 4요소 순환 적용:

요소	역할
연역	기존 원리(공리)에서 구조 도출
귀납	반복 패턴 발견 → 규칙으로 일반화
가추	새로운 상위 구조 가설 생성
확률	맥락 변수 고려한 적합성 판단

---

§INV NO_WORK_LABEL

산출물·대화 작업 라벨 ZERO. → shaper-skill/references/no-work-label.md

Output Path

산출물	경로
주 산출물	mnt/outputs/ruby-skill_{topic}_{YYYY-MM-DD}.md
형식	분석결과로, 상위설계안으로, .md로.
리서치 결과 (해당 시)	{VAULT}/_skills research/ruby-skill/{YYYY-MM-DD}_{topic}.md

Reference Index

파일	내용	언제
references/beauty-criteria.md	beauty criteria	해당 단계 진입 시
references/domain-adapters.md	domain adapters	해당 단계 진입 시
references/report-layer.md	report layer	해당 단계 진입 시
references/russell-frame.md	russell frame	해당 단계 진입 시
references/wittgenstein-frame.md	wittgenstein frame	해당 단계 진입 시

Next Phase

본 스킬 작업 후 자연스럽게 이어지는 흐름:

• 후속 작업 → 직접수행
• 후속 작업 → biz-skill
• 후속 작업 → ui-designer
• 후속 작업 → hit-skill

Failure Modes (Gotchas)

• 분해 과잉 함정: 원자까지 분해하되, 분해 자체가 목적이 되면 안 됨. 상위 설계에 필요한 깊이까지만
• 러셀 편향 함정: 구조만 완벽하고 의미 검증을 건너뛰면 "맞는 말인데 안 먹힘" 상태
• 비트겐슈타인 편향 함정: 맥락만 보고 논리 구조를 무시하면 "먹히는데 허술" 상태
• 최소성 과적용: Russell's Razor를 과하게 적용하면 필요한 추상화까지 제거. "이 추상화가 없으면 이해/유지보수가 더 어려운가?" 반문 필수
• 디테일 보존 착각: 매핑 테이블을 만들었다고 디테일을 보존한 것이 아님. 상위 설계안에서 각 요소의 운명(유지/변환/제거+사유)이 명시되어야 완료
• 데이터 시트 함정: 6축 점수표·분해 매핑·검증 체크리스트를 나열식으로 먼저 출력하면 "그래서 뭘 어쩌라고?" 상태. 반드시 판정 문장(Layer 1)이 리포트 첫 줄. 분석 과정은 Layer 3(부록)으로
• 판정 문장 누락: 6축 점수는 나오지만 종합 판정이 빠지면 의사결정 불가. Phase 3 완료 시 판정 문장 생성을 반드시 실행

❌ WRONG vs ✅ CORRECT

❌ WRONG: 트리거 단어만 보고 발동 — 본질·범위 확인 ✗ → 오발동·범위 이탈
✅ CORRECT: Skill Boundaries·When to Use 확인 후 발동 → 본질 작업만 수행