triflux 0.0.1 → 2.0.1

package/skills/tfx-codex/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: tfx-codex
+description: Codex-Only 오케스트레이터. tfx-auto 워크플로우를 Codex 전용으로 고정합니다.
+triggers:
+  - tfx-codex
+argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
+---
+
+# tfx-codex — Codex-Only 오케스트레이터
+
+> Codex CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
+> Gemini CLI가 없는 환경에서 사용합니다.
+
+## 사용법
+
+```
+/tfx-codex "작업 설명"
+/tfx-codex N:codex "작업 설명"
+```
+
+## 동작 원리
+
+`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=codex` 환경변수를 설정하여
+모든 Gemini 에이전트(designer, writer)를 Codex로 리매핑합니다.
+
+### 에이전트 라우팅
+
+| 에이전트 | 원래 CLI | tfx-codex에서 |
+|----------|---------|-------------|
+| executor, build-fixer, debugger | Codex | Codex (변경 없음) |
+| architect, planner, critic, analyst | Codex | Codex (변경 없음) |
+| code-reviewer, security-reviewer | Codex | Codex (변경 없음) |
+| scientist, document-specialist | Codex | Codex (변경 없음) |
+| **designer** | ~~Gemini~~ | **Codex** (effort: high) — UI 코드 생성 |
+| **writer** | ~~Gemini~~ | **Codex Spark** (effort: spark_fast) — 경량 문서 |
+| explore | Claude Haiku | Claude Haiku (변경 없음) |
+| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
+
+## 실행 규칙
+
+**tfx-auto SKILL.md의 모든 Phase(1~6) 워크플로우를 그대로 따릅니다.**
+
+유일한 차이점:
+
+1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=codex`를 환경변수로 전달:
+   ```bash
+   TFX_CLI_MODE=codex bash ~/.claude/scripts/cli-route.sh {agent} '{prompt}' {mcp_profile}
+   ```
+
+2. **Phase 2 트리아지에서** gemini 분류 결과를 codex로 강제 변환:
+   - Codex 분류가 `gemini`를 반환하면 → `codex`로 교체
+   - Opus 분해에서 designer/writer → Codex 에이전트 + implement/analyze MCP 프로필
+
+3. **MCP 프로필 조정**:
+   - designer: `implement` (코드 기반 UI 작업)
+   - writer: `analyze` (문서 기반 리서치+작성)
+
+## 필수 조건
+
+- [Codex CLI](https://github.com/openai/codex): `npm install -g @openai/codex`
+- Gemini CLI 불필요

package/skills/tfx-gemini/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: tfx-gemini
+description: Gemini-Only 오케스트레이터. tfx-auto 워크플로우를 Gemini 전용으로 고정합니다.
+triggers:
+  - tfx-gemini
+argument-hint: "\"작업 설명\" | N:gemini \"작업 설명\""
+---
+
+# tfx-gemini — Gemini-Only 오케스트레이터
+
+> Gemini CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
+> Codex CLI가 없는 환경에서 사용합니다.
+
+## 사용법
+
+```
+/tfx-gemini "작업 설명"
+/tfx-gemini N:gemini "작업 설명"
+```
+
+## 동작 원리
+
+`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=gemini` 환경변수를 설정하여
+모든 Codex 에이전트를 Gemini로 리매핑합니다.
+
+### 에이전트 라우팅
+
+| 에이전트 | 원래 CLI | tfx-gemini에서 |
+|----------|---------|--------------|
+| **executor, debugger, deep-executor** | ~~Codex~~ | **Gemini Pro** |
+| **build-fixer** | ~~Codex~~ | **Gemini Flash** |
+| **architect, planner, critic, analyst** | ~~Codex~~ | **Gemini Pro** |
+| **code-reviewer, security-reviewer, quality-reviewer** | ~~Codex~~ | **Gemini Pro** |
+| **scientist, scientist-deep** | ~~Codex~~ | **Gemini Pro/Flash** |
+| **document-specialist** | ~~Codex~~ | **Gemini Flash** |
+| designer | Gemini | Gemini (변경 없음) |
+| writer | Gemini | Gemini (변경 없음) |
+| explore | Claude Haiku | Claude Haiku (변경 없음) |
+| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
+
+### 모델 분기
+
+| 복잡도 | Gemini 모델 | 대상 에이전트 | 근거 |
+|--------|------------|-------------|------|
+| 높음 | `gemini-3.1-pro-preview` | executor, debugger, deep-executor | 구현/분석 깊이 필요 |
+| 높음 | `gemini-3.1-pro-preview` | architect, planner, critic, analyst | 설계 품질 |
+| 높음 | `gemini-3.1-pro-preview` | code-reviewer, security-reviewer, quality-reviewer | 리뷰 품질 |
+| 높음 | `gemini-3.1-pro-preview` | scientist-deep | 심층 리서치 |
+| 낮음 | `gemini-3-flash-preview` | build-fixer, spark | 빠른 수정/린트 |
+| 낮음 | `gemini-3-flash-preview` | scientist, document-specialist | 일반 검색+요약 |
+| 낮음 | `gemini-3-flash-preview` | writer | 문서/가이드 생성 |
+
+## 실행 규칙
+
+**tfx-auto SKILL.md의 모든 Phase(1~6) 워크플로우를 그대로 따릅니다.**
+
+유일한 차이점:
+
+1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=gemini`을 환경변수로 전달:
+   ```bash
+   TFX_CLI_MODE=gemini bash ~/.claude/scripts/cli-route.sh {agent} '{prompt}' {mcp_profile}
+   ```
+
+2. **Phase 2 트리아지에서** codex 분류 결과를 gemini로 강제 변환:
+   - Codex 분류가 `codex`를 반환하면 → `gemini`로 교체
+   - Opus 분해에서 모든 Codex 에이전트 → Gemini 모델 매핑
+
+3. **Phase 2a Codex 분류 단계를 건너뜀**:
+   - Codex CLI가 없으므로 Opus가 직접 분류+분해 수행
+
+4. **Windows 안정화 자동 적용**:
+   - 모든 Gemini 워커에 `--timeout 60` + health check
+   - hang 감지 시 자동 재시도
+
+## 필수 조건
+
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli): `npm install -g @google/gemini-cli`
+- Codex CLI 불필요

