Claude Skills by sudopark

Use when adding new source or test files to an existing framework in this project — 새 파일·새 Scene·새 테스트 추가 시점의 배치 경로 라우팅과 절차. Triggers on "파일 추가하자", "새 Scene 만들자", "새 Usecase/Repository 추가". Does NOT trigger on 신규 프레임워크(모듈) 신설(add-framework 스킬), 기존 파일 수정.

Use when creating a new framework (module) in this project — 신규 프레임워크 신설의 엔드투엔드 절차. Tuist 매니페스트·Workspace 등록부터 스킴 하드코딩 동기화, child CLAUDE.md·rules paths 확인까지. Triggers on "프레임워크 추가하자", "새 모듈 만들자", "Scene 프레임워크 신설". Does NOT trigger on 기존 프레임워크에 파일 추가(add-file 스킬).

Use when the user asks for a structured code analysis in this project — 로직 파악·실행 추적·객체 관계·영향도 분석을 code-analyzer subagent로 수행해 근거 있는 보고를 만든다. Triggers on "이 로직 분석해줘", "실행 흐름 추적해줘", "이거 고치면 어디까지 영향 가?". Does NOT trigger on 한두 파일 열어보면 끝나는 단순 질문(메인 세션이 직접 답), 킥오프 중 탐색(kickoff 스킬이 dispatch), PR 리뷰(review 스킬), 버그 원인 규명(superpowers systematic-debugging이 이끌고 필요 시 이 subagent를 부품으로 사용).

Use when producing full-screen snapshot images of app scenes for external communication — 디자인 목업·기능 설명 등 앱의 모양을 외부에 보여줄 화면 카탈로그 촬영·확장 절차. Triggers on "앱 화면 카탈로그 떠줘", "화면 스샷 모아줘", "이 화면 카탈로그에 추가해". Does NOT trigger on 구현 검증용 스냅샷(snapshot-check 스킬).

Use when planning or evaluating multi-PR work (L·XL) — kickoff 가 사이즈를 L 이상으로 판정해 위임했을 때, 유저의 "작전계획 세워"·"캠페인 잡자" 직접 호출, DP 종결보고 접수 시점(평가 모드). Triggers on 작전계획, 캠페인, 전역계획, L·XL 사이즈 위임, DP 종결보고 접수(PR 생성) 시 평가·다음 DP 선택. Does NOT trigger on 단일 PR 계획(opord), DP 실행(orchestrate·implement), 사이즈 판정 자체(kickoff), 이슈 분해 없는 즉흥 구현.

Use when composing a git commit in this project — 커밋 메시지 작성·커밋 구성 시점. 커밋 분할은 이미 결정돼 있다는 전제로 메시지 작성에 집중하고, 미정일 때만 분할 판단 지침을 제공한다. 미푸시 커밋 수정·리뷰 반영의 fixup 흡수 절차 포함. Triggers on "커밋하자", "커밋해줘", "커밋 정리해". Does NOT trigger on PR 본문 작성(pr 스킬), 이슈 작성(issue 스킬), docs/ 문서 작성.

Use when the user explicitly invokes convergence mode — 유저의 적극적 지시·질문·참여로 아이디어를 구체화하고 방향을 수렴하는 다턴 모드. 발산하는 brainstorming의 반대 — 열린 상태를 유저 주도로 좁혀 확정으로 간다. Claude는 지시·의도를 이해·정리하고 짧고 명확하게 답한다 (방향 선점·전제 깔기 금지). Triggers on "수렴", "수렴 모드", "/converge" — 명시 발동이 유일한 트리거이며 다른 스킬 진행 중에도 발동 가능. Does NOT trigger on 일반 질문(질문 하나가 왔다는 이유의 임의 진입 금지), 이슈 기반 착수(kickoff), 코드 작성 지시(implement·pair-programming).

Use when building or updating App Store custom product pages (맞춤형 제품 페이지 / CPP) — 페이지별 스크린샷 라인업·프로모션 문구를 로케일별로 만들어 App Store Connect 에 올리는 절차. Triggers on "맞춤형 제품 페이지 만들어", "CPP 올려", "커스텀 프로덕트 페이지 현지화". Does NOT trigger on 앱 내 이벤트(in-app-event 스킬)·기본 스토어 페이지 스샷 교체(deliver)·가이드 이미지(localization rules §1).

