Claude Code 완전 정복 가이드 Part 5: 나만의 Plugin Marketplace 만들기 - 팀/조직 확장

{
  "name": "my-awesome-plugin",
  "version": "1.0.0",
  "description": "플러그인 설명",
  "author": "Your Name",
  "homepage": "https://github.com/you/my-plugin"
}

{
  "name": "my-awesome-plugin",
  "version": "1.0.0",
  "description": "이 플러그인이 무엇을 하는지 간단히 설명",
  "author": "Your Name <you@example.com>",
  "homepage": "https://github.com/you/my-plugin",
  "repository": {
    "type": "git",
    "url": "https://github.com/you/my-plugin.git"
  },
  "license": "MIT",
  "keywords": ["go", "testing", "conventions"],
  "engines": {
    "claude-code": ">=2.0.0"
  },
  "dependencies": {
    "plugins": ["other-plugin@marketplace"]
  }
}

mkdir -p jvm-team-plugin/.claude-plugin
mkdir -p jvm-team-plugin/skills/kotlin-conventions
mkdir -p jvm-team-plugin/skills/test-patterns
mkdir -p jvm-team-plugin/commands

{
  "name": "jvm-team-plugin",
  "version": "1.0.0",
  "description": "JVM(Java/Kotlin) 개발팀을 위한 코딩 컨벤션, 테스트 패턴, Git 워크플로우",
  "author": "Your Team",
  "homepage": "https://github.com/your-org/jvm-team-plugin",
  "license": "MIT",
  "keywords": ["java", "kotlin", "spring-boot", "testing", "conventions"]
}

---
name: kotlin-conventions
description: Kotlin 코딩 컨벤션. Kotlin 코드 작성, 리뷰 시 자동 적용.
             "Kotlin", "코틀린", "kt 파일" 작업 시 활성화.
---

# Kotlin Coding Conventions

## 파일 구조

```kotlin
// 1. 패키지 선언
package com.example.feature

// 2. Import (알파벳 순, 와일드카드 금지)
import com.example.other.SomeClass
import org.springframework.stereotype.Service

// 3. 클래스/함수 정의

// ✅ 좋은 예: 단일 표현식 함수
fun isValid(email: String): Boolean = email.contains("@")

// ✅ 좋은 예: 명확한 반환 타입
fun findUser(id: Long): User? {
    return userRepository.findById(id).orElse(null)
}

// ❌ 나쁜 예: 불필요한 Unit 반환
fun saveUser(user: User): Unit {  // Unit 생략
    userRepository.save(user)
}

// ✅ Safe call + Elvis
val name = user?.name ?: "Unknown"

// ✅ let으로 null 체크
user?.let {
    sendEmail(it.email)
}

// ❌ 강제 unwrap 금지 (테스트 제외)
val name = user!!.name  // 프로덕션 코드에서 금지

// ✅ DTO는 data class
data class UserResponse(
    val id: Long,
    val name: String,
    val email: String
)

// ✅ Entity는 일반 class (JPA 프록시 호환)
@Entity
class User(
    @Id @GeneratedValue
    val id: Long = 0,
    var name: String,
    var email: String
)

// 유틸리티성 확장 함수는 Extensions.kt에 모아두기
// com/example/common/Extensions.kt

fun String.toSlug(): String =
    this.lowercase().replace(" ", "-")

fun <T> List<T>.secondOrNull(): T? =
    this.getOrNull(1)

// 백틱 사용, should_결과_when_조건 패턴
`should return user when valid id provided`
`should throw exception when user not found`
`should send email when user created`

// Stubbing
every { repository.findById(1L) } returns user
every { repository.findById(any()) } returns null
every { service.process(any()) } throws SomeException()

// Relaxed mock (모든 메서드 기본값 반환)
@MockK(relaxed = true)
private lateinit var logger: Logger

// Verification
verify { repository.save(user) }
verify(exactly = 2) { service.notify(any()) }
verify(ordering = Ordering.SEQUENCE) {
    service.start()
    service.process()
    service.end()
}

@SpringBootTest
@AutoConfigureMockMvc
@Transactional
class UserApiIntegrationTest {

    @Autowired
    private lateinit var mockMvc: MockMvc

    @Autowired
    private lateinit var userRepository: UserRepository

    @Test
    fun `POST users should create user and return 201`() {
        // Given
        val request = """
            {
                "name": "John",
                "email": "john@test.com"
            }
        """.trimIndent()

        // When & Then
        mockMvc.post("/api/v1/users") {
            contentType = MediaType.APPLICATION_JSON
            content = request
        }.andExpect {
            status { isCreated() }
            jsonPath("$.data.name") { value("John") }
        }

        // DB 검증
        val saved = userRepository.findByEmail("john@test.com")
        assertThat(saved).isNotNull
    }
}

// test/fixtures/UserFixtures.kt
object UserFixtures {
    fun aUser(
        id: Long = 1L,
        name: String = "Test User",
        email: String = "test@example.com"
    ) = User(id = id, name = name, email = email)

    fun aCreateUserRequest(
        name: String = "Test User",
        email: String = "test@example.com"
    ) = CreateUserRequest(name = name, email = email)
}

// 사용
val user = UserFixtures.aUser(name = "Custom Name")