cc-coui-upgrade
앱이 참조하는 coui 버전 올리기(Flutter 앱·Jaspr 웹 앱) — 형제 패키지를 한 커밋으로 고정하는 핀 계산·검사(coui_pin.py), 홉 계획, 시각 회귀 게이트(Flutter 골든·웹 스냅샷), 배율·최소 높이·기본값 함정, coui 업스트림 수정 루프
앱이 참조하는 coui 버전 올리기(Flutter 앱·Jaspr 웹 앱) — 형제 패키지를 한 커밋으로 고정하는 핀 계산·검사(coui_pin.py), 홉 계획, 시각 회귀 게이트(Flutter 골든·웹 스냅샷), 배율·최소 높이·기본값 함정, coui 업스트림 수정 루프
앱이 pubspec git 의존성으로 참조하는 coui(coui_core·coui_flutter·coui_web) 버전을 올리는 절차 플러그인. Flutter 앱과 Jaspr 웹 앱(coui_web)을 모두 다룬다. 형제 패키지를 한 커밋으로 고정하는 핀 계산부터 홉 계획, 골든 전수 게이트, 배율·최소 높이·기본값 함정, coui 를 직접 고쳐야 할 때의 업스트림 수정 루프까지 다룬다.
coui 저장소 안의 Figma↔코드 동기화는 cc-coui-sync, 제품 Figma 파일의 라이브러리 갱신은 cc-blueprint
의 coui-library-update 가 맡는다. 이 플러그인은 그 반대편 — 앱 저장소에서 coui 를 새 버전으로 바꾸는 일을 맡는다.
Skills#
| 이름 | 설명 |
|---|---|
| coui-app-upgrade | Flutter·Jaspr 앱에서 사용하는 CoUI 버전을 올릴 때 사용합니다. 관련 패키지 버전을 맞추고 단계별 갱신과 화면 비교로 호환성을 확인합니다. 제품 Figma 파일 갱신 |
| 골든 게이트 | coui 교체는 앱 코드를 한 줄도 안 바꿔도 화면을 바꾼다. 컴파일·단위 테스트로는 못 잡으므로 렌더를 이미지로 고정해 두는 골든이 유일한 안전망이다. 1~6절은 Flutter |
| 배율·최소 높이·기본값 |
coui Flutter resolver 는 테마의
scaling
(앱이
CoUIApp(scaling: AdaptiveScaling(k))
등으로 정한 값)을 스타일 값에 곱한
|
| 업스트림 수정 루프 — coui 를 고치고 앱 핀을 옮기기 | 앱에서 본 문제의 원인이 coui 에 있을 때의 흐름이다. 전달 원칙("coui PR 이 먼저 머지되고, 앱은 그다음 핀을 옮긴다")은 `coui-composition-and-ex |
| 웹 앱 — coui_web(Jaspr) | coui_web 을 쓰는 Jaspr 앱에 적용한다. coui_flutter 를 웹 타깃으로 빌드하는 앱은 Flutter 앱이다 — SKILL.md 절차와 [golden-ga |
프로젝트 프로필 템플릿 — .claude/coui-upgrade.md
|
앱마다 다른 값은 이 스킬이 아니라 앱 저장소의
.claude/coui-upgrade.md
에 둔다. 스킬은 이 파일을 먼저 읽는다. 저장소에서 확인한 값만 채우고, 모르면 `
|
| 핀 모델 — 태그·커밋·패키지 버전 | coui 는 한 저장소(pub workspace)에서 여러 패키지를 낸다. release-please 가 패키지마다 따로 버전을 올리고 태그를 붙인다. |
| 함정 카탈로그 | coui 를 오래된 버전에서 최신까지 올린 실제 이관에서 반복해 겪은 것들이다. 증상이 "화면이 조금 달라졌다"로만 드러나는 것이 많아서, 탐지 방법을 같이 적는다. 버전 번호가 |
관련 플러그인#
| 플러그인 | 설명 |
|---|---|
| cc-blueprint | 피그마 디자인·화면 개발 워크플로우 — CoUI Figma 라이브러리로 페이지 저작(/design), 프레젠테이션 온리 화면 개발 + 위젯북(/build), Figma↔Widget |
| cc-coui | CoUI 컴포넌트 라이브러리 (크로스플랫폼 컴포넌트 128종) + 조합/확장 가이드 |
| cc-coui-sync | CoUI 디자인 시스템의 Figma↔코드 동기화 — 캔버스 드리프트 감지(/absorb), 플러그인이 그리는 코드의 출처 측정(/status), 디자이너 결정의 코드 흡수 전 과정 |
| cc-jaspr-web | Jaspr Web 자동화 + Flutter Web 임베드 검증. CoUI Web 페이지를 점검하고, Web↔Flutter 듀얼 라이브 프리뷰를 구동하며, VM Service를 통해 |
설치#
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --plugin cc-coui-upgrade