Use when doing UI design work in this project — 새 화면·컴포넌트 디자인, 스샷/레퍼런스 기반 UI 요청("이거처럼 만들어줘"), 디자인 방향이 열려 있는 UI 변경. 레퍼런스 유무와 무관하게 적용 — 디자인 스펙 확정까지의 절차(입력 분기, 레퍼런스 해석, 방향 옵션 제시, 목업 확인, 규모별 구현 연결)를 제공한다. Triggers on 스샷 첨부 UI 요청, "디자인하자", "화면 새로 만들자", "이런 느낌으로 바꿔줘". Does NOT trigger on 이미 확정된 디자인 스펙의 구현만 할 때(implement 영역), 비 UI 작업, 방향 판단이 필요 없는 단순 색·문구 교체.

Use when a decision has no rule or precedent to stand on — 구현·계획 중 "구체적으로 뭘 어떻게 해야 할지 모르겠고 선례도 못 찾겠는" 지점에서 실행 교리(rules) 신설·보강을 유저에게 요구하고, 받은 답을 룰로 정착시킨다. Triggers on implement Rules 갭 보고 루프가 보고하고 멈춘 시점, opord·campaign 의 추정 과업 도출에 근거 교리가 없을 때, "이거 룰로 박아두자" 류 유저 지시. Does NOT trigger on 조항이 있는데 못 찾은 경우(§2 확증이 걸러낸다), 재발하지 않는 일회성 판단, 스킬·하네스 md 정비(improve-skill), 원인·처방이 이미 선 상태에서 반영만 남은 경우(implement).

