
작업 완료 전 품질 증거를 수집하는 게이트. test, lint, build, Contract Gate, TEST_ID 커버리지와 잔여 리스크(TODO, any 타입, console.log)를 검증하여 통과/실패 판정한다. 팀 스킬 완료 시 자동 호출되거나 수동으로 실행 가능.
E2E 단위 시나리오를 조합한 통합 테스트 시나리오를 md로 생성·관리·실행하는 스킬. "통합 시나리오", "e2e suite", "통합 테스트", "시나리오 조합", "e2e 통합", "전체 흐름 테스트" 키워드로 트리거.
피치 스킬 사용 중 발견된 문제점/노하우를 구조화하여 docs/스킬피드백/에 문서화하는 범용 스킬. "스킬 개선", "피드백 정리", "문제점 기록", "스킬 리뷰", "개선사항", "스킬 피드백" 키워드로 트리거. 모든 피치 스킬에 범용 적용 가능. 다른 AI 에이전트가 문서를 읽고 스킬을 개선할 수 있도록 구성.
Karpathy LLM Wiki 패턴 기반 지식 관리 스킬. 코드 프로젝트와 옵시디언 노트 모두 지원. Raw Source(코드·문서)를 읽어 docs/wiki/에 누적형 지식베이스를 구축·유지한다. "wiki", "위키", "ingest", "인제스트", "wiki 점검", "wiki lint", "wiki 업데이트", "문서화해줘", "아키텍처 설명해줘", "어떻게 동작해?" 키워드로 트리거. qmd 검색 도구와 연동하여 토큰 절약 + 높은 검색 정확도 제공.
프로젝트에 E2E 테스트 환경을 설정합니다. 글로벌 도구 설치 체크, Chrome Beta 확인, e2e/ 인프라 코드 배포. Use when: "e2e 세팅", "e2e setup", "E2E 환경 설정", "E2E 초기 설정" 키워드.
외부 REST API 호출 코드를 생성하는 스킬. axios 기반 TypeScript Service + Type + Test. "외부 API 연동", "결제 API 호출", "문자 발송 API" 키워드로 트리거.
주기적 실행 Cron 작업 코드를 생성하는 스킬. node-cron 기반 TypeScript Service + 로그 기록 + server.ts 통합. "크론 작업", "주기적 실행", "스케줄러 생성" 키워드로 트리거.
dbmate 마이그레이션 전체 관리 스킬. 상태 확인, 실행(up), 롤백(down), 새 마이그레이션 생성을 처리. "마이그레이션 실행", "DB 업", "DB 다운", "마이그레이션 상태", "마이그레이션 생성", "dbmate", "migration", "테이블 변경 적용", "스키마 반영", "DB 롤백" 키워드로 트리거. DB 마이그레이션과 관련된 어떤 요청이든 이 스킬을 사용하라.
하네스 시스템 안내 전문가. "어떤 스킬", "어떻게", "도움말", "help", "가이드", "어디서 시작" 키워드로 트리거. 스킬 추천, 워크플로우 안내, 시스템 개념 설명을 제공하는 읽기전용 온보딩 스킬. (skills.sh 글로벌 설치 안내 포함)
PDF/PPTX/DOCX/XLSX/HTML/CSV/JSON/XML/ZIP/EPUB/이미지 같은 문서파일을 md로 변환할 때 사용한다. "문서 md 변환", "pdf를 markdown", "pptx를 markdown", "docx를 markdown", "문서 추출", "백업솔루션 md 변환" 요청에서 사용한다. markitdown 설치 확인, HWPX 추출 환경 설치, 단일 파일 또는 폴더 변환, 오류 로그 생성을 함께 처리한다.
Spec 필수 + ui-proto 보조 기준으로 E2E 환경 세팅 + 단위 시나리오 자동 분할 + 통합 suite 생성 + 실행 + 부합 검증을 한 번에 처리하는 통합 팀 스킬. "e2e 검증해줘", "통합 검증", "전체 흐름 테스트", "팀 e2e", "스펙대로 동작하는지 확인", "ui-proto와 다른지 확인", "최종 검증", "릴리스 전 검증" 키워드로 트리거. peach-e2e-setup + peach-e2e-scenario + peach-e2e-suite 3개 스킬의 패턴을 공유하고, 검증 기준은 본 프로젝트 Spec을 필수 기준으로 삼고, ui-proto는 화면/흐름 보조 기준으로 사용한다. peach-team-dev와 함께 하나의 개발-검증 납품 흐름을 이루되, 구현 컨텍스트와 검증 컨텍스트는 분리한다. 팀 실행 방식은 E2E 범위와 런타임 도구 가용성을 분석해 single-agent / role-queue / agent-team 중 선택한다. 단순 코드 동작 검증을 넘어, 기획 의도와 부합하는지 자동 검증하는 게 핵심 차별점.
웹페이지, Vue 화면, ui-proto 태스크 폴더, 스크린샷을 UX 법칙 기준으로 검토하는 읽기전용 UX 리뷰 스킬. "UX 검증", "UX 리뷰", "사용성 점검", "화면 UX 봐줘", "프로토타입 UX 점검", "Laws of UX 기준으로 봐줘", "피치 UX 체크" 키워드로 트리거. Laws of UX와 GeekNews 요약을 피치 백오피스 화면 검증 관점으로 재구성하여 문제, 근거, 우선순위, 수정 제안을 보고한다.
DB DDL/마이그레이션 생성 전문가. "테이블 만들어줘", "DB 스키마 생성", "마이그레이션 생성" 키워드로 트리거. 확정 Spec 또는 명확한 테이블 구조를 기준으로 dbmate 마이그레이션 파일을 생성.
신규 프로젝트 모듈 구조 + _common 기본 구성 세팅 스킬. "프로젝트 세팅", "모듈 구조 잡아줘", "초기 구성", "프로젝트 초기화" 키워드로 트리거. DB 설계 완료 후, 최초 1회 실행.
DB 스키마 추출 스킬. DB의 현재 상태를 테이블별 DDL 파일로 추출하여 schema/ 폴더에 저장. "스키마 추출", "스키마 업데이트", "extract-schema", "DB 스키마 동기화", "스키마 파일 갱신", "DB 구조 확인", "DDL 추출", "스키마 최신화" 키워드로 트리거. 스키마 파일과 실제 DB 상태가 다를 수 있다고 판단되면 이 스킬을 사용하라.
Mermaid ERD 전체 워크플로우 스킬. MCP 설치 → mmd 생성 → 브라우저 미리보기 → PNG/SVG 저장까지 원스톱 처리. "ERD 업데이트", "ERD 미리보기", "ERD 저장", "ERD 그려줘", "테이블 추가", "관계 변경", "DB 설계 시각화", "ERD에 컬럼 추가", "erd.mmd 수정" 키워드로 트리거. DB 스키마나 테이블 구조를 시각화하려는 의도가 보이면 이 스킬을 사용하라.
기존 기능의 암묵지를 명세서로 변환하여 as-is Context Pack(주제별 문서 폴더)을 생성하는 스킬. "기능 문서화", "기존 기능 분석", "as-is 정리", "docs/기능별설명 생성" 키워드로 트리거. 신규 기능 Spec이 필요하면 peach-gen-spec을 사용한다.
개발 DB에 SQL을 직접 실행하여 데이터를 조회하는 스킬. "DB 확인", "데이터 조회", "테이블 조회", "SQL 실행", "데이터 검증" 키워드로 트리거. AI 에이전트가 백엔드/프론트엔드 개발 중 개발 DB 데이터를 즉시 확인할 때 사용.
인쇄 전용 페이지 생성 전문가. "인쇄 페이지 만들어줘", "프린트 페이지 생성", "출력 페이지" 키워드로 트리거. 레이아웃 없이 컨텐츠만 출력하는 세련된 인쇄 전용 Vue 컴포넌트와 라우트 설정 생성. Context7 MCP로 최신 TailwindCSS v4/Vue 문서 참조, Sequential Thinking으로 인쇄 디자인 분석.
디자인 시스템 컨설팅 + Vue 3 컴포넌트 코드 생성 스킬. "디자인 상담", "UI 트렌드", "색상 추천", "디자인 시스템" 키워드로 트리거. 도메인 파악 → 제안 → 피드백 → 코드 생성 순으로 진행. ※ 이 스킬은 일반적 디자인 컨설팅 참고용. 프로젝트별 디자인 시스템 본체는 각 ui-proto 프로젝트 내부에 두는 것이 표준이다 (2026-04-27 결정).
peach-team-ui-proto의 이전 이름 호환용 alias. 기존 `/peach-gen-ui-proto` 호출을 임시 호환한다. "프로토타입 만들어줘", "Mock 화면", "proto UI", "ui-proto 작업", "기획자 검토용 화면" 요청은 공식 스킬 peach-team-ui-proto를 사용한다.
PeachSolution 개발 요청이나 PRD를 구현 전에 접수·분류하여 필요한 다음 스킬 경로를 판정하는 게이트 스킬. "어떤 스킬로 시작할까", "요청 분석", "PRD 분석", "개발 경로 판단", "Spec/DB/proto 필요 여부 판단", "작업 규모 판단", "intake" 키워드로 트리거. 코드 구현, 마이그레이션 생성, ui-proto 생성, E2E 실행은 하지 않고 peach-gen-spec, peach-gen-db, peach-team-ui-proto, peach-team-dev, peach-team-e2e 중 어떤 흐름을 탈지 결정한다.
워크플로우, 시스템 구조, 아키텍처, 세션 흐름, 에이전트 협업, 문서 구조를 다이어그램으로 생성하는 스킬. "다이어그램 그려줘", "흐름도 만들어줘", "구조도", "아키텍처 다이어그램", "워크플로우 시각화", "Unicode box-drawing", "터미널풍 다이어그램", "Mermaid로 그려줘", "이미지처럼 다이어그램" 키워드로 트리거. DB 테이블 관계/ERD가 목적이면 peach-erd를 우선 사용하고, 이 스킬은 ERD 외 범용 다이어그램에 사용한다.
Frontend Store 전문 생성 스킬. "스토어 만들어줘", "Store 생성", "프론트 상태관리" 키워드로 트리거. Backend API 기반 생성, TDD 검증 필수.
기능 브랜치용 git worktree 라이프사이클을 관리하는 스킬. 생성(create) / 상태 진단(status) / PR 준비(finish) / 병합 후 정리(closeout) / 정리(cleanup) 모드를 자동 판단한다. "워크트리 만들어줘", "worktree 생성", "워크트리 정리", "워크트리 삭제", "기능 브랜치 워크트리", "워크트리 상태", "마무리", "PR 생성", "PR 머지 후 정리", "feature worktree" 키워드로 트리거. PR 전 base 비교와 안전한 동기화 필요 여부를 진단한다. 개발 완료 후 finish/closeout 모드에서는 한 번의 통합 체크포인트로 push/PR/merge/cleanup을 안전하게 진행한다.
PeachSolution 신규 모듈 개발을 조율하는 통합 팀 스킬. 준비된 DB 스키마와 Spec, ui-proto 기반 표준 모드 + Spec만 모드 + 자연어 prompt 모드를 지원. "팀으로 만들어줘", "풀스택 개발", "팀 개발", "백엔드+UI 전체 생성", "버그 수정해줘", "이 화면에 X 추가해줘", "API와 화면 같이 만들어줘", "백엔드만 만들어줘", "API만 만들어줘", "UI만 추가" 키워드로 트리거. mode=backend(API+Store) | ui(UI만) | fullstack(전체) 지원하며, mode/proto 없이 자연어 입력만으로도 즉흥적 버그 수정·기능 추가 가능. 대규모 작업은 기능 큐와 Contract Gate로 1차 완성도를 높이는 방향을 따른다. peach-team-e2e와 함께 하나의 개발-검증 납품 흐름을 이루되, E2E 검증 독립성은 유지한다. 팀 실행 방식은 요청 범위와 런타임 도구 가용성을 분석해 single-agent / role-queue / agent-team 중 선택한다. 기존 팀 개발 스킬의 개발 조율 역할을 대체하며, DB 생성은 peach-gen-db 선행 단계로 분리한다.
E2E 시나리오 생성, 실행, 자동수정을 통합 처리하는 스킬. "시나리오 만들어줘", "시나리오 실행", "e2e 실행", "E2E 돌려", "시나리오 돌려", "시나리오 변환", "녹화 변환", "e2e 변환", "codegen 변환", "e2e 생성", "시나리오 생성", "시나리오 검증" 키워드로 트리거.
어떤 주제/과제든 받아서 스스로 팀을 구성하고 조사·분석·검토·결과도출까지 처리하는 범용 에이전트 팀 오케스트레이터. "팀으로 분석해줘", "에이전트 팀으로 조사해줘", "다각도로 검토해줘", "심층 분석 부탁해", "여러 관점으로 봐줘", "think-team", "think team" 키워드로 트리거. 단순 질문이 아닌 복합적 판단, 조사, 전략 결정이 필요한 모든 상황에서 사용.
peach-harness 버전 업데이트 → CHANGELOG.md 자동 생성 → develop 커밋/푸시 → main PR 생성 → PR 머지 → GitHub Release 생성까지 일괄 처리하는 릴리스 스킬. 변경 내용 분석 → CHANGELOG 초안 + 실행 계획을 한 번에 제시 → 대화로 보완 → 승인 1회 후 일괄 실행. "릴리스", "버전 업", "release", "main 머지", "배포 준비" 키워드로 트리거. peach-harness 저장소에서만 사용한다.
신규 기능 요구사항과 ui-proto를 분석하여 team-dev/team-e2e가 추가 기획 질문 없이 실행할 수 있는 확정 Spec을 생성하는 스킬. "Spec 만들어줘", "신규 기능 기획", "요구사항 정리" 키워드로 트리거. ui-proto가 있으면 proto=<경로>로 화면 기획안에서 Spec을 추출한다. 기존 기능 분석이 필요하면 peach-doc-feature를 사용한다.
3-에이전트(Architect→Builder→Reviewer) 루프로 단일 기능을 설계·구현·검증하는 팀 스킬. "3a로 만들어줘", "3에이전트", "설계-구현-검토", "team-3a" 키워드로 트리거. peach-team-dev보다 가벼운 단일 기능·소규모 수정에 적합.
agent-browser CLI로 Chrome Beta CDP에 연결하여 페이지 탐색, 데이터 확인, 요소 조작을 수행하는 스킬. "브라우저 확인", "페이지 봐줘", "DOM 확인", "데이터 점검", "클릭해줘", "화면 확인" 키워드로 트리거. E2E 시나리오 작성 중 셀렉터 확인이나 실행 실패 디버깅에도 사용한다. e2e/ 폴더 없이도 단독 실행 가능.
Backend 없이 Mock 데이터 기반 프로토타입 UI를 생성·검증하는 기획 구체화 산출물 스킬. Vue 3 + TypeScript + NuxtUI v4. 별도 ui-proto 저장소(예: peach-ui-proto-backoffice)의 src/modules-task 폴더에 태스크별 화면을 누적한다. "프로토타입 만들어줘", "Mock 화면", "proto UI", "기획 화면 빠르게", "ui-proto 작업", "기획자 검토용 화면", "태스크 폴더 추가", "팀 ui-proto" 키워드로 트리거. 기획자가 직접 작업하는 화면 기획 + 현업 검토용 산출물 스킬이며, 개발용 Spec은 후속 peach-gen-spec이 생성한다. 실제 API 연동이 필요하면 peach-gen-ui를 사용한다.
Backend API 전문 생성 스킬. "백엔드 만들어줘", "API 생성", "서버 코드 만들어줘" 키워드로 트리거. TDD 검증 필수, AI와 티키타카로 완성도 확보.
대상 프로젝트에 피치 하네스 시스템을 설정합니다. CLAUDE.md를 최소 진입점으로 정리하고, AGENTS.md를 95~130줄 규모로 생성/업데이트합니다. Use when: "하네스 설정", "프로젝트 초기 설정", "CLAUDE.md 정리", "AGENTS.md 업데이트", "세션 시작 설정" 키워드.
Store 기반 프로덕션 UI를 생성하는 스킬. Vue 3 + TypeScript + NuxtUI v4. "UI 만들어줘", "화면 생성", "CRUD 화면", "목록 화면" 키워드로 트리거. Store가 존재해야 하며 실제 API와 연동된 프로덕션 코드를 생성한다. Mock 데이터 기반 프로토타입이 필요하면 peach-team-ui-proto를 사용한다.
Frontend-Only UI Proto 프로젝트에 피치 하네스 시스템을 설정합니다. CLAUDE.md를 최소 진입점으로 정리하고, AGENTS.md를 70~90줄 규모로 생성/업데이트합니다. Use when: "ui proto 하네스 설정", "ui proto AGENTS 정리", "Frontend-Only 하네스 설정", "프로토타입 프로젝트 초기 설정" 키워드.