읽는 지식과 실행하는 capability
문서·skill·plugin·MCP를 선택하는 기준
매번 읽고 사람이 따라 하는 절차가 안정되면 실행 표면으로 옮길 수 있습니다. 다만 문서를 자동화한다고 모든 API를 tool로 노출해서는 안 됩니다. 읽기 문맥·반복 절차·외부 변경 권한을 서로 다른 계층으로 관리합니다.
| 표면 | 적합한 내용 | 필수 통제 |
|---|---|---|
| 문서 | 개념·결정·정책·예외 | 출처·owner·기준일 |
| Skill | 반복 workflow와 검증 | 명확한 trigger·입출력·script |
| Plugin | 팀 배포용 skill·hook·tool 묶음 | 버전·의존성·설치 정책 |
| MCP resource | 읽기 전용 외부 문맥 | scope·tenant 경계 |
| MCP tool | 외부 실행·변경 | strict schema·승인·audit |
- 반복성 확인같은 입력과 판정 기준으로 세 번 이상 반복되는지 봅니다.
- 권한 분류read·compute·write와 외부 부작용을 나눕니다.
- 표면 선택문서·skill·plugin·MCP 중 가장 낮은 권한을 고릅니다.
- 실패 계약거절·승인·rollback·감사 기록을 설계합니다.