Use when the user requests an agent review of pushed harness changes — 하네스 변경분(.claude 스킬·agents·rules·hooks, CLAUDE.md 계층, 지시문 정본 docs)이 포함된 공개 PR(또는 PR 없이 푸시된 하네스 커밋)에 대해 harness-reviewer subagent를 관점별 병렬 dispatch하고 결과를 합산·검증해 인라인 코멘트로 게시한다 — 게시할 앵커가 없으면 대화 보고로 갈음. Triggers on "하네스 리뷰 돌려", "스킬 수정분 리뷰해줘" (PR 또는 푸시된 커밋이 있는 상태에서). Does NOT trigger on 프로덕트 코드 리뷰(review 스킬), 계획 문서 리뷰(plan-review 스킬), 스킬 신규 작성 중 검증(superpowers:writing-skills), usage-log 기반 정비(improve-skill), PR 올리기 전 셀프리뷰(수행하지 않음...

Use when writing or modifying code in this project — 구현 착수, 플랜 실행, 버그 수정, 리팩토링 등 코드 diff를 만들기 시작하는 모든 시점. 직접 수정이든 서브에이전트 dispatch 구현이든 무관 — 코드는 서브에이전트가 만지고 메인 세션은 브리프만 쓰는 경우에도 첫 dispatch 전에 invoke한다. 플랜 파일 유무와 무관하게 적용. superpowers 코딩 절차(test-driven-development·executing-plans·subagent-driven-development)를 대체하지 않는 컴패니언 — 프로젝트 종속 절차(변경 경로→테스트 스킴 계산, tuist generate 시점, 짝지어진 두 위치, rules·구조 패턴 확인, 리팩터 게이트, 완료 판정)를 주입한다. Triggers on "구현하자", "플랜 실행하자", "고치자", "리팩토링하자", "서브에이전트 시켜서 구현하자" 등 코드 수정이 시작될...

Use when running a maintenance cycle on a project skill or subagent — usage-log 레코드를 4분류로 진단해 스킬 md 개정안(diff)을 만들고 유저 승인 후 반영·소비 마킹한다. Triggers on "스킬 정비하자", "improve-skill 돌리자", "하네스 신호 기록해"(§5 누적 이슈 기록), pr 스킬 머지 단계의 임계 초과 제안을 유저가 수락했을 때. Does NOT trigger on 스킬 신규 작성(superpowers:writing-skills), 코드 리뷰 피드백 반영(feedback-reinforcement-learning), 유저가 지시한 일회성 스킬 문구 수정(직접 수정).

Use when filling in an App Store in-app event's localized copy and images — 절차·순서·게이트는 본문이 정한다. Triggers on "앱 내 이벤트 현지화하자", "인앱 이벤트 이미지 만들어줘", "인앱 이벤트 텍스트 올려줘". Does NOT trigger on 도메인 이벤트(Todo·Schedule) 편집, 버전별 변경내용(release-notes 스킬), 앱 설명·키워드 등 버전 무관 메타데이터(fastlane/metadata/README.md), 앱스토어 스크린샷(fastlane/screenshots.md), 앱 내 문구 번역(.claude/rules/localization.md), 이벤트 생성·일정·territory 설정(ASC 콘솔에서 유저가 한다).

Use when writing GitHub issues or issue comments in this project — 이슈 생성, 본문 갱신, 코멘트 작성 시점. 이슈는 할 일 정리와 히스토리 축적 용도 — 본문(확정 사실·결론·결정사항, 두괄식)과 코멘트(히스토리)의 역할 분리를 다룬다. Triggers on "이슈 따자", "이슈 만들어", "이슈에 정리해", "코멘트 남겨". Does NOT trigger on PR 본문 작성(pr 스킬), 커밋 메시지 작성(commit 스킬), 킥오프 절차 자체(kickoff 스킬).

Use when starting work on a GitHub issue — 이슈 번호/URL을 받아 정찰(이슈·히스토리·코드베이스 탐색)로 사실과 미정 결정 목록을 수집한 후, 사이즈(XL/L/M/S)를 판정해 M·S 는 작전명령·구두지시로, L·XL 은 campaign(작전계획)으로 연결한다. 미정 결정의 확정은 이 스킬이 아니라 계획 스킬(opord·campaign) 소관. Triggers on 이슈 번호·URL과 함께하는 모든 작업 착수 요청 — "이슈 N 시작하자/작업하자/진행하자/해보자/고치자", "킥오프", "#N 따서 시작". 이슈 언급 없이 코드 작업을 시작하려 할 때도 대응되는 이슈가 있는지 확인 후 이 스킬로 시작할 것. Does NOT trigger on 이슈 내용 조회·질문("이슈 N 뭐였지?", "N 요약해줘") — 작업 착수 의도가 있을 때만.

Use when writing an operation order (작전명령) for a single-PR issue or one DP in this project — kickoff A-3 전환, `/opord` 명시 호출, superpowers:writing-plans 를 invoke 하려는 그 자리(brainstorming 종점 포함) 전부. Triggers on "작전명령 세워", "계획 세워", "opord", writing-plans 발동 시점. Does NOT trigger on 캠페인·전략 작성(campaign), 실행(implement·orchestrate), 이슈 분해(kickoff).

Use when executing decomposed large work as multiple PRs from one session — 분해된 하위 작업들을 한 세션이 서브에이전트 dispatch로 실행하고, 하위 작업 단위로 개별 PR(병렬 또는 stacked)을 내보내는 실행 모드. Triggers on campaign 작전계획의 DP 들을 같은 세션에서 실행 지시("이어서 실행하자", "오케스트레이션 하자"), 작전명령 실행 중 규모 초과로 campaign 승격을 거친 뒤의 DP 실행, 유저의 병렬·stacked PR 작업 지시. Does NOT trigger on 단일 PR 규모의 플랜 실행(superpowers subagent-driven-development·executing-plans), DP 이슈를 별도 세션이 각자 킥오프하는 경로(kickoff 재진입), 계획·평가(campaign), 사이즈 판정(kickoff).

Use when the user explicitly declares pair programming mode in this project — 유저가 navigator(짧은 턴 피드백), Claude가 driver(코드 작성)로 붙는 세션 모드. 불확실성을 사전 반문으로 제거하는 대신 짧은 턴 교정 루프로 흡수한다. Triggers on "페어 프로그래밍 시작하자", "페어 모드 ㄱ", "페어로 하자" — 명시 선언이 유일한 트리거. Does NOT trigger on 이슈 기반 작업 착수(kickoff), 선언 없는 일반 구현 지시(implement — 지시가 짧다는 이유만으로 임의 진입 금지), 이전 세션에서 페어 모드였다는 이유의 자동 재진입(세션마다 재선언 필요).

Use when a planning document written by another session — strategy.md, campaign.md (작전계획) 초안·개정본, 또는 DP·M opord (작업 지침) 초안 — must be reviewed before the user's 재가. Triggers on "1차 리뷰 요청" from a peer session, "(다른 세션이 올린) 계획 리뷰해줘", "(저쪽 세션) 작전계획·작업 지침 봐줘". Does NOT trigger on PR 코드 리뷰(review 스킬), 하네스 파일 리뷰(harness-review 스킬), 계획을 직접 쓰거나 고치는 일(campaign·opord 스킬), 종결보고 접수·평가(campaign 평가 모드).

Use when creating or merging a pull request in this project — PR 본문 작성, 브랜치 구성, 머지·머지 후 정리 시점. 본문 서사(문제→접근), rebase 머지 원칙, 머지 후 브랜치 정리(워크트리 베이스 브랜치 복귀 포함), 머지 후 하네스 신호 보고를 다룬다. Triggers on "PR 올리자", "PR 만들어", "머지하자", "브랜치 정리해". Does NOT trigger on PR 코드 리뷰 수행(review 스킬 또는 유저 직접), 커밋 메시지 작성(commit 스킬), 이슈 작성(issue 스킬).

Use when writing the App Store "What's New" copy for a new app version — ko 원고 워싱과 en 원문 확정에 각각 걸린 두 승인 게이트, 29개 ASC 로케일 현지화 원칙, 업로드 전 검증과 fastlane 업로드를 다룬다. Triggers on "릴리즈 노트 쓰자", "이번 버전 변경내용 정리해줘", "새 버전 출시 문구 만들어줘". Does NOT trigger on 앱 내 이벤트 현지화(in-app-event 스킬), 버전과 무관한 메타데이터 수정(앱 설명·키워드·subtitle — fastlane/metadata/README.md 절차), 스크린샷 작업(fastlane/screenshots.md), 앱 내 문구 번역(.claude/rules/localization.md), 테스트 빌드 배포(test-deploy 스킬).

Use when running an agent code review in this project — code-reviewer subagent를 다관점 병렬 dispatch하고 결과를 합산·검증해 게시한다. 레인이 둘이다: 공개된 PR에 대한 유저 지시 리뷰(인라인 코멘트 게시), 그리고 implement §착수가 강제하는 PR 직전 최종 whole-branch 리뷰(pre-PR 레인 — 유저 지시 불요, 대화 보고로 게시 갈음). Triggers on "리뷰 돌려보자", "리뷰해줘" (PR이 올라간 상태에서), PR 직전 최종 whole-branch 리뷰 시점. Does NOT trigger on PR 공개 시점의 자동 실행(공개 PR 레인은 유저 지시가 유일한 트리거), 하네스 변경분 리뷰(harness-review 스킬), 계획 문서 리뷰(plan-review 스킬), 리뷰 반영 커밋 구성(commit 스킬), PR 본문 작성(pr 스킬).

Use when the user wants to run tests for the TodoCalendar project - runs all or specific test schemes via the project's test script

Use when verifying implemented UI against a design spec or reference in this project — 구현 단계 디자인 검증용 스냅샷 캡처·대조 절차와, 캡처 테스트가 존재하는 뷰 수정 시의 재검증 절차. Triggers on "스냅샷 떠서 확인해", "디자인 스펙이랑 대조해", design 스킬 §5 검증 단계, 캡처 테스트가 있는 뷰·컴포넌트를 구현 중 수정했을 때(재검증). Does NOT trigger on 캡처 테스트 선제 신설(유저 지시 시에만), 외부 설명용 화면 카탈로그(app-catalog 스킬), CI 회귀 게이트(미도입).

Use when the user wants a test build distributed to Firebase App Distribution — 개발 완료·핫픽스 검증 시점에 특정 브랜치를 테스터에게 내보내는 절차. 피처플래그를 켠 빌드도 배포 브랜치를 따서 내보낸다. Triggers on "테스트 배포 돌려", "이 브랜치 배포해서 확인해볼게", "<플래그명> 켜서 배포해줘". Does NOT trigger on TestFlight 업로드(testflight-deploy 스킬)·앱스토어 심사 제출, 테스트 실행(run-tests 스킬), PR 생성(pr 스킬), 코드 수정(implement 스킬) — 이 스킬의 FeatureFlag.swift 편집은 사전 규정된 리터럴 치환이라 별도 발동 대상이 아니다.

Use when the user wants a build uploaded to TestFlight — 핫픽스·릴리즈 후보를 App Store 서명으로 빌드해 ASC 에 올리는 절차. dSYM 을 Firebase Crashlytics 에 함께 올린다. Triggers on "테플 올려", "TestFlight 배포해줘", "이 브랜치 테플로 빌드해". Does NOT trigger on Firebase App Distribution 테스트 배포(test-deploy 스킬), 심사 제출·릴리즈 발행(#918 후속 단계), 버전업(수동), 테스트 실행(run-tests 스킬).

Use when fixing a bug or logical contradiction in this project — 버그 수정 착수, 개발·리뷰 중 논리 모순 발견, QA·CS 리포트 대응 등 결함의 원인 규명과 수정 방향 결정이 걸린 모든 시점. superpowers:systematic-debugging을 대체하지 않는 컴패니언 — root cause 규명 절차는 그 스킬이 이끌고, 이 스킬은 프로젝트 종속 절차(트러블슈팅 아카이브 조회·기록, 수정 방향 판정 게이트, 대규모 결함 escape hatch)를 주입한다. Triggers on "버그 고치자", "이거 왜 이래", 테스트 실패·재현 리포트 대응 — systematic-debugging invoke 시 함께. Does NOT trigger on 원인·수정 방향이 이미 확정돼 반영만 남은 경우(implement만), 기능 추가·리팩토링(결함 아님).