Codex Subagents

Source: https://github.com/VoltAgent/awesome-codex-subagents at 16f880a2a048
License: MIT
Read the English original

This edition is an AI-assisted translation.

13개 분야에 걸쳐 175개 이상의 Codex 서브에이전트를 모은 훌륭한 컬렉션.

훌륭한 Codex Subagents

이 저장소는 특정 개발 작업을 위해 설계된 전문 AI 어시스턴트인 Codex Subagents의 결정적인 컬렉션입니다. Codex를 위해 특별히 작성되었으며 공식 문서와 일치합니다.

설치

Codex 사용자 정의 에이전트 디렉터리는 문서에 설명된 그대로 사용하세요:

• ~/.codex/agents/ : 전역 에이전트용(모든 프로젝트에서 사용 가능)
• .codex/agents/ : 프로젝트별 에이전트용(해당 저장소에서 우선순위가 더 높음)

1. 이 저장소를 클론합니다.
2. 원하는 .toml 에이전트 파일을 위 디렉터리 중 하나에 복사합니다.
3. 필요하면 Codex 세션을 재시작하거나 새로 고칩니다.
4. 프롬프트에서 명시적으로 위임하세요(Codex는 사용자 정의 서브에이전트를 자동으로 생성하지 않습니다).

예시:

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/

mkdir -p .codex/agents
cp categories/04-quality-security/reviewer.toml .codex/agents/

Codex에서 에이전트 구성을 사용한다면, 공식 문서에 설명된 대로 .codex/config.toml의 [agents] 아래에 보관하세요.

후원자

	Crawlbase 는 70,000명 이상의 개발자가 신뢰하는 웹 데이터 인프라입니다. 그들의 Crawling API, MCP 서버 및 통합을 통해 AI 에이전트는 모든 웹페이지에 실시간으로 접근할 수 있습니다 — JavaScript 렌더링, 프록시 로테이션, 안티봇 보호 포함.
	SerpApi 는 AI 앱을 위한 웹 검색 API입니다. 모든 통합을 위해 Markdown 및 JSON 형식으로 제공됩니다.

👉 여기에서 제품을 소개하고 Claude Code, Codex, Gemini 등의 AI 코딩 에이전트를 사용하는 개발자에게 도달할 수 있습니다.

서브에이전트 저장 위치

Type	Path	Availability	Precedence
Project Subagents	.codex/agents/	Current project only	Higher
Global Subagents	~/.codex/agents/	All projects	Lower

참고: 이름 충돌이 발생하면 프로젝트별 서브에이전트가 전역 서브에이전트를 덮어씁니다.

서브에이전트 구조

각 서브에이전트는 Codex 네이티브 .toml 형식을 사용합니다:

name = "subagent-name"
description = "When this agent should be invoked"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"

[instructions]
text = """
You are a [role description and expertise areas]...

[Agent-specific checklists, patterns, and guidelines]...
"""

스마트 모델 라우팅

각 서브에이전트에는 적절한 모델로 자동 라우팅되는 model 필드가 있어 품질과 비용의 균형을 맞춥니다:

Model	When It’s Used	Examples
gpt-5.6-sol	심층 추론 — 아키텍처 리뷰, 보안 감사, 금융 로직	security-auditor, architect-reviewer, fintech-engineer
gpt-5.6-terra	구현, 진단, 평가 및 다단계 전문 분석	docker-expert, test-automator, scientific-literature-researcher
gpt-5.6-luna	제한된 검색, 추출, 라우팅, 초안 작성 및 경량 합성	search-specialist, docs-researcher, agent-installer

샌드박스 모드 철학

각 서브에이전트의 sandbox_mode 필드는 파일 시스템 접근을 제어합니다:

• 읽기 전용 에이전트(리뷰어, 감사자): sandbox_mode = "read-only" — 수정 없이 분석
• 워크스페이스 쓰기 에이전트(개발자, 엔지니어): sandbox_mode = "workspace-write" — 파일 생성 및 수정

카테고리

01. Core Development

매일의 코딩 작업에 필요한 핵심 개발 서브에이전트.

