triflux AGENTS.md

triflux — Codex 가이드

상세 운영 지시는 CLAUDE.md에 있습니다. Codex는 @import를 지원하지 않으므로 필요할 때 직접 읽습니다.

핵심 규칙 (triflux 환경 특화)

• Codex 직접 호출 금지 — headless-guard가 차단한다. tfx-auto --cli codex / tfx-multi / tfx-swarm을 거친다.
• 프롬프트는 -- 뒤의 인자로 넘기고 표준 입력은 닫는다(… -- "$prompt" < /dev/null). codex < prompt.md는 비대화식 실행이라 실패한다.
• config.toml에 approval_mode, sandbox 기본값을 두고 CLI는 --profile만 지정한다. 중복 플래그를 쓰지 않는다.
• Claude가 작성한 코드는 Codex로 교차 검증한다. 스스로 승인하지 않는다.
• 비대화식 결과는 작업 알림이 완료된 뒤에만 읽는다.

비대화식 실행 보호기(headless-guard)

• codex exec / agy --dangerously-skip-permissions --print= 직접 호출은 차단됩니다.
• 반드시 tfx 스킬인 tfx-auto --cli codex, tfx-multi, tfx-swarm을 거친다.

추론 수준 예외 경로

• 기본 역할 라우팅은 low/medium/high/xhigh 프로필을 유지합니다.
• 최난도 단일 작업만 TFX_CODEX_PROFILE=max (gpt56_sol_max).
• ultra는 최상위 단독 deep-executor/scientist-deep에서만 허용하고, 팀·비대화식·워커 내부의 ultra 요청은 중첩 분산 실행을 막기 위해 gpt56_sol_max로 낮춥니다.
• --retry auto-escalate의 Codex 단계도 gpt56_sol_max입니다.

비대화식 결과 회수

• 완료 마커: === HEADLESS_COMPLETE succeeded=N failed=N total=N ===
• 워커 상세: $TMPDIR/tfx-headless/{sessionName}-worker-N.txt

SSH 방식

• hosts.json의 os 필드로 셸을 판단합니다 (windows=PowerShell, darwin=zsh, linux=bash).
• SSH 너머로 Codex를 직접 실행하지 않는다(config.toml 충돌과 TTY 문제). 원격에서 Codex가 필요하면 tfx-remote → Claude Code → Claude가 내부에서 codex 호출.

작업 합의

• 한국어 우선, 기술 용어는 원어 유지.
• 커밋: Type: 한국어 설명 (50자 이내). Co-Authored-By와 AI 꼬리표를 넣지 않는다.
• 변경 후 린트·타입 검사·테스트를 실행한다. 비밀 정보(API 키·토큰·세션)를 하드코딩하지 않는다.
• safety-guard에 새 차단 규칙을 추가할 때는 항상 대안 API를 함께 만든다. 차단만 추가하면 교착 상태가 된다.

CTO 기준 방향

• .triflux/lake/current.md는 에이전트 간 기준 방향 요약입니다. 정렬을 위해 읽되 새 작업으로 취급하지 않습니다.
• 프로그램용 정본은 tfx cto status --json입니다. 안정 키는 schema_version, repo, sources, ledger_tail, live_sessions, active_shards입니다.
• 읽기 전용 정렬 문맥입니다.