# 개발·디자인·문서 환경

AAPB가 에이전트 앱의 모든 플러그인을 관리하지는 않습니다. 설치 도구는 소유권 표식이 있는 AAPB 스킬 디렉터리만 다룹니다. 플러그인 캐시, 계정 연결, 다른 프로젝트의 프로필은 별도로 확인해야 합니다.

## 선택 기준

| 기능 | 기본 처리 | 확인할 가치와 비용 |
| --- | --- | --- |
| AAPB project-memory·spec-artifacts | 코어 | 일반 파일로 옮겨 쓸 수 있는 현재 상태와 요청한 산출물 형식. 문서 묶음을 필수 생성하지 않습니다. |
| AAPB 디자인 방향·UI 다듬기 | 개발 | 제품·브랜드 제약, 정보 밀도와 렌더링 근거. 실제 판단에 필요할 때만 참조합니다. |
| AAPB 일반 문서 편집 | 개발 | 사실·문체·의도적 강조·예시. 검사는 선택적 참고 도구입니다. |
| AAPB 레거시 계약 | 명시적 선택 | 기술 환경별 보존 계약. 해당 기술 참조만 읽습니다. |
| 코드 정리 | 선택 참조 | 공개 동작과 불필요한 추상화. 별도의 필수 작업 순서를 추가하지 않습니다. |
| 웹 프런트엔드·React·shadcn | 웹 작업에 유지 | 프레임워크·컴포넌트 계약과 브라우저 검증. 일반 코딩 조언만으로 반복 읽기를 정당화하지 않습니다. |
| Stripe·Supabase | 해당 연동에서만 사용 | 결제·데이터 계약. 정적 페이지의 선행 조건이 아닙니다. |
| Figma | 연결과 해당 스킬 유지 | 디자인 문서·Code Connect·다이어그램·모션·내보내기 형식. 실제 연결 도구는 별도로 확인합니다. |
| Product design | 해당 진입점 유지 | 제품 맥락·시각 생성·렌더링 검토. 내부 보조 항목을 시작 지침으로 모두 노출할 필요는 없습니다. |
| Word·문서 | 유지 | 파일 생성·변경 추적·렌더링. 전달할 문서의 레이아웃 확인에 렌더링 비용을 사용합니다. |
| 스프레드시트·실시간 Excel | 유지 | 수식·파일 형식·실제 앱 조작. 파일 생성과 Excel 연결 상태를 구분합니다. |
| 프레젠테이션 | 유지 | 편집 가능한 슬라이드와 렌더링. 일반 Markdown 메모에는 호출하지 않습니다. |
| PDF | 해당 구현 하나 유지 | 추출·생성·레이아웃 확인. 중복된 독립 진입점은 파일을 보존하며 비활성화합니다. |
| Template creator | 유지 | 문서 템플릿 생성·조정. 개별 도메인 템플릿은 선택할 수 있게 남깁니다. |
| 분야별 템플릿 모음 | 선택 | 재무·법률·분석·프로젝트 형식은 요청 시 유용하지만 모든 작업에 전부 노출하지 않습니다. |
| 브라우저·컴퓨터 조작·Sites·시각화 | 호스트 기능 보존 | 실행·미리보기·호스팅 기능입니다. 설정이 존재한다고 전체 동작을 검증한 것은 아닙니다. |
| 플러그인 관리 | 기능 보존 | 의존성과 권한 메타데이터. 선택 의존성을 자동 설치하지 않습니다. |
| GitHub·Linear 연결 | 독립적으로 보존 | 개발 협업 도구입니다. 다른 플러그인의 의존성 선언이 소유권을 이전하지 않습니다. |
| Expo | 선택 | 모바일 라우팅·네이티브 모듈·빌드 계약. 일반 웹 개발의 의존성이 아닙니다. |
| Android 테스트 | 선택 | 에뮬레이터·성능 실행. 준비한 시험 입력의 통과가 실제 기기 동작의 증거는 아닙니다. |
| iOS·macOS 빌더 | 선택 | 플랫폼별 빌드·UI 기능. 구형 캐시와 현재 가용 상태를 구분합니다. |
| Data analytics | 선택 | 지표·맥락 분석과 전문 출력 위젯. 공유 문서 도구의 접근은 별도로 보존합니다. |
| Creative production | 선택 | 창작 제작의 입력 정리와 실행. 일반 디자인은 기존 디자인 도구를 사용할 수 있습니다. |
| Deep research | 선택 | 여러 출처 조사 흐름. 일반 내장 검색은 계속 사용할 수 있습니다. |
| OpenAI 개발 연동 모음 | 선택 | API·앱별 지침과 확인 도구. 호스트 문서 조회 기능과 구분합니다. |
| Vercel | 선택 | 플랫폼 서비스·배포. 모든 로컬 편집에 읽지 않고 배포 과제에 보존합니다. |
| Obsidian·canvas·추출 헬퍼 | 프로젝트 한정·선택 | 보관함 형식과 추출. 미관리 파일은 건드리지 않습니다. |
| 스킬 탐색·장식용 스킬 | 선택 | 설치 탐색이나 개발 외 사용. 기본 과제의 선행 조건이 아닙니다. |
| Superpowers | 비활성 | 일반 필수 워크플로가 호스트·프로젝트 지침과 겹칩니다. 명시적인 복원 경로를 남깁니다. |
| Writer 제품 스킬·MCP | 제품 전용 프로필 | 승인된 문체(accepted), 수정 후보(candidate) 승인, 스냅샷, 작업 이력은 제품에서 지켜야 할 계약입니다. |
| Game 제품 스킬·MCP | 제품 전용 프로필 | 엔진 실행 권한과 근거는 일반 스킬 설치와 다릅니다. |
| AAPB MCP | 기본 비활성 | 서버 시작 폴더에 연결되는 읽기 전용 기록 도구 네 개. Codex에서는 공통 등록 하나로 각 작업의 폴더를 사용합니다. |
| 다른 프로젝트 MCP | 프로젝트 한정 | 무관한 이전에서 해당 프로젝트 설정을 편집하지 않고 공통 활성 상태를 해제합니다. |

