Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
AI-Rig은 Python, ML 및 오픈 소스 유지보수를 위한 실용적인 에이전트 워크플로우입니다. 이 도구는 변경 범위 지정, 버그 재현, PR 검토 등 반복적이고 복잡한 개발 작업을 명시적이고 구조화된 워크플로우로 변환합니다. Claude Code, Codex 등 다양한 AI 런타임을 지원하며 전문 소유권과 증거 게이트를 통해 신뢰성을 높입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Borda's AI-Rig banner
License: Apache 2.0 
Claude Code Codex OpenCode Python 3.10+ Platforms
CI manifests 
CI executables 
CI harness 
codecov 
pre-commit.ci status
Python, ML(머신러닝), 그리고 오픈 소스 유지보수를 위한 실용적인 에이전트 워크플로우입니다. AI-Rig은 변경 사항 범위 지정(scoping a change), 버그 재현(reproducing a bug), 풀 리퀘스트 검토(reviewing a pull request), 실험 실행(running an experiment), 또는 릴리스 준비 상태 확인(checking release readiness)과 같은 반복적인 작업을 전문 소유권, 증거 게이트(evidence gates), 그리고 검토 가능한 아티팩트가 포함된 명시적 워크플로우로 변환합니다.
총 8개의 패키지가 세 가지 런타임(runtimes)을 지원합니다. 여기에는 Claude Code용 마켓플레이스 플러그인 6개, Codex용 3개, 그리고 OpenCode용 npm 플러그인 1개가 포함되며, codemap-py와 bridge_CC-Codex는 각각 두 개의 호스트에서 공유됩니다.
눈앞의 작업을 해결하는 가장 작은 플러그인을 선택하세요. 모든 패키지는 독립적으로 설치되며, 선택적 통합 기능은 숨겨진 전제 조건이 되는 대신 전문적인 깊이나 구조적 맥락을 추가합니다.
| Need | Start with | What it gives you |
|---|---|---|
| 클로드 에이전트 구성(configuration), 라우팅(routing), 재사용 가능한 가이드라인을 건강하게 유지 | 🏭 foundry | 10개의 전문 에이전트, 11개의 구성/콘텐츠 스킬(skills), 규칙(rules), 후크(hooks), 감사(audit), 및 보정(calibration) |
| ... | ||
| 만약 클로드 코드(Claude Code)를 사용한다면, 클로드 가이드를 읽으세요. 코덱스(Codex)를 사용한다면, 코덱스 가이드를 읽으세요. OpenCode는 npm 패키지를 직접 설치하며, 해당 README가 호스트 가이드입니다. |
이들은 모든 실행에서 모든 전문가를 구동하거나, 모든 동적 종속성(dynamic dependency)을 찾거나, 올바른 변경 사항을 게시한다는 약속이 아닌 워크플로우 계약입니다. 연결된 플러그인 README에는 각 경로의 전제 조건(prerequisites), 폴백(fallback), 중지 동작이 정의되어 있습니다.
이것은 실제 출하된 기술 역량 목록입니다. 호스트 가이드에는 모든 에이전트, 역할, 규칙 및 후크가 나열되어 있으며, 플러그인 README에는 인자(arguments), 출력(outputs), 전제 조건, 복구 방법, 엣지 케이스 등이 문서화되어 있습니다.
<details> <summary><strong id="show-complete-capability-map">전체 기능 지도 보기</strong></summary>| 패키지 | 전체 스킬 목록 |
|---|---|
| 🏭 Foundry | /foundry:setup, /foundry:audit, /foundry:calibrate, /foundry:manage, /foundry:brainstorm, /foundry:investigate, /foundry:profile, /foundry:distill, /foundry:session, /foundry:create, /foundry:humanizer |
| ... |
설치된 모든 Claude 표면(surface)은 Foundry에 16개 에이전트(Foundry 10, OSS 4, Research 2), 그리고 Foundry(11), OSS(5), Develop(7), Research(10), Codemap-py(6), bridge_CC-Codex(7)를 통해 총 46개의 스킬을 포함합니다. 또한 이 표면은 16개의 네임스페이스 규칙(각 동반자(companion)가 규칙을 배포하는 경우 Foundry 규칙 13개와 품질 게이트(quality-gates) 규칙 1개)과 호스트 후크를 포함하며, 정확한 활성 모듈 개수는 Claude 가이드에 유지됩니다. Codex Rig는 스킬 14개, 역할 카드 15개, 공유 게이트, 보정(calibration), 그리고 선택적 읽기 전용 상태 후크를 추가합니다. Codemap-py는 두 실행 환경 모두에 스킬 6개를 기여하며 Codex 후크 매니페스트는 없습니다. bridge_CC-Codex 플러그인은 Codex 측 스킬 4개와 역방향 MCP 전송을 기여합니다. OpenCode Rig는 TypeScript npm 패키지로 스킬 11개, 증거 도구 7개, 그리고 설치된 역할 에이전트 7개를 추가합니다.
전문가 역할(Specialist roles)은 이름으로 요청하거나 자동 선택됩니다. Claude 에이전트는 <플러그인>:<에이전트> 형식으로 배포되며, Codex 열은 Codex Rig 역할 카드로도 배포되는 역할을 표시합니다.
| 역할 | Claude 플러그인 | Codex | 소유 (Owns) |
|---|---|---|---|
| sw-engineer | 🟠 foundry | ✓ | 구현, 리팩토링, SOLID, 타입 안전성; 또한 후크 JS 작성 |
| ... |
총 16개의 Claude 에이전트와 15개의 Codex 역할 카드가 있습니다. delegation-lead와 security-auditor는 Codex 전용이며 — Claude 측에서는 보안 검토가 foundry:qa-specialist에 통합됩니다. Codex 가이드는 각 역할 카드를 소유권 및 요청된 모델 티어에 매핑합니다.
| Runtime | Source inventory | Distribution and trust boundary |
|---|---|---|
| Claude Code | Foundry, OSS, Develop, Research, Codemap-py 및 bridge_CC-Codex의 6개 피어 플러그인. | 마켓플레이스 패키지는 플러그인 로더 에이전트(plugin-loader agents), 스킬(skills), 후크(hooks) 및 CLAUDE.md를 노출합니다. 프로젝트 설정은 문서화된 규칙/설정만 수행하며 자격 증명이나 원격 권한을 설치하지 않습니다. |
The 설계 원칙은 간단합니다: 패키지를 독립적으로 설치 가능하게 유지하면서 불확실성(uncertainty), 소유권(ownership), 증거(evidence), 그리고 복구(recovery)를 가시화하는 것입니다. 워크플로우가 전문가에게 라우팅될 수는 있지만, 역할 카드(role card), 작업 이름(task name), 아티팩트(artifact), 또는 녹색 게이트(green gate)는 모델이 이를 따랐거나 결과로 나온 변경 사항이 정확하다는 증거가 아닙니다. 인간의 검토(Human review)는 중대한 작업을 위한 수용 경계(acceptance boundary)로 남아 있습니다.
사전 요구사항: 플러그인 지원 기능이 있는 최신 Claude Code 릴리스 버전입니다. 아래 명령어들은 Anthropic의 마켓플레이스 및 플러그인 설치 흐름을 따릅니다.
마켓플레이스를 한 번 등록한 후, 필요한 것만 설치합니다:
claude plugin marketplace add Borda/AI-Rig
claude plugin install foundry@borda-ai-rig
claude plugin install oss@borda-ai-rig
...
새로운 Claude 세션을 시작하거나 /reload-plugins를 실행합니다. 규칙을 포함하는 각 설치된 플러그인에 대해, 업그레이드 후 한 번 더 해당 설정 스킬(setup skill)을 실행해야 합니다:
/foundry:setup
/oss:setup
/develop:setup
...
설정 스킬은 네임스페이스 규칙 링크를 생성합니다. Foundry만이 더 광범위하게 문서화된 설정 병합을 수행하고 TEAM_PROTOCOL.md를 설치하며, 다른 설정 스킬들은 자체 규칙을 제공합니다. Codemap-py는 별도의 설정 스킬이 필요하지 않습니다—/codemap-py:scan-codebase로 첫 프로젝트 인덱스를 구축하세요. bridge_CC-Codex 역시 규칙을 배포하지 않으며, /bridge:setup은 로컬 codex 및 claude CLI에 대한 무료 정적 검사입니다.
첫 유용한 명령어들:
/foundry:audit setup
/develop:plan "describe the next change"
/oss:analyse vitality
...
전제 조건: 안정적인 플러그인 명령을 가진 최신 Codex 릴리스. 아래 명령어들은 공식 Codex 개발자 명령어 참조와 일치합니다.
codex plugin marketplace add Borda/AI-Rig
codex plugin add codex-rig@borda-ai-rig
codex plugin add codemap-py@borda-ai-rig
...
codemap-py는 선택 사항입니다. 해결되지 않은(unresolved) Python 구조가 작업의 일부일 때 설치하고, 완전히 로컬화된 편집을 위해서는 건너뛰세요. 재현 가능한 마켓플레이스 바이트를 고정하려면 오래된 예시 태그를 복사하는 대신 --ref <release-tag>로 마켓플레이스를 추가하세요.
새로운 Codex 세션을 시작한 다음, 다음을 시도해 보세요:
$codex-rig:agent-shims doctor
$codex-rig:investigate find the root cause of the failing test
$codex-rig:implement apply the verified fix
...