• api-designer - REST 및 GraphQL API 아키텍트
• backend-developer - 확장 가능한 API를 위한 서버 측 전문가
• code-mapper - 코드 경로 매핑 및 소유권 경계 분석
• design-bridge - DESIGN.md 사양을 구현 가능한 UI 지침으로 변환
• electron-pro - 데스크톱 애플리케이션 전문가
• frontend-developer - React, Vue, Angular 전문 UI/UX 전문가
• fullstack-developer - 엔드투엔드 기능 개발
• graphql-architect - GraphQL 스키마 및 페더레이션 전문가
• microservices-architect - 분산 시스템 설계자
• mobile-developer - 크로스 플랫폼 모바일 전문가
• ui-designer - 시각 디자인 및 상호작용 전문가
• ui-fixer - 재현된 UI 문제에 대한 최소 안전 패치
• websocket-engineer - 실시간 통신 전문가

02. Language Specialists

깊은 프레임워크 지식을 갖춘 언어별 전문가.

• angular-architect - Angular 15+ 엔터프라이즈 패턴 전문가
• cpp-pro - C++ 성능 전문가
• csharp-developer - .NET 생태계 전문가
• django-developer - Django 4+ 웹 개발 전문가
• dotnet-core-expert - .NET 8 크로스 플랫폼 전문가
• dotnet-framework-4.8-expert - .NET Framework 레거시 엔터프라이즈 전문가
• elixir-expert - Elixir 및 OTP 내결함성 시스템 전문가
• erlang-expert - Erlang/OTP 및 rebar3 엔지니어링 전문가
• expo-react-native-expert - Expo 및 React Native 모바일 개발 전문가
• fastapi-developer - 최신 비동기 Python API 프레임워크 전문가
• flutter-expert - Flutter 3+ 크로스 플랫폼 모바일 전문가
• golang-pro - Go 동시성 전문가
• java-architect - 엔터프라이즈 Java 전문가
• javascript-pro - JavaScript 개발 전문가
• kotlin-specialist - 최신 JVM 언어 전문가
• laravel-specialist - Laravel 10+ PHP 프레임워크 전문가
• symfony-specialist - Symfony 애플리케이션 및 Doctrine 전문가
• nextjs-developer - Next.js 14+ 풀스택 전문가
• node-specialist - Node.js 백엔드 전문가
• php-pro - PHP 웹 개발 전문가
• powershell-5.1-expert - Windows PowerShell 5.1 및 전체 .NET Framework 자동화 전문가
• powershell-7-expert - 크로스 플랫폼 PowerShell 7+ 자동화 및 최신 .NET 전문가
• python-pro - Python 생태계 마스터
• rails-expert - Rails 8.1 rapid 개발 전문가
• react-specialist - React 18+ 최신 패턴 전문가
• rust-engineer - 시스템 프로그래밍 전문가
• spring-boot-engineer - Spring Boot 3+ 마이크로서비스 전문가
• sql-pro - 데이터베이스 쿼리 전문가
• swift-expert - iOS 및 macOS 전문가
• typescript-pro - TypeScript 전문가
• vue-expert - Vue 3 Composition API 전문가

03. Infrastructure

DevOps, 클라우드 및 배포 전문가.

• azure-infra-engineer - Azure 인프라 및 Az PowerShell 자동화 전문가
• cloud-architect - AWS/GCP/Azure 전문가
• database-administrator - 데이터베이스 관리 전문가
• deployment-engineer - 배포 자동화 전문가
• devops-engineer - CI/CD 및 자동화 전문가
• devops-incident-responder - DevOps 사고 관리
• docker-expert - Docker 컨테이너화 및 최적화 전문가
• incident-responder - 시스템 사고 대응 전문가
• kubernetes-specialist - 컨테이너 오케스트레이션 마스터
• network-engineer - 네트워크 인프라 전문가
• platform-engineer - 플랫폼 아키텍처 전문가
• security-engineer - 인프라 보안 전문가
• sre-engineer - 사이트 신뢰성 엔지니어링 전문가
• terraform-engineer - Infrastructure as Code 전문가
• terragrunt-expert - Terragrunt 오케스트레이션 및 DRY IaC 전문가
• windows-infra-admin - Active Directory, DNS, DHCP 및 GPO 자동화 전문가

04. Quality & Security — 테스트, 보안 및 코드 품질 전문가(20개 에이전트)

04. Quality & Security

