mash-up-kr

TanStack Query 쿼리 정의·훅을 팀 컨벤션대로 스캐폴드한다. Use when connecting an API or creating useQuery/useMutation hooks (예:"API 연동해줘", "쿼리 훅 만들어줘", "서버 데이터 불러와줘"). 폼 상태는 /new-form, 로컬 UI 상태(useState)·익스텐션 코드에는 사용하지 않는다.

react-hook-form + zod 폼을 팀 컨벤션대로 스캐폴드한다. Use when creating a form or adding input validation (예:"폼 만들어줘", "입력 검증 추가해줘", "로그인 폼 구현", "검색 입력 구현"). 검색어 같은 단일 입력도 폼 상태(RHF)로 구성한다. 서버 상태 조회는 /new-query, 익스텐션 코드에는 사용하지 않는다.

이 프로젝트 고유의 Expo·NativeWind·RN 함정과 패키지 도입 기준 (자동 트리거). Use when writing/modifying app-web UI code, when a style works on web but not native (or vice versa), when adding a new package, or when upgrading expo/nativewind/react-native-css. 일반 Expo API 사용법은 expo 공식 플러그인 skill 을 쓴다. 익스텐션 코드에는 해당 없다.

NativeWind 기반 React Native 컴포넌트를 팀 컨벤션대로 스캐폴드한다. Use when creating a new UI component for the app/web. 익스텐션 UI 에는 사용하지 않는다.

expo-router 화면(라우트)을 팀 컨벤션대로 추가한다. Use when adding a new screen/route to the app/web. app/ 은 라우팅 껍데기로 두고 로직은 features 로 분리한다.

Creates a GitHub Pull Request by analyzing branch changes and filling in the project PR template. TRIGGER when: user invokes /pr directly, or says 'PR 만들어줘', 'PR 작성해줘'.

Analyzes staged/unstaged changes and performs atomic commits separated by concern. TRIGGER when: user invokes /commit directly, or says '커밋해줘', '커밋', 'commit'.

Use when encountering a bug, unexpected behavior, or error in the frontend - before attempting any fix

TCA(The Composable Architecture)로 Feature를 구축하거나 reducer 구조화, state 관리, effect·navigation 처리, TCA feature 테스트를 할 때 사용합니다. @Reducer, Store, Effect, TestStore, reducer 조합 패턴을 다룹니다.

iOS 17+ SwiftUI patterns를 구현할 때 사용합니다: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver), 비동기 작업(.task/.refreshable), 또는 ObservableObject/@StateObject에서 마이그레이션하는 경우.

구현한 화면의 스크린샷·UI hierarchy를 Zeplin 시안 스펙과 항목별로 대조해 PASS/DIFF를 보고합니다.

SwiftUI 코드를 리뷰·정리하거나 soft-deprecated API를 점검할 때 사용합니다. view 구조 분리, dataflow/environment 검토, ForEach identity, localization, deprecation 마이그레이션을 다룹니다. (신규 구현 패턴은 swiftui-patterns 스킬 사용)

device 또는 simulator에서 스크린샷, UI hierarchy, 터치 interaction을 통해 iOS 앱 동작을 확인합니다.

async/await 코드를 작성하거나, strict concurrency를 활성화하거나, Sendable 오류를 수정하거나, completion handler로부터 마이그레이션하거나, actor로 공유 상태를 관리하거나, 동시성을 위해 Task/TaskGroup을 사용할 때 사용합니다.

NavigationStack 문제(응답 없음, 예기치 않은 pop, 크래시), build 실패(SPM resolution, "No such module", build가 멈추는 경우), 또는 메모리 문제(retain cycle, leak, deinit이 호출되지 않는 경우)를 디버깅할 때 사용합니다. iOS/macOS를 위한 체계적인 진단 워크플로우입니다.