package/skills/tfx-setup/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: tfx-setup
+description: triflux 초기 설정 및 진단을 수행합니다.
+triggers:
+  - tfx-setup
+argument-hint: "[doctor]"
+---
+
+# tfx-setup — triflux 초기 설정 및 진단
+
+> 설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
+
+## 사용법
+
+```
+/tfx-setup
+/tfx-setup doctor    ← 진단만 실행
+```
+
+## 동작
+
+### 기본 모드 (`/tfx-setup`)
+
+1. **파일 동기화** — `triflux setup` 실행
+2. **HUD 설정** — `settings.json`에 statusLine 자동 등록
+3. **CLI 진단** — `triflux doctor` 실행
+4. **결과 보고** — 설정 상태 요약
+
+### 진단 모드 (`/tfx-setup doctor`)
+
+`triflux doctor`만 실행하고 결과를 보고합니다.
+
+## 실행 방법
+
+### Step 1: 파일 동기화
+
+```bash
+Bash("triflux setup")
+```
+
+### Step 2: HUD 설정 확인 및 적용
+
+`~/.claude/settings.json`을 읽어 `statusLine` 설정을 확인합니다.
+
+**statusLine이 없거나 hud-qos-status.mjs를 가리키지 않는 경우:**
+
+```javascript
+// settings.json에 추가할 statusLine 설정
+{
+  "statusLine": {
+    "type": "command",
+    "command": "\"<NODE_PATH>\" \"<HOME>/.claude/hud/hud-qos-status.mjs\""
+  }
+}
+```
+
+- `<NODE_PATH>`: `node -e "console.log(process.execPath)"` 결과
+- `<HOME>`: `~` 또는 홈 디렉토리 절대 경로
+- Windows: 경로에 공백이 있으면 큰따옴표로 감싸기
+- **기존 statusLine이 있으면 덮어쓰기 전 사용자에게 확인**
+
+Read 도구로 `~/.claude/settings.json`을 읽고, Edit 도구로 statusLine을 추가/수정합니다.
+
+### Step 3: CLI 진단
+
+```bash
+Bash("triflux doctor")
+```
+
+### Step 4: 결과 보고
+
+```markdown
+## tfx-setup 완료
+
+| 항목 | 상태 |
+|------|------|
+| cli-route.sh | ✅ v1.5 |
+| HUD (hud-qos-status.mjs) | ✅ v1.7 |
+| HUD 설정 (settings.json) | ✅ statusLine 등록됨 |
+| Codex CLI | ✅ / ⚠️ 미설치 (선택) |
+| Gemini CLI | ✅ / ⚠️ 미설치 (선택) |
+| 스킬 | ✅ N개 설치됨 |
+
+### 다음 단계
+- Codex 미설치 시: `npm install -g @openai/codex`
+- Gemini 미설치 시: `npm install -g @google/gemini-cli`
+- 세션 재시작하면 HUD가 표시됩니다
+```
+
+## 에러 처리
+
+| 상황 | 처리 |
+|------|------|
+| `triflux: command not found` | `npm install -g triflux` 안내 |
+| `settings.json` 파싱 실패 | 백업 생성 후 새로 작성 |
+| 기존 statusLine이 다른 HUD | 사용자에게 덮어쓸지 확인 |
+| node.exe 경로에 공백 | 큰따옴표로 감싸기 |

