ham

ham

2026 함수랑마라톤 ham팀의 Claude Code 플러그인 마켓플레이스.

왜 만들었나요?

2026년, 포켓몬이 30주년을 맞이했습니다.

어릴 적 포켓몬과 함께했던 설렘을 떠올리며, 매일 반복되는 개발 시간에도 그런 즐거움을 담고 싶었습니다. 코드를 한 줄 고칠 때마다 파트너가 성장하고, 커밋을 찍을 때마다 새로운 동료가 합류하고, 동료 개발자와 서로의 도감을 비교하며 "나 리자몽 됐다!" 하고 자랑하는 순간들. 개발이 단순한 작업이 아니라 하나의 모험이 되길 바랐습니다.

151종 도장 깨기, 같이 도전해 보지 않을래요?

설치

claude plugin marketplace add https://github.com/hamsurang/ham
claude plugin install pokemon

설치 후 Claude Code를 새로 시작하면 파트너 포켓몬이 자동으로 나타납니다.

Go가 필요합니다. 첫 실행 시 바이너리가 없으면 자동으로 빌드됩니다.

사용법

/pokemon:go              파트너 상태 확인
/pokemon:go list         포켓몬 도감
/pokemon:go choose fire  파트너 변경 (fire/water/grass)

자연어로도 가능합니다. "포켓몬 보여줘", "도감", "파트너 바꿔" 등.

포켓몬을 모으는 3가지 방법

1. 파트너 진화

코딩하면 경험치가 쌓이고, 파트너 포켓몬이 진화합니다.

행동	경험치
Edit (코드 수정)	+3
Write (파일 생성)	+5
Bash (일반 명령)	+1
Bash (테스트 실행)	+5
Bash (git commit)	+10

단계	필요 경험치	예시 (불꽃 타입)
1단계 → 2단계	100	파이리 → 리자드
2단계 → 3단계	300	리자드 → 리자몽

2. 업적 달성

특정 조건을 달성하면 포켓몬이 합류합니다.

업적	조건	합류 포켓몬
첫 커밋	커밋 1회	Eevee (이브이)
테스트 러너	테스트 실행 10회	Pikachu (피카츄)
야행성 코더	새벽 코딩 5회	Gengar (팬텀)
버그 사냥꾼	fix 포함 커밋 5회	Scyther (스라크)
아키텍트	파일 생성 20회	Lapras (라프라스)
백전노장	코드 수정 100회	Mewtwo (뮤츠)

3. 야생 조우

경험치 50마다 야생 포켓몬 1마리를 만납니다. 코딩 패턴에 따라 만나는 타입이 달라집니다.

코딩 패턴	자주 만나는 타입
버그 수정 (fix 커밋)	불꽃
테스트 작성	전기
새벽 코딩	고스트, 에스퍼
파일 생성	풀
커밋	바위

희귀도:

• 일반 (80%) — 대부분의 포켓몬
• 희귀 (20%) — 최종 진화형, 갸라도스, 잠만보 등
• 전설 — 경험치 500 이상에서만 등장 (프리져, 썬더, 파이어, 뮤츠, 뮤)

자동 동작

별도 조작 없이 전부 자동으로 동작합니다.

• 세션 시작: 파트너 포켓몬이 ASCII 아트로 인사 (SessionStart 훅)
• 도구 사용: Edit, Write, Bash 사용 시 자동 경험치 적립 (PostToolUse 훅)
• 진화/업적/야생 조우: 조건 충족 시 자동 알림

구조

ham/
├── .claude-plugin/marketplace.json     ← 마켓플레이스
└── plugins/pokemon/                    ← 플러그인
    ├── .claude-plugin/plugin.json
    ├── commands/go.md                  ← /pokemon:go 명령어
    ├── hooks/hooks.json                ← SessionStart + PostToolUse
    ├── skills/companion/SKILL.md       ← Claude 스킬
    ├── scripts/run.sh                  ← 자동 빌드 래퍼
    └── *.go                            ← Go 소스 (151종 데이터 + ASCII 아트)

팀

• BO-LIKE-CHICKEN
• sHyunis
• tooooo1