• accessibility-tester - A11y 규정 준수 전문가
• ad-security-reviewer - Active Directory 보안 및 GPO 감사 전문가
• anti-ui-slop-reviewer - 제품별 UI 마감 게이트 리뷰어
• ai-writing-auditor - AI 작성 패턴 감사 및 재작성 전문가
• architect-reviewer - 아키텍처 리뷰 전문가
• browser-debugger - 브라우저 기반 재현 및 클라이언트 디버깅
• chaos-engineer - 시스템 복원력 테스트 전문가
• code-reviewer - 코드 품질 수호자
• compliance-auditor - 규제 준수 전문가
• debugger - 고급 디버깅 전문가
• error-detective - 오류 분석 및 해결 전문가
• gdpr-ccpa-compliance - GDPR 및 CCPA 개인정보 보호 준수 전문가
• penetration-tester - 윤리적 해킹 전문가
• performance-engineer - 성능 최적화 전문가
• powershell-security-hardening - PowerShell 보안 강화 및 규정 준수 전문가
• qa-expert - 테스트 자동화 전문가
• reviewer - 정확성, 보안 및 회귀에 대한 PR 스타일 리뷰
• security-auditor - 보안 취약점 전문가
• test-automator - 테스트 자동화 프레임워크 전문가
• ui-ux-tester - 철저한 UI/UX 기능 테스트 전문가

05. Data & AI — 데이터 엔지니어링, ML 및 AI 전문가(14개 에이전트)

05. Data & AI

• ai-engineer - AI 시스템 설계 및 배포 전문가
• azure-databricks-platform-architect - Azure Databricks 플랫폼 및 lakehouse 아키텍트
• data-analyst - 데이터 인사이트 및 시각화 전문가
• data-engineer - 데이터 파이프라인 아키텍트
• data-scientist - 분석 및 인사이트 전문가
• database-optimizer - 데이터베이스 성능 전문가
• llm-architect - 대규모 언어 모델 아키텍트
• machine-learning-engineer - 머신러닝 시스템 전문가
• ml-engineer - 머신러닝 전문가
• mlops-engineer - MLOps 및 모델 배포 전문가
• nlp-engineer - 자연어 처리 전문가
• postgres-pro - PostgreSQL 데이터베이스 전문가
• prompt-engineer - 프롬프트 최적화 전문가
• reinforcement-learning-engineer - 강화 학습 및 의사결정 시스템 전문가

06. Developer Experience — 도구 및 개발자 생산성 전문가(14개 에이전트)

06. Developer Experience

• build-engineer - 빌드 시스템 전문가
• cli-developer - 명령줄 도구 제작자
• dependency-manager - 패키지 및 종속성 전문가
• documentation-engineer - 기술 문서 전문가
• dx-optimizer - 개발자 경험 최적화 전문가
• git-workflow-manager - Git 워크플로 및 브랜치 전문가
• legacy-modernizer - 레거시 코드 현대화 전문가
• mcp-developer - Model Context Protocol 전문가
• powershell-module-architect - PowerShell 모듈 및 프로필 아키텍처 전문가
• powershell-ui-architect - WinForms, WPF, Metro 프레임워크 및 TUI용 PowerShell UI/UX 전문가
• readme-generator - 환각 없는, 유지 관리자가 바로 쓸 수 있는 README 생성기
• refactoring-specialist - 코드 리팩토링 전문가
• slack-expert - Slack 플랫폼 및 @slack/bolt 전문가
• tooling-engineer - 개발자 도구 전문가

07. Specialized Domains — 도메인별 기술 전문가(14개 에이전트)

07. Specialized Domains

• api-documenter - API 문서 전문가
• blockchain-developer - Web3 및 암호화 전문가
• embedded-systems - 임베디드 및 실시간 시스템 전문가
• fintech-engineer - 금융 기술 전문가
• game-developer - 게임 개발 전문가
• healthcare-admin - 의료 행정, 수익 주기 및 규정 준수 전문가
• hipaa-compliance - 의료 SaaS 벤더를 위한 HIPAA 규정 준수 전문가
• iot-engineer - IoT 시스템 개발자
• m365-admin - Microsoft 365, Exchange Online, Teams 및 SharePoint 관리 전문가
• mobile-app-developer - 모바일 애플리케이션 전문가
• payment-integration - 결제 시스템 전문가
• quant-analyst - 정량 분석 전문가
• risk-manager - 위험 평가 및 관리 전문가
• seo-specialist - 검색 엔진 최적화 전문가

