claude-plugin
Claude Code 확장 기능 개발 및 배포 프로젝트
공식 문서 기반으로 개발된 Skills, Hooks, Sub-agents, Commands, Rules 모음
프로젝트 개요
Claude Code의 확장 기능을 체계적으로 개발하고 마켓플레이스 플러그인으로 배포하여 Claude Code 사용자 경험을 향상시킵니다.
핵심 원칙
- 공식 소스 기반: Anthropic 공식 자료에 근거
- 검증된 패턴: 커뮤니티 검증 모범 사례 적용
- 재사용성: 범용 컴포넌트 설계
- 품질 우선: 배포 전 철저한 테스트
빠른 시작
1. 설치
git clone https://github.com/inchan/claude-plugins.git
cd claude-plugin
npm install
2. 문서 읽기
프로젝트를 이해하려면 다음 순서로 문서를 읽으세요:
- docs/instruction.md - 원본 지시사항
- docs/requirements.md - 프로젝트 요구사항
- docs/guidelines/ - 개발 가이드라인 모음
- docs/references/ - 레퍼런스 및 빠른 검색 ⭐
3. 개발 시작
# 테스트 실행
npm test
# 검증
npm run validate
상세한 개발 워크플로우는 docs/workflows.md와 docs/references/를 참고하세요.
프로젝트 구조
claude-plugins/
├── plugins/ # 플러그인 (핵심)
│ ├── base/ # 공통 에이전트 (engineer)
│ ├── tdd/ # TDD 개발 팀 (5개 에이전트)
│ ├── search/ # 웹 검색 통합
│ ├── doc-tools/ # 문서 관리
│ ├── outsourcing/ # AI CLI 위임
│ └── issue-linear/ # Linear 이슈 관리 (NEW)
├── scripts/ # 개발 자동화 스크립트
├── tests/ # 테스트 (중앙집중식)
├── docs/ # 프로젝트 문서
│ ├── guidelines/ # 개발 가이드라인
│ ├── references/ # 레퍼런스 패턴
│ └── templates/ # 컴포넌트 템플릿
└── .claude-plugin/ # 플러그인 메타데이터
각 플러그인 상세 구조는 plugins/{name}/README.md 참고
참고 자료
공식 문서 (1순위)
프로젝트 문서
기여하기
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Read Development Guidelines and References
- Commit your changes following workflows
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
품질 기준
Pull Request 전 확인:
라이센스
MIT License - 자세한 내용은 LICENSE 참고
연락처
변경 이력
- 2025-12-17: 프로젝트 확장
- issue-linear 플러그인 추가 (Linear 이슈 관리)
- scripts/ 디렉토리 추가 (플러그인 생성/업데이트 자동화)
- 플러그인 이름 통일 (inchan-* → icp-*)
- 2025-12-15: 프로젝트 구조 섹션 업데이트 (플러그인 기반 구조 반영)
- 2025-12-01: 문서 업데이트 자동화 도구 추가
/icp:doc-update 커맨드 추가 (문서-코드 불일치 자동 탐지/수정)doc-updater 에이전트 추가 (haiku 모델 기반, 4가지 원칙)- 참조 가이드 추가: doc-update-pattern.md, doc-updater-agent-pattern.md
- 플러그인 설정 검증 자동화 (validate-plugin-configs.js)
- 테스트 및 검증 문서 추가 (tests/README.md)
- 2025-11-29: 프로젝트 구조 직접 표기 (TDD 개발 팀 5개 반영)
- 2025-11-29: 프로젝트 구조 섹션 참조로 변환 (CLAUDE.md 참조)
- 2025-11-28: QUICK_START.md 삭제 - 마켓플레이스 설치 기반으로 불필요, 내용은 docs/references로 이동
- 2025-11-28: README 간소화 - 중복 제거
inchan