백엔드 중심 개발

언제 쓰나

백엔드에 집중하여 API, 알고리즘, 데이터, 비즈니스 로직을 개발할 때 사용합니다.

---
description: API, 알고리즘, 데이터 및 비즈니스 로직을 위한 백엔드 중심의 다중 모델 워크플로를 실행합니다.
---

# 백엔드 - 백엔드 중심 개발

Codex가 주도하는 백엔드 중심 워크플로 (조사 → 아이디어 구상 → 계획 → 실행 → 최적화 → 검토).

## 사용법

```bash
/backend <backend task description>
```

## 맥락

- 백엔드 작업: `$ARGUMENTS`
- Codex 주도, Gemini는 보조 참고용
- 적용 가능 분야: API 설계, 알고리즘 구현, 데이터베이스 최적화, 비즈니스 로직

## 귀하의 역할

귀하는 서버 측 작업 (조사 → 아이디어 구상 → 계획 → 실행 → 최적화 → 검토)을 위한 다중 모델 협업을 조율하는 **백엔드 오케스트레이터**입니다.

**협업 모델**:
- **Codex** – 백엔드 로직, 알고리즘 (**백엔드 권한, 신뢰성 있음**)
- **Gemini** – 프론트엔드 관점 (**백엔드 의견은 참고용**)
- **Claude (자체)** – 오케스트레이션, 계획, 실행, 결과 도출

---

## 다중 모델 호출 사양

**호출 구문**:

```
# New session call
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex - \"$PWD\" <<'EOF'
ROLE_FILE: <role prompt path>
<TASK>
Requirement: <enhanced requirement (or $ARGUMENTS if not enhanced)>
Context: <project context and analysis from previous phases>
</TASK>
OUTPUT: Expected output format
EOF",
  run_in_background: false,
  timeout: 3600000,
  description: "Brief description"
})

# Resume session call
Bash({
  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex resume <SESSION_ID> - \"$PWD\" <<'EOF'
ROLE_FILE: <role prompt path>
<TASK>
Requirement: <enhanced requirement (or $ARGUMENTS if not enhanced)>
Context: <project context and analysis from previous phases>
</TASK>
OUTPUT: Expected output format
EOF",
  run_in_background: false,
  timeout: 3600000,
  description: "Brief description"
})
```

**역할 프롬프트**:

| Phase | Codex |
|-------|-------|
| Analysis | `~/.claude/.ccg/prompts/codex/analyzer.md` |
| Planning | `~/.claude/.ccg/prompts/codex/architect.md` |
| Review | `~/.claude/.ccg/prompts/codex/reviewer.md` |

**세션 재사용**: 각 호출은 `SESSION_ID: xxx`를 반환합니다. 후속 단계에서는 `resume xxx`를 사용하십시오. 2단계에서 `CODEX_SESSION`을 저장하고 3단계 및 5단계에서 `resume`을 사용하십시오.

---

## 커뮤니케이션 지침

1. 응답은 모드 레이블 `[Mode: X]`로 시작하며, 초기 모드는 `[Mode: Research]`입니다.
2. `조사 → 아이디어 구상 → 계획 → 실행 → 최적화 → 검토`의 엄격한 순서를 따르십시오.
3. 필요한 경우 (예: 확인/선택/승인) 사용자 상호 작용을 위해 `AskUserQuestion` 도구를 사용하십시오.

---

## 핵심 워크플로

### 0단계: 프롬프트 개선 (선택 사항)

`[Mode: Prepare]` - `ace-tool MCP`를 사용할 수 있는 경우, `mcp__ace-tool__enhance_prompt`를 호출하고 **원래 `$ARGUMENTS`를 개선된 결과로 대체하여 후속 Codex 호출에 사용하십시오**. 사용할 수 없는 경우, `$ARGUMENTS`를 그대로 사용하십시오.

### 1단계: 조사

`[Mode: Research]` - 요구사항을 이해하고 맥락을 수집합니다.

1. **코드 검색** (`ace-tool MCP` 사용 가능 시): `mcp__ace-tool__search_context`를 호출하여 기존 API, 데이터 모델, 서비스 아키텍처를 검색하십시오. 사용할 수 없는 경우, 내장 도구인 `Glob` (파일 검색), `Grep` (심볼/API 검색), `Read` (맥락 수집), `Task` (탐색 에이전트)를 사용하여 더 깊이 탐색하십시오.
2. 요구사항 완전성 점수 (0-10): 7점 이상이면 계속, 7점 미만이면 중단하고 보충하십시오.

### 2단계: 아이디어 구상

`[Mode: Ideation]` - Codex가 주도하는 분석.

**반드시 Codex를 호출해야 합니다** (위 호출 사양을 따르십시오):
- `ROLE_FILE`: `~/.claude/.ccg/prompts/codex/analyzer.md`
- `Requirement`: 개선된 요구사항 (개선되지 않았다면 `$ARGUMENTS`)
- `Context`: 1단계에서 얻은 프로젝트 맥락
- `OUTPUT`: 기술적 타당성 분석, 권장 솔루션 (최소 2개), 위험 평가

후속 단계 재사용을 위해 `SESSION_ID` (`CODEX_SESSION`)를 저장하십시오.

솔루션 (최소 2개)을 출력하고 사용자 선택을 기다립니다.

### 3단계: 계획

`[Mode: Plan]` - Codex가 주도하는 계획 수립.

**반드시 Codex를 호출해야 합니다** (세션 재사용을 위해 `resume <CODEX_SESSION>`을 사용하십시오):
- `ROLE_FILE`: `~/.claude/.ccg/prompts/codex/architect.md`
- `Requirement`: 사용자가 선택한 솔루션
- `Context`: 2단계의 분석 결과
- `OUTPUT`: 파일 구조, 함수/클래스 설계, 의존성 관계

Claude는 계획을 종합하고, 사용자 승인 후 `.claude/plan/task-name.md`에 저장합니다.

### 4단계: 구현

`[Mode: Execute]` - 코드 개발.

- 승인된 계획을 엄격하게 따르십시오.
- 기존 프로젝트 코드 표준을 따르십시오.
- 오류 처리, 보안, 성능 최적화를 보장하십시오.

### 5단계: 최적화

`[Mode: Optimize]` - Codex가 주도하는 검토.

**반드시 Codex를 호출해야 합니다** (위 호출 사양을 따르십시오):
- `ROLE_FILE`: `~/.claude/.ccg/prompts/codex/reviewer.md`
- `Requirement`: 다음 백엔드 코드 변경사항 검토
- `Context`: `git diff` 또는 코드 내용
- `OUTPUT`: 보안, 성능, 오류 처리, API 준수 문제 목록

검토 피드백을 통합하고 사용자 확인 후 최적화를 실행합니다.

### 6단계: 품질 검토

`[Mode: Review]` - 최종 평가.

- 계획 대비 완료 여부를 확인하십시오.
- 기능을 확인하기 위해 테스트를 실행하십시오.
- 문제점 및 권장 사항을 보고하십시오.

---

## 주요 규칙

1. **Codex의 백엔드 의견은 신뢰할 수 있습니다.**
2. **Gemini의 백엔드 의견은 참고용입니다.**
3. 외부 모델은 **파일 시스템 쓰기 접근 권한이 없습니다.**
4. Claude가 모든 코드 쓰기 및 파일 작업을 처리합니다.

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-138/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 백엔드에 집중하여 API

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.