unoplat/unoplat-code-confluence

unoplat-code-confluence은(는) 무엇을 하나요?

코드베이스를 에이전트에 항상 대비 상태로 유지하세요. 각 리포지토리별로 Agents.md를 생성 및 유지 관리하는 라이브 플러그형 컨텍스트 레이어를 유지하여 모든 코딩 워크플로우를 최소 2배 향상시킵니다.

개요

unoplat/unoplat-code-confluence는 AI 에이전트(예: Claude Code, Cursor, Codex)가 코드베이스를 더 효과적으로 이해하고 작업할 수 있도록 설계된 자동 컨텍스트 생성 도구입니다. 이 스킬은 각 리포지토리의 핵심 정보를 추출하여 표준화된 Agents.md 파일로 컴파일함으로써, 에이전트가 프로젝트 구조, 주요 패턴, 설정, 규칙 등을 즉시 파악할 수 있게 합니다.

주요 기능

• 자동 컨텍스트 생성: 리포지토리 스캔을 통해 Agents.md를 자동 생성합니다.
• 라이브 동기화: 코드베이스 변경 시 컨텍스트를 자동으로 업데이트합니다.
• 플러그형 아키텍처: 다양한 언어와 프레임워크에 맞게 확장 가능한 플러그인을 지원합니다.
• 표준화된 형식: 모든 리포지토리에서 일관된 Agents.md 구조를 제공합니다.

설치 방법

git clone https://github.com/unoplat/unoplat-code-confluence.git
cd unoplat-code-confluence
npm install

사용 방법

1. 리포지토리 루트에서 다음 명령을 실행합니다:

   npx unoplat-code-confluence init
   

2. 생성된 Agents.md를 확인하고 필요에 따라 수정합니다.
3. AI 에이전트(예: Claude Code)에서 이 파일을 참조하여 컨텍스트를 제공합니다.

구성 옵션

unoplat-config.json 파일에서 다양한 설정을 조정할 수 있습니다:

• scanDepth: 스캔할 디렉토리 깊이 (기본값: 3)
• excludedDirs: 스캔에서 제외할 디렉토리 목록
• plugins: 사용할 플러그인 목록

지원 플랫폼

• Claude Code
• Cursor
• Codex (GitHub Copilot)
• 기타 AI 어시스턴트

예제

다음은 생성된 Agents.md의 예시입니다:

# Agents.md

## 프로젝트 구조
- src/: 소스 코드
- tests/: 테스트 파일
- docs/: 문서

## 주요 의존성
- React 18
- TypeScript 5.0
- Jest 29

## 설정 파일
- tsconfig.json
- .eslintrc.js
- jest.config.js

## 규칙
- 모든 함수는 JSDoc으로 문서화되어야 합니다.
- 테스트 커버리지는 80% 이상이어야 합니다.

기여하기

기여는 언제나 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT