backend-claude-code

백엔드 프로젝트에 Claude Code 설정을 빠르게 적용하는 harness.

지원 프레임워크: spring-boot | fastapi

설치 / 업데이트

# 프레임워크 명시
npx backend-claude-code@latest spring-boot /path/to/project
npx backend-claude-code@latest fastapi /path/to/project

# 자동 감지 (pyproject.toml → fastapi, build.gradle/pom.xml → spring-boot)
npx backend-claude-code@latest /path/to/project

# 현재 디렉토리에 설치
npx backend-claude-code@latest spring-boot
npx backend-claude-code@latest fastapi

재실행하면 업데이트됩니다. 소스에서 삭제된 파일은 자동 제거, 새 파일은 추가됩니다.

설치 후 해야 할 일

1. Claude Code 실행 후 /dev init — 프로젝트를 자동 분석해서 CLAUDE.md와 rules를 현재 프로젝트에 맞게 커스터마이징
2. .mcp.json — GITHUB_TOKEN 환경변수 설정
3. .claude/settings.json — 기존 파일이 있다면 수동 병합

특정 파일 업데이트 제외

커스텀한 파일은 .claude/.claude-ignore에 등록하면 덮어쓰지 않습니다.

# .claude/.claude-ignore
rules/repository-patterns.md
agents/code-reviewer.md

제거

./uninstall.sh /path/to/project

.installed-files에 기록된 파일만 삭제합니다. 직접 만든 파일은 건드리지 않습니다.

spring-boot

에이전트 (7개)

| 에이전트 | 역할 | |---------|------| | code-reviewer | Java/Spring Boot 코드 리뷰 | | java-build-resolver | 빌드·컴파일 에러 수정 | | security-reviewer | 보안 취약점 분석 (OWASP) | | tdd-guide | TDD 워크플로우 안내 | | planner | 기능 구현 계획 수립 | | database-reviewer | DB 쿼리·스키마 최적화 | | java-performance-reviewer | JVM·N+1·커넥션 풀·캐시 성능 분석 |

슬래시 커맨드 (14개)

| 커맨드 | 설명 | |--------|------| | /dev | 계획 → 구현 → 테스트 전체 워크플로우 | | /dev init | 프로젝트 분석 후 CLAUDE.md·rules 자동 커스터마이징 | | /dev plan | 코드베이스 분석 후 구현 계획서 작성 | | /dev run | 계획서 기반 코드 구현 및 검증 | | /dev test | TDD 워크플로우 (테스트 먼저 작성) | | /dev review | 로컬 변경사항(Java 특화) 또는 PR 종합 리뷰 | | /dev build | 빌드 오류 진단 및 수정 | | /dev fix | 빌드 에러 자동 수정 | | /dev verify | 빌드·정적분석·테스트·커버리지·보안 전체 검증 | | /dev coverage | 커버리지 분석 및 미달 영역 테스트 생성 | | /git commit | 변경사항 커밋 | | /git pr | PR 자동 생성 (push → PR → CI 확인) | | /git issue | 이슈 생성 (bug / feat) | | /db-migrate | DB 마이그레이션 (Flyway/Liquibase 자동 감지) |

스킬 (10개)

| 스킬 | 설명 | |------|------| | springboot-patterns | Controller·Service·Repository 구조, 공통 패턴 | | springboot-security | Spring Security 설정 및 리뷰 기준 | | springboot-tdd | JUnit5·Mockito·Testcontainers TDD 워크플로우 | | java-coding-standards | Java 코딩 규칙·관용구·금지 패턴 | | jpa-patterns | 엔티티 설계, N+1 해결, 쿼리 최적화 | | database-migrations | Flyway·Liquibase 마이그레이션 패턴 | | postgres-patterns | PostgreSQL 쿼리·인덱스·성능 패턴 | | hexagonal-architecture | 헥사고날 아키텍처 (Ports & Adapters) | | api-design | REST API 설계 원칙·버저닝·에러 포맷 | | architecture-decision-records | ADR 작성 가이드 |

