claude-code-expert

되돌릴 수 없는 결정(ADR)과 그 근거를 시간순으로 specs/DECISIONS.md에 append-only 기록한다. 아키텍처·의존성·API 계약 변경 시 사용. 주의 — 이건 결정 로그이지 릴리스 버전 이력이 아니다(VERSION·CHANGELOG.md 갱신은 version-changelog 스킬).

개발이 스펙대로 됐는지 구현 주장 항목을 코드 대조로 0~100 채점하고, 95점 미만은 되먹여 재작업하는 검증 루프를 돈다. carve-verify-loop 워크플로가 없거나(타 에이전트·일반 세션) 손으로 돌릴 때 사용.

프로젝트를 전수 분석(스택+코드베이스)해 ① CLAUDE.md·AGENTS.md 설정 정합성을 검증·제안하고 ② 스택에 필요한데 없는 요소(하네스 규칙·외부 개발도구·설정 스캐폴딩)를 보강 제안하며 ③ 불필요한 구성을 prune한다. FIX/ADD/KEEP/PRUNE 통합 제안표 → 1회 확인 → 적용 → evaluator 독립 평가표. 전체 설치 후 프로젝트에 맞게 맞춤화할 때 사용.

하네스의 모든 HTML 산출물(문서·가이드·랜딩·리포트·데모 등)을 일관된 디자인 시스템으로 작성·갱신하는 범용 스킬. anti-ai-slop 하드 게이트 + theme-factory(색·폰트)·frontend-design(레이아웃 방향) 디자인 검토 + 1000px 반응형 + 임베드(SPA) 안전 + 실측 검증을 기본 탑재. HTML을 "예쁘게/그럴듯하게" 만들 때 발동. 릴리스 시 carve-workflow-guide.html 갱신은 §7 특수 모드(이 리포 전용).

이미지·HTML·SVG·슬라이드·PDF 등 시각 산출물과 문서·리포트·카피 글쓰기를 생성·수정하기 전 반드시 발동한다. 그라데이션·글로우·장식 모션 등 AI 특유의 조악한(slop) 디자인을 차단하고, 상투어·균질 구조·불릿 남발 등 AI 티가 나는 글쓰기 흔적을 제거한다. 정보 위계·여백·타이포·근거·절제로 시니어 실무자가 만든 수준의 고급 산출물을 만드는 품질 게이트. 무언가를 "예쁘게" 또는 "그럴듯하게" 만들려는 순간마다 이 게이트를 통과시킨다.

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

릴리스 버전이 바뀔 때 VERSION·CHANGELOG.md·README 버전 이력을 함께 갱신한다. 버전 업/릴리스 준비 시 반드시 사용 — VERSION만 바꾸면 pre-commit이 커밋을 차단한다.

세션 종료·컨텍스트 압축 직전에 진행 상황을 specs/HANDOFF.md로 인계한다. 긴 작업의 연속성이 필요할 때 사용.

Produce documents, visuals, and file transforms that read as deliberate human work instead of generic AI output. Use whenever writing prose (docs, README, reports, PR/commit bodies, code comments), creating a chart/graph/diagram or choosing an image, or converting/editing an existing document (format conversion, refactor, bulk edit). Read the matching reference before producing the artifact.

세션 인계. 컨텍스트가 차거나 세션을 끝낼 때 진행상황·결정·다음 할 일을 남겨 다음 세션이 이어가게 한다. "핸드오프", "이어서 작업", "인계/컨텍스트 정리", "세션 정리" 요청에 사용. precompact 훅이 남긴 자동 스냅샷을 사람이 읽을 인계문으로 정리하는 데도 쓴다.

되돌릴 수 없는 결정과 그 근거를 시간순으로 changelog/changelog.md에 기록한다. 아키텍처·의존성·API 계약 변경 시 사용. push/PR 직전 changelog-reminder 훅이 매니페스트 변경을 감지하면 이 스킬로 기록할지 검토한다.

새 프로젝트·서비스·모듈을 언어별로 부트스트랩할 때 사용. 공식 스캐폴더(create-next-app, cargo new, uv init, Spring Initializr 등)를 우선 쓰고, 손으로 파일 트리를 찍지 않으며, 구조는 필요할 때만 키운다. 언어를 정하면 references/<lang>.md의 현행 명령·디렉터리·코드 샘플을 따른다.

Record current session changes to CHANGELOG.md

Record a troubleshooting case to the troubleshooting/ folder. Use when the user reports an error, asks to document a solved issue, or says phrases like "트러블슈팅 기록", "에러 기록", "이슈 문서화", "/troubleshooting".

Apply the house run-ai.kr / brewnet.dev watermark (faint repeating diagonal text overlay) to an HTML document. Use when creating or updating any run-ai.kr guide/doc HTML that should carry the standard watermark, or when an existing doc's watermark needs to match the canonical look (darkness/size).

TypeScript/React 프론트엔드 코드를 Gemini API 로 리뷰합니다. 자기편향(self-bias) 제거 목적으로 Claude 가 아닌 외부 모델이 평가. "리뷰", "review", "PR 리뷰", "코드 리뷰", "외부 리뷰", "Gemini 리뷰" 키워드에 발화.

Structured debugging workflow. Use when code fails, tests break, errors are unclear, or debugging needs a systematic approach. Define problem → hypothesize → verify → fix.

TypeScript/React 프론트엔드 코드를 Gemini API 로 리뷰합니다. 자기편향(self-bias) 제거 목적으로 Claude 가 아닌 외부 모델이 평가. "리뷰", "review", "PR 리뷰", "코드 리뷰", "외부 리뷰", "Gemini 리뷰" 키워드에 발화.

Opus 4.8을 Fable 5의 절차·성능으로 운용하는 강제형 워크플로우. spec→analyze→design→implement→verify→done 단계를 훅과 상태머신으로 강제한다. 트리거: "fable parity", "파리티 모드", "분석-설계-구현 절차로", 새 기능·리팩터링 등 비자명한 개발 작업 시작 시.

현재 세션 상태를 다음 세션(또는 다른 사람)에게 넘기는 인계 문서를 한 파일(.handoff.md)에 체크리스트로 기록/갱신한다. "세션 인계", "핸드오프", "여기까지 정리해줘", "다음 세션을 위해 상태 남겨줘", 작업을 중단·전환할 때 사용. 선택 인자로 대상 파일 경로를 받을 수 있다(기본 .handoff.md).