프로젝트 프로필 템플릿 — `.claude/coui-upgrade.md`

앱마다 다른 값은 이 스킬이 아니라 앱 저장소의 .claude/coui-upgrade.md 에 둔다. 스킬은 이 파일을 먼저 읽는다. 저장소에서 확인한 값만 채우고, 모르면 미확인 으로 둔다.

`

# coui 업그레이드 프로필

> 공용 절차: cc-coui-upgrade 플러그인의 coui-app-upgrade 스킬. 이 파일은 이 저장소 고유 값만 담는다.

플랫폼#

• flutter | web(Jaspr, coui_web) | 혼합 — web·혼합이면 스킬의 references/web-apps.md 를 함께 따른다

핀#

• 파일: pubspec.yaml 의 dependency_overrides
• 방식: SHA | 패키지별 태그 이름
• 주 패키지: coui_flutter | coui_web (둘 다)
• 형제 패키지: coui_core + 주 패키지
• 멤버 패키지 선언: coui_flutter: any 등
• 주석 규약: = coui_flutter-vX.Y.Z 태그 커밋(coui_core 자체 버전 A.B.C)
• 검사: python3 <coui_pin.py> check --pubspec pubspec.yaml

환경#

• Flutter 고정: .fvmrc 등 (버전) — Flutter 앱
• 실행 방법: fvm flutter | 고정 바이너리 경로
• Dart SDK·jaspr: 선언·override·lock 위치, jaspr_cli 버전 — 웹 앱
• coui 저장소 인증: 로컬(gh/키체인), CI(토큰 주입 위치)

• (Flutter 앱. 웹 앱은 테마 radiusScaling 사용 여부만)
• 앱 배율: AdaptiveScaling(k) (설정 위치)
• 논리 폭: (반응형 스케일 박스 폭)
• 폰트: (family, 폰트를 둔 패키지 — 패키지 접두 필요 여부)
• 컴포넌트별 정책: 예) Card = 배율 수용(보정 안 함, 사용자 결정) / Button·IconButton·Tabs = px/k 보정, floor 0

• 보유 패키지: (목록)
• 찾기: test/golden 디렉토리
• 실행: 패키지마다 flutter test test/golden
• CI: 돌림 | 안 돌림(로컬 게이트가 유일)
• 승인 기록 위치: (문서 경로 또는 PR 본문)
• 웹: 테마 출력 스냅샷·SSR 스냅샷 테스트 위치, 브라우저 캡처 방법과 임계값
• 웹 CSS: 런타임 주입 | 빌드 시점 생성(재생성 명령, 신선도 테스트)

게이트#

• analyze: (명령과 범위)
• test: (명령과 범위)
• 웹 컴파일: 배포와 같은 jaspr build (웹 앱)
• 알려진 실패: (없음 | 목록과 이슈)

• 예) 아이콘 번들 재생성 명령과 가드 테스트
• 예) 핀 주석·이 프로필·관련 문서 갱신

• 예) 레포 전체 포매터·코드 생성·부트스트랩(이유)

• 예) 카드 세로 패딩은 형제 카드와 맞추려 space16(사용자 결정)`