ctx-forge은(는) 무엇을 하나요?
AI 코딩 에이전트를 위한 프로젝트별 자체 검증 컨텍스트 도구를 생성합니다. 이 스킬은 저장소를 감사하고, ctx CLI(+MCP)를 생성한 후, 골든 질문에 대해 검증한 다음 설치합니다. Headroom과 함께 사용됩니다.
개요
이 스킬은 AI 코딩 에이전트(Claude Code, Cursor 등)가 프로젝트에 특화된 지식을 얻을 수 있도록 돕는 자체 검증 컨텍스트 도구를 만듭니다. 저장소를 분석하여 어떤 파일과 설정이 중요한지 파악하고, ctx라는 명령줄 도구와 MCP(Model Context Protocol) 서버를 생성합니다. 생성된 도구는 '골든 질문'이라는 사전 정의된 질문 세트에 대해 테스트되어, AI 에이전트에게 유용하고 정확한 정보를 제공하는지 검증합니다.
작동 방식
- 저장소 감사: 저장소의 파일 구조, 의존성, 설정 파일 및 관례를 스캔합니다.
- 컨텍스트 도구 생성: 감사 결과를 바탕으로
ctxCLI 및 선택적으로 MCP 서버를 생성합니다. - 자체 검증: 생성된 도구를 '골든 질문' 세트(예: "이 프로젝트의 주요 프레임워크는 무엇인가요?")를 사용해 테스트합니다.
- 설치: 검증이 통과되면 도구를 로컬 환경에 설치합니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex (및 MCP 호환 에이전트)
요구 사항
- Node.js 18 이상
- (선택 사항) Headroom - 일관된 프로젝트 메타데이터를 위해
사용법
# 저장소 감사 및 컨텍스트 도구 생성
npx ctx-forge audit
# 컨텍스트 도구에 대한 골든 질문 정의
npx ctx-forge golden
# 생성된 도구를 MCP 서버로 실행
npx ctx-forge serve
골든 질문 예시
- 이 프로젝트의 주요 언어는 무엇인가요?
- 프로젝트에서 사용하는 테스트 프레임워크는 무엇인가요?
- CI/CD 파이프라인은 어디에 정의되어 있나요?
MCP 통합
MCP 서버는 AI 에이전트가 ctx 도구의 출력을 직접 쿼리하고 수신할 수 있도록 표준 인터페이스를 제공합니다.
Headroom과의 통합
Headroom은 프로젝트 메타데이터(예: headroom.yaml)를 정의하고 검증하는 데 사용할 수 있습니다. ctx-forge는 이 메타데이터를 읽어 더 풍부한 컨텍스트를 생성합니다.
구성
ctx-forge.yaml 파일에 다음을 구성할 수 있습니다:
- 포함/제외할 파일 및 디렉토리
- 골든 질문 세트
- MCP 서버 설정
- Headroom 통합 설정
문제 해결
- "저장소를 감사할 수 없습니다": 프로젝트 루트에서 실행 중인지 확인하십시오.
- "MCP 서버 연결 실패": 포트가 사용 중이 아닌지 확인하고 방화벽을 확인하십시오.
- "골든 질문 검증 실패": 골든 질문이 저장소 구조와 관련이 있는지 확인하십시오.
라이선스
MIT