08. Business & Product — 제품 관리 및 비즈니스 분석(17개 에이전트)

08. Business & Product

• assumption-mapping - 제품 가설 위험 및 검증 전문가
• backlog-grooming - 애자일 백로그 정비 전문가
• business-analyst - 요구사항 전문가
• content-marketer - 콘텐츠 마케팅 전문가
• content-quality-editor - AI 콘텐츠 품질 및 인간화 전문가
• customer-success-manager - 고객 성공 전문가
• growth-loops - 성장 루프 및 PLG 메커니즘 전문가
• legal-advisor - 법무 및 규정 준수 전문가
• license-engineer - 소프트웨어 라이선스 및 규정 준수 시스템 전문가
• product-manager - 제품 전략 전문가
• project-manager - 프로젝트 관리 전문가
• resume-refiner - 이력서, CV 및 LinkedIn 프로필 최적화 전문가
• sales-engineer - 기술 영업 전문가
• scrum-master - 애자일 방법론 전문가
• technical-writer - 기술 문서 전문가
• ux-researcher - 사용자 조사 전문가
• wordpress-master - WordPress 개발 및 최적화 전문가

09. Meta & Orchestration — 에이전트 조정 및 메타 프로그래밍(12개 에이전트)

09. Meta & Orchestration

• agent-installer - GitHub를 통해 이 저장소의 에이전트를 찾아 설치
• agent-organizer - 멀티 에이전트 코디네이터
• codebase-orchestrator - 승인 게이트가 있는 저장소 전체 리팩토링 거버넌스
• context-manager - 컨텍스트 최적화 전문가
• error-coordinator - 오류 처리 및 복구 전문가
• it-ops-orchestrator - IT 운영 워크플로 오케스트레이션 전문가
• knowledge-synthesizer - 지식 집계 전문가
• multi-agent-coordinator - 고급 멀티 에이전트 오케스트레이션
• performance-monitor - 에이전트 성능 최적화
• pied-piper - 반복적인 SDLC 워크플로를 위해 AI 서브에이전트 팀을 오케스트레이션
• task-distributor - 작업 할당 전문가
• workflow-orchestrator - 복잡한 워크플로 자동화

10. Research & Analysis — 연구, 검색 및 분석 전문가(12개 에이전트)

10. Research & Analysis

• ab-test-analysis - A/B 테스트 해석 및 출시/미출시 결정
• cohort-analysis - 리텐션, 코호트 행동 및 활성화 지표 분석
• competitive-analyst - 경쟁 인텔리전스 전문가
• data-researcher - 데이터 발견 및 분석 전문가
• docs-researcher - 문서 기반 API 및 프레임워크 검증
• first-principles-thinking - 가정을 의심하고 제일 원리로 문제 해결
• market-researcher - 시장 분석 및 소비자 인사이트
• project-idea-validator - 가혹한 아이디어 압박 테스트 및 go/no-go 전략가
• research-analyst - 종합 연구 전문가
• scientific-literature-researcher - 출판된 과학 연구에 기반한 증거 중심 연구
• search-specialist - 고급 정보 검색 전문가
• trend-analyst - 신흥 트렌드 및 예측 전문가

11. AI Governance & Safety - 거버넌스, 가드레일 및 신뢰할 수 있는 AI 전문가(4개 에이전트)

11. AI Governance & Safety

• ai-governance-auditor - AI 거버넌스 통제 및 배포 준비도 리뷰어
• model-risk-manager - 모델 실패 모드 우선순위 지정 및 완화 전문가
• policy-guardrail-designer - 프롬프트, 도구 및 워크플로 가드레일 설계자
• responsible-ai-reviewer - 공정성, 오용, 투명성 및 감독 리뷰어

12. Platform Engineering & IDP - 내부 개발자 플랫폼 및 골든 패스 전문가(4개 에이전트)

12. Platform Engineering & IDP

• backstage-specialist - Backstage 카탈로그, 템플릿 및 포털 전문가
• golden-path-designer - 견고한 셀프 서비스 워크플로 설계자
• idp-architect - 내부 개발자 플랫폼 아키텍처 전문가
• platform-product-manager - 플랫폼 로드맵, 도입 및 성공 지표 전문가

