devoks-plugin-maintenancelisted
Install: claude install-skill ridsync/devoks-team-harness
# devoks-plugin-maintenance
`devoks-team-harness`의 플러그인 변경 작업에서 **절차 누락을 막는 로컬 maintainers용 워크플로우**다.
배포용 플러그인 번들에 포함되는 기능이 아니라, **이 저장소를 관리하는 사람**이 먼저 호출해야 하는 작업 절차다.
## 왜 이 스킬을 먼저 써야 하나
이 저장소는 플러그인 번들, README 카탈로그, MCP 가이드, core hook 문서가 서로 연결되어 있다.
플러그인 코드만 고치고 끝내면 아래가 자주 빠진다.
- `plugin.json` version bump
- `claude plugin validate --strict`
- README / `docs/README.ko.md` / `.claude-plugin/marketplace.json` 반영
- MCP prefix / `permissions.allow` / setup 가이드 정합성
- `devoks-core` rules/refs 와 루트 `.claude/` 사본 동기화 점검
이 스킬의 목적은 **변경 범위를 먼저 고정하고, 플러그인별 체크리스트를 분리한 뒤, 비대상 사유까지 남기게 하는 것**이다.
## 먼저 읽을 SSOT
상황에 맞게 아래 파일을 우선 읽어라.
- 구조·버전·검증 규칙: `docs/plugin-management.md`
- 카탈로그와 사용자-facing 구성: `README.md`, `docs/README.ko.md`
- MCP 설치/prefix 정책: `docs/mcp-setup-guide.md`, `plugins/devoks-core/commands/setup-mcp.md`
- 세션 시작 setup 상태 점검 규칙: `plugins/devoks-core/hooks/check-setup-state.sh`
- legacy sync 종료 맥락: `docs/fix-plan-sync-context-ssot.md`
- 카탈로그 drift 맥락: `docs/roadmap.md`
- 상세 체크표: `references/workflow-checklist.md`
## 실행 원칙
- 먼저 읽고 수정한다. 추측하지 않는다.
- 여러 플러그인이 바뀌면 **플러그인별 체크리스트를 분리**한다.
- 문서를 갱신하지 않을 경우, "왜 비대상인지"를 파일별로 남긴다.
- 기능 변경이 아니어도 `description`, 이름, dependency, MCP prefix, permission 정책이 바뀌면 카탈로그/문서 검토 대상으로 본다.
- `devoks-core`의 `rules/`, `refs/`, hook 변경은 루트 `.claude/` 사본과 운영 문서를 같이 본다.
## Step 1 — 변경 범위 선언
작업 시작 시 아래를 먼저 확정한다.
1. 변경 대상 플러그인
- 예: `devoks-browser`
- 예: `devoks-core`, `devoks-rn`
2. 변경 유형
- `runtime behavior only`
- `public workflow