Swift Testing(@Test,

Analyzes staged/unstaged changes and performs atomic commits separated by concern. TRIGGER when: user invokes /commit directly, or says '커밋해줘', '커밋', 'commit'.

무인 모드 — 계획부터 구현·검증까지 진행하고, 검증 통과 시에만 커밋·push·PR까지 사람 개입 없이 끝낸다. TRIGGER when: user invokes /gone-gaming directly. 자동 감지되지 않는다 — 항상 명시 호출만.

Creates a GitHub Pull Request by analyzing branch changes and filling in the project PR template. TRIGGER when: user invokes /pr directly, or says 'PR 만들어줘', 'PR 작성해줘'.

현재 diff 또는 프로젝트 전체 코드가 udumeoli-web 전용 룰(FSD 경계, good-* 기준, simplicity 사다리)에 맞는지 검토한다. TRIGGER when: user invokes /convention-review directly, or asks for a "컨벤션 리뷰"/"룰 위반" check on the current diff or on the whole codebase.

Figma 시안을 design-implementer 에이전트에 위임해 udumeoli-web 코드로 구현한다. TRIGGER when: user invokes /design-implement directly, or gives a figma.com URL with a request to implement it.

Use when writing or modifying mobile UI layout - screen height/width variance, fixed positioning, spacing between elements - before finalizing layout

Use for complex udumeoli-web changes that benefit from an explicit plan, human approval, scoped implementation, and final review across the TanStack Start frontend.

Mino-Android SDD plan.md 생성. 컨펌된 spec.md를 안드로이드 MVI 설계(plan.md)로 번역한다. Mino-Android 레포 체크아웃 안에서 docs·모듈 구조를 직접 읽어 작성하고, plan-reviewer 서브에이전트로 자가검수까지 수행한다. 컨펌된 spec 본문이 주어졌을 때 사용.

Mino-Android SDD spec.md 생성. Figma 화면 + 기획서로부터 "무엇을 만들까"(화면 동작 정의) 기준 문서 spec.md와 화면 PNG(assets/)를 만들고, spec-reviewer 서브에이전트로 Figma·기획서 대조 자가검수까지 수행한다. Figma URL과 기획서가 주어졌을 때 사용.

대화 중 되돌리기 어려운 설계·아키텍처 결정이 확정되는 순간 자동으로 docs/adr/에 ADR을 기록한다. 라이브러리·프레임워크 채택/교체, 모듈 경계·레이어 구조 변경, 의도적으로 하지 않기로 한 것 등 "이걸로 하자"라고 결론이 나는 대화에서 사용. 사용자가 ADR을 써달라고 명시적으로 요청하지 않아도, 결정이 확정되는 시점에 먼저 제안한다.

머지된 코드가 이후에 잘못된 설계·구현으로 판명되어 되돌리거나 다시 고칠 때 자동으로 docs/failures/에 실패 기록을 남긴다. 버그 수정·롤백 대화에서, 지금 고치는 코드가 과거의 의도적인 결정(특히 기존 ADR)을 뒤집는 것인지 git 히스토리로 확인하고 사용. 결정과 실패 판명이 서로 다른 세션에서 벌어지는 경우가 대부분이므로, 대화 기억이 아니라 git 로그·docs/adr를 근거로 판단한다.

Use when adding, changing, or reviewing HTTP API controllers, request and response DTOs, ApiResponse payloads, JSON field names, or response nesting in this repository

Use when adding, moving, or renaming code in this repository, or deciding which module and package something belongs in

Use when writing a commit message or naming a branch in this repository

Use when opening a pull request or writing a PR description in this repository

Mino iOS 작업의 단일 진입점. 진행 상황을 읽어 지금 차례인 ios-workflow 세션으로 들어간다. "mino", "이어서 하자", "다음 단계", 기획서·피그마를 던지며 작업을 시작할 때 사용한다. `auto` 를 붙이면 승인 게이트에서 묻지 않고 끝까지 진행한다.

SwiftUI 피쳐가 끝났을 때 접근성 부여 → 테스트 작성 → 빌드 → 시뮬레이터 실행 → 판정을 순서대로 돌리는 QA 파이프라인. "QA 돌려줘", "피쳐 끝났어 검증해줘", "mino-qa" 요청 시 사용. 별도 UI 테스트 타깃 없이 AXe로 화면을 직접 구동한다.

팀 커밋 컨벤션(Conventional Commits, 한글 제목, 레이어 scope)에 맞춰 변경사항을 작업 단위로 분리해 커밋한다. 사용자가 "커밋", "commit", "커밋해줘"라고 하거나 변경을 저장소에 기록하려 할 때 사용한다.

회의 대본이나 Confluence 회의록을 교정된 회의록과 ttalkkak.atlassian.net용 Jira 액션 티켓(DDK/OPS)으로 변환합니다. 회의록 작성/게시, 액션 아이템의 Jira 티켓 분리, 팀원 이름→Atlassian 계정 매핑, 중복 탐지, watcher 멘션을 요청할 때 사용하세요. (적용 범위와 제외 케이스는 아래 본문 참고.)

딸깍팀(Mash-Up 16기) Jira 이슈 생성 워크플로우. OPS(운영·기획·의사결정) 또는 DDK(개발) 프로젝트에 이슈 작성 시 사용. "딸깍 이슈 만들어줘", "OPS Decision 등록", "DDK Task 만들어줘", "ttalkkak Jira 이슈 생성" 같은 요청에 트리거. 타입별 템플릿(Epic/Story/Task/Subtask/Bug/Decision/Idea), Decision Level 필수 처리, 팀원 매핑, Jira vs Confluence 정보 배분 가이드 포함.

딸깍 웹(ttalkkak-web, 프론트엔드) 레포 전용. git 브랜치를 새로 만드는 모든 요청에 사용한다 — "브랜치 파줘/만들어줘/따줘/세팅해줘", "develop에서 새 브랜치", "이 작업 이제 시작할게"가 여기 해당한다. 지라(TMT) 티켓·티켓 번호(TMT-75·#75), 기능/컴포넌트 이름(chip·radio 등), "진행 중인 내 티켓", "방금 만든 티켓" 중 무엇과 엮이든, 심지어 아무것도 지정하지 않아도 브랜치 생성 의도만 있으면 트리거한다. 이 스킬은 티켓을 특정해(없으면 티켓부터 생성) 규약대로 브랜치를 만들고, 티켓을 진행 중으로 옮기고, 브랜치를 티켓에 연결·기록하는 전체 흐름을 한 번에 처리한다. "브랜치"와 "티켓"이 한 요청에 같이 나오면 거의 항상 이 스킬이다. 트리거하지 않음: 이미 있는 브랜치로 체크아웃/이동, 커밋, PR 생성, 그리고 브랜치 없이 티켓만 조회·수정·생성하는 요청.

현재 브랜치의 변경사항을 분석해 레포 PR 템플릿에 맞춘 한국어 PR 본문을 "바로 복붙 가능한" 형태로 작성한다. 사용자가 "PR 작성", "PR 본문", "PR 템플릿에 맞게", "PR 문서" 등을 요청할 때 사용.