tfx-codex-swarmlisted
Install: claude install-skill genusarvicolabathos238/triflux
# tfx-codex-swarm — Codex 다중 세션 스폰 오케스트레이터
> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
> PRD/태스크 파일 N개를 각각 독립 worktree + psmux 세션으로 Codex full-auto 실행.
> AskUserQuestion 기반 인터랙티브 설정. 미지정 시 하네스가 자동 판단.
## 전제 조건
- **`tfx-psmux-rules` 스킬 필수** — psmux 명령/런처 생성 시 이 스킬의 규칙을 반드시 준수
- `codex` CLI 설치됨 (0.117.0+)
- `psmux` 설치됨 (세션 관리)
- `git` (worktree 생성)
- Windows Terminal (`wt.exe` 패인 기반 attach)
- MCP 싱글톤 데몬 (`supergateway` + `mcp-remote`) — 선택적이나 스웜 시 강력 권장
## 설정
| 설정 | 기본값 | 설명 |
|------|--------|------|
| MAX_CONCURRENCY | 4 | 동시 실행 세션 수. 초과분은 큐 대기 후 순차 시작 |
| WT_ATTACH_MODE | attach | `attach`: split-pane 직접 attach (기본). `dashboard`: 모니터링 탭만 |
| MCP_DAEMON_REQUIRED | true | MCP 싱글톤 데몬 사전 확인 필수. false면 세션별 MCP 직접 스폰 (비권장) |
사용자가 명시하지 않으면 기본값 사용. AskUserQuestion으로 오버라이드 가능.
## 워크플로우
### Step 1: 태스크 파일 스캔
아래 경로를 순서대로 스캔하여 PRD/태스크 파일을 수집한다:
```
.omx/plans/*.md
.omc/plans/*.md
docs/prd/*.md
```
사용자가 경로를 명시했으면 해당 경로만 스캔.
파일이 0개면 → "태스크 파일을 찾을 수 없습니다" 보고 후 종료.
### Step 2: 태스크 선택
**사용자가 명시적��로 파일을 지정한 경우** → 바로 Step 3.
**미지정인 경우** → AskUserQuestion:
```
question: "어떤 태스크를 실행하시겠습니까?"
header: "태스크 선택"
options:
- label: "전체 실행 ({N}개)"
description: "스캔된 모든 태스크를 병렬 실행"
- label: "선택 실행"
description: "실행할 태스크를 하나��� 선택"
- label: "최근 변경된 것만"
description: "최근 24시간 내 수정된 태스���만 실행"
```
"선택 실행" 선택 시 → 파일 목록을 AskUserQuestion으로 하나씩 표시:
```
question: "이 태스크를 포함하시겠습니까