package/skills/verify-implementation/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: verify-implementation
+description: 프로젝트의 모든 verify 스킬을 순차 실행하여 통합 검증 보고서를 생성합니다. 기능 구현 후, PR 전, 코드 리뷰 시 사용.
+disable-model-invocation: true
+argument-hint: "[선택사항: 특정 verify 스킬 이름]"
+---
+
+# verify-implementation — 통합 구현 검증
+
+## 목적
+
+프로젝트에 등록된 모든 `verify-*` 스킬을 순차적으로 실행하여 통합 검증을 수행합니다:
+
+- 각 스킬의 Workflow에 정의된 검사를 실행
+- 각 스킬의 Exceptions를 참조하여 false positive 방지
+- 발견된 이슈에 대해 수정 방법을 제시
+- 사용자 승인 후 수정 적용 및 재검증
+
+## OMC 호환
+
+이 스킬은 OMC 파이프라인에서 **team-verify 단계의 보완 도구**로 사용 가능합니다:
+
+- **실행 순서 권장**: `/verify-implementation` (프로젝트 규칙) → OMC `verifier` (일반 품질)
+- **MCP-First 연동**: 이슈 리포트를 `ask_codex`(code-reviewer)에 전달하여 심층 리뷰 가능
+- OMC `quality-reviewer`, `security-reviewer`는 **범용** → verify 스킬은 **프로젝트 고유 규칙** 검증
+- OMC `/code-review`와 결합 시 프로젝트 규칙 + 범용 품질을 한 번에 확인
+
+## 실행 시점
+
+- 새로운 기능을 구현한 후
+- Pull Request를 생성하기 전
+- 코드 리뷰 중
+- 코드베이스 규칙 준수 여부를 감사할 때
+
+## 실행 대상 스킬
+
+이 스킬이 순차 실행하는 검증 스킬 목록입니다. `/manage-skills`가 스킬을 생성/삭제할 때 이 목록을 자동 업데이트합니다.
+
+(아직 등록된 검증 스킬이 없습니다)
+
+<!-- 스킬이 추가되면 아래 형식으로 등록:
+| # | 스킬 | 설명 |
+|---|------|------|
+| 1 | `verify-example` | 예시 검증 설명 |
+-->
+
+## 워크플로우
+
+### Step 1: 소개
+
+**실행 대상 스킬** 테이블을 확인합니다. 선택적 인수가 있으면 해당 스킬만 필터링합니다.
+
+**등록된 스킬이 0개인 경우:**
+
+```markdown
+## 구현 검증
+
+검증 스킬이 없습니다. `/manage-skills`를 실행하여 프로젝트에 맞는 검증 스킬을 생성하세요.
+```
+
+### Step 2: 순차 실행
+
+각 스킬에 대해:
+
+1. `.claude/skills/verify-<name>/SKILL.md`를 읽고 Workflow/Exceptions/Related Files 파싱
+2. Workflow의 각 검사를 순서대로 실행 (Grep, Glob, Read, Bash)
+3. 탐지 결과를 PASS/FAIL 기준에 대조
+4. Exceptions에 해당하면 면제 처리
+5. FAIL이면 이슈 기록 (파일 경로, 라인 번호, 문제, 수정 방법)
+
+```markdown
+### verify-<name> 검증 완료
+
+- 검사 항목: N개
+- 통과: X개
+- 이슈: Y개
+- 면제: Z개
+```
+
+### Step 3: 통합 보고서
+
+```markdown
+## 구현 검증 보고서
+
+### 요약
+
+| 검증 스킬 | 상태 | 이슈 수 |
+|-----------|------|---------|
+| verify-<name1> | PASS / X개 이슈 | N |
+| verify-<name2> | PASS / X개 이슈 | N |
+
+**발견된 총 이슈: X개**
+```
+
+**이슈 발견 시:**
+
+```markdown
+### 발견된 이슈
+
+| # | 스킬 | 파일 | 문제 | 수정 방법 |
+|---|------|------|------|-----------|
+| 1 | verify-<name> | `path:42` | 문제 설명 | 수정 코드 |
+```
+
+### Step 4: 사용자 액션 확인
+
+`AskUserQuestion`으로 확인:
+1. **전체 수정** — 모든 권장 수정사항 자동 적용
+2. **개별 수정** — 각 수정사항 하나씩 검토
+3. **건너뛰기** — 변경 없이 종료
+
+### Step 5: 수정 적용
+
+사용자 선택에 따라 수정 적용 + 진행 상황 표시.
+
+### Step 6: 수정 후 재검증
+
+이슈가 있었던 스킬만 재실행하여 Before/After 비교:
+
+```markdown
+| 검증 스킬 | 수정 전 | 수정 후 |
+|-----------|---------|---------|
+| verify-<name> | X개 이슈 | PASS |
+```
+
+## 예외사항
+
+1. **등록된 스킬이 없는 프로젝트** — 안내 메시지 표시 후 종료
+2. **스킬 자체적 예외** — 각 verify 스킬의 Exceptions에 정의된 패턴은 이슈 아님
+3. **verify-implementation 자체** — 실행 대상에 자기 자신 미포함
+4. **manage-skills** — `verify-`로 시작하지 않으므로 실행 대상 아님
+
+## 관련 파일
+
+| File | Purpose |
+|------|---------|
+| `.claude/skills/manage-skills/SKILL.md` | 스킬 유지보수 |
+| `CLAUDE.md` | 프로젝트 지침 |