개인 감사에는 각 항목·버전의 소유자, 설정 상태, 실제 발견·주입 여부, 고유 기능, 바이트와 실행 요구, 판정, 보존 위치와 복구 방법을 기록합니다. 플랫폼 제공 항목과 캐시만 있는 항목도 구분합니다. 텍스트 크기는 지침량의 대략적인 지표이며 토큰 가격이나 모델 성능 저하의 증거가 아닙니다. [검증](verification.ko.md)의 다섯 사례는 모든 외부 스킬을 측정한 결과가 아닙니다.

## 원격 플러그인과 로딩

확인한 [호스트의 버전별 로더](https://github.com/openai/codex/blob/rust-v0.153.4/codex-rs/core-plugins/src/loader.rs)는 원격 계정의 활성 상태를 로컬 플러그인의 enabled 설정보다 우선 적용하고, 서버별 추가 설정은 보존합니다. 따라서 로컬 enabled=false만 편집해도 설치된 원격 플러그인이 비활성화되지 않을 수 있습니다.

계정 설치와 복구용 캐시를 보존하려면 지원되는 스킬 경로·이름별 선택 설정과 플러그인별 MCP의 enabled=false 설정으로 공통 노출을 제한합니다. 원격 플러그인을 로딩한 뒤 설치 상태와 스킬 목록을 다시 읽고, 새 턴의 실제로 대화에 들어간 목록과 MCP 런타임 상태를 확인합니다. 다음 항목을 구분합니다.

- 원격 계정의 설치·활성 상태
- 로컬 스킬·도구 노출
- 캐시 파일과 버전
- 발견 목록, 자동으로 대화에 들어간 지침과 실제 도구 호출

경로 선택자는 확인한 설치 버전에, 이름 선택자는 유지되는 진입점 이름에 적용됩니다. 플러그인이 새 이름이나 서버를 추가하면 다시 감사해야 합니다. 선택 플러그인이 의존성으로 선언했다고 공유 커넥터까지 비활성화하지 않습니다. 해당 권한과 복구 계획 없이 원격 플러그인 제거를 로컬 노출 제한의 대체 수단으로 사용하지 않습니다.

## 복구

적용 전 백업에서 바꾼 플러그인·스킬·MCP 설정만 복원합니다. 이전 뒤 현재 설정이 달라졌다면 관련 항목을 병합하고 새 모델·예산·데스크톱·프로젝트 설정을 보존합니다. 개인 설정을 이 저장소에 넣지 않습니다.

스킬 설치 작업과 플러그인 설정은 별개입니다. 스킬은 최신 작업부터 역순으로 복구하며, 각 복구를 미리 본 뒤 --apply로 적용합니다. 이전 CLI 패키지도 보관합니다. 소스 태그와 설치된 실행 파일의 버전은 다를 수 있습니다. 기존 원격 기록·예약과 제품 프로필은 그대로 유지합니다.