규칙 (11개)

| 파일 | 적용 범위 | |------|----------| | coding-style | 전체 Java 파일 | | testing | 테스트 파일 | | security | 인증·인가·입력처리 | | hooks | PostToolUse·Stop 자동화 | | architecture | 레이어 구조 및 책임 | | controller-patterns | *Controller.java | | dto-patterns | *Dtos.java | | entity-patterns | *Entity.java, domain/** | | repository-patterns | *Repository*.java | | service-patterns | *Service.java | | error-handling | 예외 처리 전반 |

fastapi

에이전트 (7개)

| 에이전트 | 역할 | |---------|------| | code-reviewer | Python/FastAPI 코드 리뷰 | | python-build-resolver | 린트·타입·임포트 에러 수정 | | security-reviewer | 보안 취약점 분석 (OWASP) | | tdd-guide | TDD 워크플로우 안내 | | planner | 기능 구현 계획 수립 | | database-reviewer | SQLAlchemy 쿼리·스키마 최적화 | | python-performance-reviewer | 비동기·N+1·커넥션 풀 성능 분석 |

슬래시 커맨드 (14개)

| 커맨드 | 설명 | |--------|------| | /dev | 계획 → 구현 → 테스트 전체 워크플로우 | | /dev init | 프로젝트 분석 후 CLAUDE.md·rules 자동 커스터마이징 | | /dev plan | 코드베이스 분석 후 구현 계획서 작성 | | /dev run | 계획서 기반 코드 구현 및 검증 | | /dev test | TDD 워크플로우 (테스트 먼저 작성) | | /dev review | 로컬 변경사항(Python 특화) 또는 PR 종합 리뷰 | | /dev build | 린트·타입 오류 진단 및 수정 | | /dev fix | 린트·타입 에러 자동 수정 | | /dev verify | 린트·타입체크·테스트·커버리지·보안 전체 검증 | | /dev coverage | 커버리지 분석 및 미달 영역 테스트 생성 | | /git commit | 변경사항 커밋 | | /git pr | PR 자동 생성 (push → PR → CI 확인) | | /git issue | 이슈 생성 (bug / feat) | | /db-migrate | Alembic 마이그레이션 실행·상태 확인·롤백 |

스킬 (9개)

| 스킬 | 설명 | |------|------| | fastapi-patterns | Router·Service·Repository 구조, 공통 패턴 | | fastapi-security | JWT·OAuth2·CORS 보안 설정 | | fastapi-tdd | pytest-asyncio·httpx·픽스처 TDD 워크플로우 | | python-coding-standards | 타입힌트·PEP8·ruff 설정·금지 패턴 | | sqlalchemy-patterns | 비동기 ORM, 관계, Eager loading 최적화 | | database-migrations | Alembic async 마이그레이션 패턴 | | postgres-patterns | PostgreSQL 쿼리·인덱스·성능 패턴 | | api-design | REST API 설계 원칙·버저닝·에러 포맷 | | architecture-decision-records | ADR 작성 가이드 |

규칙 (10개)

| 파일 | 적용 범위 | |------|----------| | coding-style | 전체 Python 파일 | | testing | 테스트 파일 | | security | 인증·인가·입력처리 | | hooks | PostToolUse·Stop 자동화 | | architecture | 레이어 구조 및 책임 | | router-patterns | api/**/*.py | | schema-patterns | schemas/**/*.py | | repository-patterns | repositories/**/*.py | | service-patterns | services/**/*.py | | error-handling | 예외 처리 전반 |

새 프레임워크 추가

frameworks/<name>/
├── CLAUDE.md
├── .claude/settings.json
├── agents/
├── rules/
├── commands/   # dev*, db-migrate
└── skills/

bin/cli.js와 install.sh의 FRAMEWORKS 배열에 이름 추가.

공통 커맨드(git-*)는 common/commands/에서 자동으로 병합됩니다.