Directories - Cursor 및 Windsurf 커뮤니티 규칙 및 MCP 서버 디렉터리

프로젝트 개요

Directories는 Cursor 및 Windsurf 커뮤니티를 위해 특별히 설계된 오픈 소스 프로젝트로, 주로 규칙(Rules)과 MCP(Model Context Protocol) 서버의 중앙 집중식 관리 및 공유 플랫폼을 제공합니다. 이 프로젝트는 Pontus Abrahamsson이 개발 및 유지보수하며, 개발자들이 AI 기반 프로그래밍 도구를 더 잘 활용할 수 있도록 돕는 것을 목표로 합니다.

주요 기능

1. 규칙 관리 시스템

• 중앙 집중식 규칙 저장: 다양한 개발 규칙 및 프롬프트를 packages/data/rules/ 디렉터리에 중앙 집중식으로 관리합니다.
• 표준화된 형식: 각 규칙은 일관성과 유용성을 보장하기 위해 통일된 매개변수 형식을 포함합니다.
• 분류 관리: 프로그래밍 언어, 프레임워크 또는 도구별로 분류하여 구성합니다.

2. 커뮤니티 기여 메커니즘

• 개방형 기여: 모든 개발자는 새로운 규칙을 제출하거나 기존 규칙을 개선할 수 있습니다.
• 표준화된 절차: 코드 품질 및 표준화를 보장하기 위한 상세한 기여 가이드를 제공합니다.
• 테스트 검증: 기여자에게 프롬프트가 관련 개발 환경에서 정상적으로 작동하는지 테스트하도록 요구합니다.

3. MCP 서버 통합

• MCP 지원: Model Context Protocol을 지원하여 AI 도구의 상호 작용 능력을 향상시킵니다.
• 다중 도구 호환: Cursor 및 Windsurf 두 가지 주요 AI 프로그래밍 도구를 동시에 지원합니다.

기술 아키텍처

프로젝트 구조

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # 규칙 인덱스 파일
│           └── rules/            # 특정 규칙 파일 디렉터리
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Cursor 관련 설정
│   └── windsurf/                 # Windsurf 관련 설정

규칙 정의 형식

각 규칙 파일은 다음 표준 매개변수를 포함해야 합니다.

{
  tags: ["JavaScript", "Next.js"],           // 언어별 태그
  title: "Next.js Best Practices",           // 규칙 제목
  slug: "nextjs-best-practices",             // 고유 식별자
  content: `your amazing prompt`,            // 프롬프트 내용
  author: {                                  // 작성자 정보
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

사용 방법

개발 환경 설정

# 의존성 설치
npm install

# 개발 서버 시작
npm run dev
# 또는
yarn dev
# 또는
pnpm dev
# 또는
bun dev

# http://localhost:3000 에 접속

새 규칙 추가

1. 규칙 인덱스 위치 지정: packages/data/rules/index.ts 파일에 새 규칙을 임포트합니다.

   import { cRules } from "./rules/c";
   

2. 규칙 파일 생성: packages/data/rules/ 디렉터리에 새 규칙 파일을 생성합니다.

   // 예시: nextjs.ts
   export const nextjsRules = {
     // 규칙 정의
   };
   

3. 규칙 내용 정의: 표준 형식에 따라 규칙을 작성하고 다음을 확인합니다.

   • 정확성: 규칙과 관련성이 높고 정확해야 합니다.
   • 명확성: 개발자가 이해하고 사용하기 쉽도록 명확하게 작성해야 합니다.
   • 실행 가능성: 일반적인 문제를 해결하기 위한 구체적인 단계 또는 통찰력을 제공해야 합니다.

기존 규칙 업데이트

1. 관련 규칙 파일을 찾습니다.
2. 기존 프롬프트 아래에 새 내용을 추가합니다.
3. 새로 추가된 내용이 테스트 검증을 거쳤는지 확인합니다.

커뮤니티 특징

품질 보증

• 테스트 요구 사항: 모든 프롬프트는 테스트 검증을 거쳐야 합니다.
• 정확성 보장: 규칙 내용의 정확성과 유용성을 보장합니다.
• 지속적인 개선: 커뮤니티는 기존 규칙을 지속적으로 유지보수하고 개선합니다.

개발자 친화적

• 상세 문서: 완전한 기여 가이드 및 사용 설명서를 제공합니다.
• 표준화된 절차: 통일된 규칙 형식 및 제출 절차를 제공합니다.
• 인정 메커니즘: 작성자 정보를 통해 기여자의 기여를 표시합니다.

도구 통합

• 다중 편집기 지원: Cursor 및 Windsurf를 동시에 지원합니다.
• 실시간 적용: 규칙의 자동 적용 및 파일 경로 패턴의 지능형 매칭을 지원합니다.
• MCP 통합: Model Context Protocol을 지원하여 AI 상호 작용 능력을 향상시킵니다.

프로젝트 장점

1. 중앙 집중식 관리: 분산된 규칙 및 프롬프트를 중앙 집중식으로 관리하여 검색 및 사용이 용이합니다.
2. 표준화된 형식: 통일된 규칙 형식은 호환성 및 유지보수성을 보장합니다.
3. 커뮤니티 주도: 개방형 기여 메커니즘은 지식 공유 및 지속적인 개선을 촉진합니다.
4. 도구 독립적: 여러 AI 프로그래밍 도구를 동시에 지원하여 적용 가능성을 높입니다.
5. 품질 보증: 엄격한 테스트 및 검증 절차를 통해 규칙의 유효성을 보장합니다.

활용 사례

• AI 기반 프로그래밍: Cursor 및 Windsurf 사용자에게 최적화된 프로그래밍 규칙을 제공합니다.
• 팀 협업: 팀이 프로그래밍 표준을 공유하고 표준화할 수 있습니다.
• 기술 향상: 초보 개발자가 모범 사례를 학습할 수 있습니다.
• 도구 최적화: MCP 프로토콜을 통해 AI 도구의 기능을 향상시킵니다.

요약

Directories 프로젝트는 AI 기반 프로그래밍에 중점을 둔 커뮤니티 플랫폼으로, 규칙 및 MCP 서버 구성을 중앙 집중식으로 관리하여 개발자에게 표준화되고 고품질의 리소스 라이브러리를 제공합니다. 이 프로젝트는 개발 효율성을 높일 뿐만 아니라 AI 프로그래밍 모범 사례의 전파 및 적용을 촉진합니다.