프레임워크 추출 (Framework Distillation)
개요
코드가 아닌 아키텍처를 추출하세요.
이 스킬을 사용하여 프레임워크의 형태, 런타임 모델, 확장 지점, 엔지니어링 트레이드오프를 역공학으로 분석함으로써, 다른 AI나 팀이 다른 언어나 도메인에서 유사한 아키텍처를 재현할 수 있도록 합니다.
사용 시기
- README와 공개 API 이상의 프레임워크 아키텍처 역공학
- 런타임, 라이프사이클, 상태 머신 또는 확장 메커니즘 연구
- 다른 언어나 도메인에서 유사한 프레임워크 재현
- AI가 읽을 수 있는 아키텍처 지식 패키지 생성
- 아키텍처와 트레이드오프 관점에서 프레임워크 비교
일반적인 대상: 에이전트 런타임, 워크플로 엔진, 상태 머신 프레임워크, 플러그인 시스템, 오케스트레이션 플랫폼.
사용하지 말아야 할 경우
- README 요약만
- API 튜토리얼 또는 사용 가이드
- 라인별 코드 분석
- 복사-붙여넣기 재구현
- 트레이드오프 분석 없는 기능 목록
요청이 유사하지만 목표와 다를 경우, 먼저 범위를 재조정(re-redirect)하세요.
필수 입력 사항
최소:
- 저장소 URL 또는 로컬 소스 경로
권장:
- 프레임워크 이름
- 분석 목표
- 대상 구현 언어 또는 도메인
- 깊이:
mini,standard, 또는deep - 집중 영역
핵심 원칙
아키텍처 > 코드
이유 > 구문
설계 > API
트레이드오프 > 기능
원칙 > 구현
워크플로
- 적합성 확인; 튜토리얼/API/파일별 요청은 거절하거나 방향을 재조정합니다.
- 목표에 따라 깊이를 선택합니다. 기본값
standard; 빠른 첫 번째 패스를 위해mini, 철저한 재현을 위해deep을 사용합니다. - 깊은 소스 코드 읽기 전에 문서, 테스트, 예제 및 저장소 구조를 스캔합니다.
- 아키텍처, 런타임, 상태, 데이터 모델, 확장 지점, 결정 사항 및 트레이드오프를 추출합니다.
- 재사용 가능한 규칙을 정제(distill)하고 선택된 모드와 재현 목표에 맞춰 결과물을 생성합니다.
실행 규칙
- 기능 목록이 아닌 아키텍처로 시작하세요.
- 튜토리얼, API 목록 또는 파일별 분석으로 빠지지 마세요.
- 가능할 때마다 코드, 문서, 테스트, 예제 또는 커밋 기록의 증거에 주장을 근거하세요.
- 관찰된 사실과 추론을 구분하세요; 증거가 부족할 때는
Observed,Strong inference,Tentative inference를 사용하세요. - 불완전한 저장소 접근 또는 약한 증거를 명시적으로 밝히세요.
- 분석을 대상 언어, 도메인, 집중 영역 및 비교 기준에 맞게 조정하세요.
출력 모드
mini— 빠른 첫 번째 패스 아키텍처 요약standard— 대부분의 연구에 적합한 전체 아키텍처 추출deep— 프레임워크 재현을 위한 철저한 역공학
자세한 내용:
references/output-modes.mdreferences/analysis-checklist.mdreferences/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— 압박 프롬프트 및 성과표