13. LLMOps, Evals & Observability - 프로덕션 AI 품질 및 런타임 가시성 전문가(4개 에이전트)

13. LLMOps, Evals & Observability

• ai-observability-engineer - AI 네이티브 추적, 지표 및 로깅 전문가
• eval-engineer - 프롬프트, 도구 및 워크플로 평가 전문가
• hallucination-investigator - 사실성 및 컨텍스트 붕괴 근본 원인 조사자
• prompt-regression-tester - AI 동작 변화에 대한 회귀 스위트 설계자

서브에이전트 이해하기

서브에이전트는 작업별 전문 지식을 제공하여 Codex의 기능을 강화하는 전문 AI 어시스턴트입니다. 이들은 Codex가 특정 유형의 작업에 직면했을 때 호출할 수 있는 전담 도우미 역할을 합니다.

서브에이전트의 특별한 점

독립적인 컨텍스트 창 각 서브에이전트는 자체 격리된 컨텍스트 공간에서 작동하여 서로 다른 작업 간의 교차 오염을 방지하고 주 대화 스레드의 명확성을 유지합니다.

도메인별 지능 서브에이전트는 해당 전문 분야를 위해 정성껏 작성된 지침을 갖추고 있어 전문 작업에서 탁월한 성능을 발휘합니다.

프로젝트 간 공유 서브에이전트를 만든 후에는 다양한 프로젝트에서 활용하고 팀 구성원에게 배포하여 일관된 개발 관행을 보장할 수 있습니다.

명시적 위임 Codex는 서브에이전트를 자동으로 생성하지 않습니다. 어떤 에이전트를 시작할지, 작업을 어떻게 나눌지, 결과의 형태가 무엇인지 명시적으로 지정하는 위임 프롬프트를 사용하세요.

핵심 장점

• 메모리 효율성: 격리된 컨텍스트는 주 대화가 작업별 세부 정보로 어지러워지는 것을 방지합니다
• 향상된 정확도: 전문화된 프롬프트와 구성은 특정 도메인에서 더 나은 결과를 제공합니다
• 워크플로 일관성: 팀 전체 서브에이전트 공유는 공통 작업에统一的된 접근을 보장합니다
• Codex 네이티브: 공식 Codex 서브에이전트 문서와 일치하는 .toml 에이전트 파일을 사용합니다

워크플로 예시

PR 리뷰 워크플로:

Review this branch with parallel subagents. Have reviewer look for correctness, security, and missing tests. Have docs_researcher verify the framework APIs this patch depends on. Wait for both and summarize the findings with file references.

버그 조사 워크플로:

Investigate the broken settings flow. Have code_mapper trace the owning code paths, browser_debugger reproduce the bug in the browser, and frontend_developer propose the smallest fix after the failure is understood. Wait for the read-heavy agents first, then continue.

저장소 탐색 및 계획 워크플로:

Use search_specialist to locate the code related to payment retries, knowledge_synthesizer to summarize the current design, and refactoring_specialist to propose a minimal refactor plan. Return a concrete action list.

AI Design + Build 생태계 도구

당신은 AI로 제품을 출시하지만, 아무도 그에 대해 게시하지 않아 모든 출시가 조용히 사라집니다. EveryFeed는 당신의 AI 어시스턴트를 소셜 작업 공간에 연결하여 35개 이상의 채널에 초안 작성, 일정 예약 및 게시를 수행합니다 — 대행사도, 마케팅 채용도 필요 없습니다.

기여

기여를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조하세요.

• PR을 통해 새로운 서브에이전트 제출
• 기존 정의 개선
• 문제 및 버그 보고

라이선스

MIT License - LICENSE 참조

이 저장소는 유지 관리자와 커뮤니티가 모두 기여한 서브에이전트 정의의 큐레이션된 컬렉션입니다. 모든 서브에이전트는 보증 없이 “있는 그대로” 제공됩니다. 당사는 어떤 서브에이전트의 보안이나 정확성도 감사하거나 보장하지 않습니다. 사용 전에 검토하세요. 유지 관리자는 사용으로 인해 발생하는 어떤 문제에 대해서도 책임을 지지 않습니다.

나열된 서브에이전트에 문제가 있거나 기여를 제거하고 싶다면 이 저장소에 issue를 열어 주시면 신속하게 처리하겠습니다.