콘텐츠로 이동

Language Plugins

프로그래밍 언어 및 프레임워크별 전문 지식을 description/path 기반 auto-load로 제공하는 Layer 3 플러그인.

Why this domain exists

lang/ 카테고리는 프로그래밍 언어 및 프레임워크별 전문 지식을 제공하는 플러그인 모음이다. Layer 3(Stack Skills)에 해당하며, description 기반 자동 로드로 동작한다.


공통 패턴

모든 lang 플러그인은 다음 구조를 따른다:

lang/<name>/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   ├── conventions/
│   │   └── SKILL.md              # 코딩 컨벤션 (auto-loaded)
│   ├── patterns/
│   │   ├── SKILL.md              # 디자인 패턴 가이드
│   │   └── examples/             # 패턴 예시
│   └── tooling/
│       └── SKILL.md              # 빌드/테스트/린트 도구 가이드
└── agents/                        # (선택) 스택 전문 agent
    └── <name>-expert.md

Skill 설계 원칙

  • user-invocable: false — 사용자가 직접 호출하지 않음
  • paths glob으로 해당 확장자 파일 작업 시에만 로드
  • description에 핵심 키워드 front-load

플러그인 목록

플러그인 대상 파일 매칭 패턴
typescript TypeScript / JavaScript / React / Next.js **/*.{ts,tsx,js,jsx}
python Python / FastAPI / Django **/*.py
go Go **/*.go
rust Rust **/*.rs
kotlin Kotlin / Android **/*.{kt,kts}
flutter Dart / Flutter **/*.dart
spring Spring Boot (Java/Kotlin) **/*.java, **/application.{yml,yaml,properties}

plugin.json 템플릿

{
  "name": "<lang-name>",
  "description": "<Language> coding conventions, patterns, and tooling for Claude Code.",
  "version": "0.1.0",
  "author": {
    "name": "pabloism0x",
    "email": "pablo@luxtra.dev"
  },
  "homepage": "https://github.com/luxtradev/bonie",
  "repository": "https://github.com/luxtradev/bonie",
  "keywords": ["<lang>", "conventions", "patterns"]
}

Skill 구성 패턴

conventions SKILL.md 패턴

---
name: conventions
description: |
  <Language> 코딩 컨벤션과 스타일 가이드.
  <Language> 코드를 작성하거나 리뷰할 때 자동 적용.
user-invocable: false
paths:
  - "**/*.<ext>"
---

# <Language> Coding Conventions

## 네이밍
- ...

## 파일 구조
- ...

## 에러 핸들링
- ...

patterns SKILL.md 패턴

---
name: patterns
description: |
  <Language> 디자인 패턴과 아키텍처 가이드.
  복잡한 구조 설계, 리팩토링, 새로운 모듈 작성 시 참조.
user-invocable: false
paths:
  - "**/*.<ext>"
---

tooling SKILL.md 패턴

---
name: tooling
description: |
  <Language> 빌드, 테스트, 린트 도구 사용 가이드.
  빌드 에러, 테스트 실패, CI 설정 시 참조.
user-invocable: false
paths:
  - "**/*.<ext>"
  - "**/Makefile"
  - "**/Dockerfile*"
---

우선 구현 대상

luxtra 팀의 현재 스택을 기준으로 우선순위:

순위 플러그인 이유
1 typescript 주력 언어, 프론트엔드/백엔드 공통
2 go 백엔드 서비스
3 rust 시스템 레벨 컴포넌트
4 python 스크립트, ML
5 kotlin Android
6 flutter 크로스플랫폼 모바일
7 spring 레거시 서비스

우선순위는 팀 상황에 따라 조정.


관련 문서