Communitygithub.com

yezhwi/framework-distillation

오픈소스 프레임워크를 인간과 AI 모두를 위한 아키텍처 플레이북(playbook)으로 변환합니다.

framework-distillation란 무엇인가요?

이 스킬은 역공학을 통해 프레임워크의 진정한 아키텍처를 추출하는 데 특화되어 있습니다. 단순한 README나 API 문서를 넘어, 프레임워크의 핵심 구조, 런타임 모델, 확장 지점(extension points), 그리고 엔지니어링 트레이드오프를 분석하여 인간 개발자나 다른 AI 시스템이 재사용할 수 있는 지식 패키지로 가공합니다. 주로 에이전트 런타임, 워크플로 엔진, 상태 머신 프레임워크, 플러그인 시스템, 오케스트레이션 플랫폼 등을 분석 대상으로 하며, 분석 깊이는 'mini', 'standard', 'deep' 세 가지 모드로 조절 가능합니다. 코드 자체를 복사하거나 단순히 API 기능을 나열하는 것이 아니라, 아키텍처 패턴과 결정 배경, 트레이드오프와 같은 근본적인 설계 원리를 추출하여 다른 언어나 도메인에서 유사한 아키텍처를 재현할 수 있도록 지원합니다. 또한, 분석 결과는 증거(코드, 문서, 테스트)에 근거하여 사실과 추론을 명확히 구분하며, 증거가 부족한 경우 이를 명시적으로 표시합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add yezhwi/framework-distillation

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

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

문서

프레임워크 추출 (Framework Distillation)

개요

코드가 아닌 아키텍처를 추출하세요.

이 스킬을 사용하여 프레임워크의 형태, 런타임 모델, 확장 지점, 엔지니어링 트레이드오프를 역공학으로 분석함으로써, 다른 AI나 팀이 다른 언어나 도메인에서 유사한 아키텍처를 재현할 수 있도록 합니다.

사용 시기

  • README와 공개 API 이상의 프레임워크 아키텍처 역공학
  • 런타임, 라이프사이클, 상태 머신 또는 확장 메커니즘 연구
  • 다른 언어나 도메인에서 유사한 프레임워크 재현
  • AI가 읽을 수 있는 아키텍처 지식 패키지 생성
  • 아키텍처와 트레이드오프 관점에서 프레임워크 비교

일반적인 대상: 에이전트 런타임, 워크플로 엔진, 상태 머신 프레임워크, 플러그인 시스템, 오케스트레이션 플랫폼.

사용하지 말아야 할 경우

  • README 요약만
  • API 튜토리얼 또는 사용 가이드
  • 라인별 코드 분석
  • 복사-붙여넣기 재구현
  • 트레이드오프 분석 없는 기능 목록

요청이 유사하지만 목표와 다를 경우, 먼저 범위를 재조정(re-redirect)하세요.

필수 입력 사항

최소:

  • 저장소 URL 또는 로컬 소스 경로

권장:

  • 프레임워크 이름
  • 분석 목표
  • 대상 구현 언어 또는 도메인
  • 깊이: mini, standard, 또는 deep
  • 집중 영역

핵심 원칙

아키텍처 > 코드
이유 > 구문
설계 > API
트레이드오프 > 기능
원칙 > 구현

워크플로

  1. 적합성 확인; 튜토리얼/API/파일별 요청은 거절하거나 방향을 재조정합니다.
  2. 목표에 따라 깊이를 선택합니다. 기본값 standard; 빠른 첫 번째 패스를 위해 mini, 철저한 재현을 위해 deep을 사용합니다.
  3. 깊은 소스 코드 읽기 전에 문서, 테스트, 예제 및 저장소 구조를 스캔합니다.
  4. 아키텍처, 런타임, 상태, 데이터 모델, 확장 지점, 결정 사항 및 트레이드오프를 추출합니다.
  5. 재사용 가능한 규칙을 정제(distill)하고 선택된 모드와 재현 목표에 맞춰 결과물을 생성합니다.

실행 규칙

  • 기능 목록이 아닌 아키텍처로 시작하세요.
  • 튜토리얼, API 목록 또는 파일별 분석으로 빠지지 마세요.
  • 가능할 때마다 코드, 문서, 테스트, 예제 또는 커밋 기록의 증거에 주장을 근거하세요.
  • 관찰된 사실과 추론을 구분하세요; 증거가 부족할 때는 Observed, Strong inference, Tentative inference를 사용하세요.
  • 불완전한 저장소 접근 또는 약한 증거를 명시적으로 밝히세요.
  • 분석을 대상 언어, 도메인, 집중 영역 및 비교 기준에 맞게 조정하세요.

출력 모드

  • mini — 빠른 첫 번째 패스 아키텍처 요약
  • standard — 대부분의 연구에 적합한 전체 아키텍처 추출
  • deep — 프레임워크 재현을 위한 철저한 역공학

자세한 내용:

  • references/output-modes.md
  • references/analysis-checklist.md
  • references/deliverables.md

안티 패턴

피해야 할 사항:

  • README만 요약하기
  • 아키텍처 없이 API 나열하기
  • 설계를 추출하지 않고 예제 설명하기
  • 코드가 존재하는 이유를 묻지 않고 설명하기
  • 트레이드오프, 실패 경로 또는 확장 지점 무시하기
  • 원칙을 정제하지 않고 구현 복사하기
  • 증거가 부족할 때 철학이나 근거를 사실로 주장하기
  • 기능 체크리스트만으로 프레임워크 비교하기

관련 참고 자료

  • references/output-modes.md — 출력 형식, 템플릿, 다이어그램
  • references/analysis-checklist.md — 분석 체크리스트 및 품질 게이트
  • references/deliverables.md — 결과물 구조 및 AI 시뮬레이션 프롬프트
  • references/self-test.md — 허점 검토 및 적용된 수정 사항
  • references/simulated-dialogue-tests.md — 압박 프롬프트 및 성과표

관련 스킬