triflux 10.20.1 → 10.21.0

package/CLAUDE.md

@@ -0,0 +1,174 @@
+# triflux — Claude Code 운영 가이드
+
+<core-systems>
+## 핵심 스킬 시스템 (항상 인지)
+
+이 프로젝트는 3개의 스킬 시스템을 동시에 사용한다. 어떤 작업이든 해당 시스템의 스킬이 있는지 먼저 확인한다.
+
+| 시스템 | 접두사 | 용도 | 스킬 수 |
+|--------|--------|------|---------|
+| **triflux** | `/tfx-*` | CLI 라우팅, 멀티모델 오케스트레이션, 스웜, 원격 실행 | ~40개 |
+| **gstack** | `/` (접두사 없음) | QA, ship, investigate, design, review, checkpoint | ~35개 |
+| **omc** | `/oh-my-claudecode:*` | autopilot, ralph, team, ultrawork, ccg | ~25개 |
+
+스킬을 모르면 자연어 라우팅(`.claude/rules/tfx-routing.md`)으로 자동 매핑된다.
+세션 종료 전 메모리 파일이 3개+ 변경됐으면 `/memory-hygiene` 제안을 검토한다.
+</core-systems>
+
+<psmux-wt>
+## psmux/WT 규칙
+
+psmux 세션·WT 패인을 생성/조작/정리할 때 `tfx-psmux-rules` 스킬을 참조한다.
+WT 프리징 방지: exit → sleep 2 → kill 순서. 바로 kill하지 않는다.
+
+### wt.exe → wt-manager 경유
+
+safety-guard가 `wt.exe`, `wt new-tab`, `wt split-pane`, `Start-Process wt`를 차단한다.
+`hub/team/wt-manager.mjs`의 API를 사용한다.
+
+| 용도 | API |
+|------|-----|
+| 새 탭 | `createTab({ title, command, profile, cwd })` |
+| 패인 분할 | `splitPane({ direction: 'H'\|'V', title, command })` |
+| 다중 배치 | `applySplitLayout([{ title, command, direction }])` |
+| 탭 정리 | `closeTab(title)` / `closeStale({ olderThanMs, titlePattern })` |
+
+차단과 대안은 항상 쌍으로 존재해야 한다. 차단만 추가하고 대안을 안 만들면 데드락.
+
+### raw `psmux kill-session` → psmux wrapper 경유
+
+safety-guard가 raw `psmux kill-session`을 차단한다.
+세션 정리는 `hub/team/psmux.mjs` 공개 API 또는 internal wrapper로 우회한다.
+
+| 용도 | API / 래퍼 |
+|------|------------|
+| 세션 조회 | `listSessions({ filterTitle?, olderThanMs? })` |
+| title prefix / regex kill | `killSessionByTitle(titlePattern)` |
+| stale idle 세션 정리 | `pruneStale({ olderThanMs, dryRun })` |
+| Bash 훅 우회용 래퍼 | `node hub/team/psmux.mjs --internal kill-by-title <prefix\|/regex/>` |
+
+### psmux에서 Codex 실행
+
+| 방식 | 동작 | 이유 |
+|------|------|------|
+| `codex` (interactive) | 불가 | psmux에서 TTY를 못 잡음 |
+| `codex < prompt.md` | 불가 | "stdin is not a terminal" |
+| `codex exec "$(cat prompt.md)" -s danger-full-access --dangerously-bypass-approvals-and-sandbox` | 사용 | 유일한 안전 경로 |
+
+`codex exec`는 config.toml `approval_mode`를 무시하므로 `--dangerously-bypass-approvals-and-sandbox` 필수.
+`-s` 유효값: read-only, workspace-write, danger-full-access.
+</psmux-wt>
+
+<codex-config>
+## Codex config.toml
+
+config.toml에 이미 설정된 값은 CLI 플래그로 중복 지정하지 않는다.
+
+| config.toml에 있으면 | CLI에서 생략 |
+|---------------------|-------------|
+| `approval_mode = "auto"` | `-a`, `--full-auto` |
+| `sandbox = "workspace-write"` | `-s`, `--full-auto` |
+
+안전 패턴: config.toml에 기본값을 두고, CLI에서는 `--profile` 선택만 한다.
+</codex-config>
+
+<account-broker>
+## AccountBroker (계정 브로커)
+
+conductor, headless, swarm-hypervisor가 하나의 AccountBroker 싱글턴을 공유한다.
+
+| 항목 | 설명 |
+|------|------|
+| 계정별 CircuitBreaker | 장애 격리 — 한 계정 오류가 다른 계정에 전파되지 않음 |
+| busy 플래그 | 동일 계정 이중 임대(double-lease) 방지 |
+| `/broker/reload` | 장시간 세션 중 accounts.json 핫리로드. active lease ownership은 reload 후에도 보존 |
+| Adapter no-lease 정책 | headless adapter는 broker가 비활성/empty이면 기본 CLI auth path로 실행, broker가 enabled인데 lease가 없으면 `circuit_open` 실패 |
+| Conductor no-lease 정책 | 로컬 Conductor 세션은 `broker_no_lease`를 event log에 남기고 spawn은 계속 진행. accountId가 없으므로 release는 호출하지 않음 |
+| Public snapshot 정책 | `/broker/snapshot`과 dashboard는 `publicSnapshot()`만 사용. `env`, `authFile`, `profile`, `host`, 파일 경로, raw failure timestamp는 공개하지 않음 |
+| Diagnostic 이벤트 | `securityViolation`, `authSyncError`는 hub가 redacted warn 로그(`broker.security_violation`, `broker.auth_sync_error`)로 처리 |
+| EventEmitter 이벤트 | `lease`, `release`, `cooldown`, `tierFallback`, `circuitOpen`, `circuitClose`, `noAvailableAccounts` — HUD 연동용 |
+</account-broker>
+
+<remote>
+## 원격 실행
+
+### 스킬 구분
+
+| 스킬 | 대상 | 방식 |
+|------|------|------|
+| tfx-codex-swarm | 로컬 전용 | 로컬 worktree + psmux |
+| tfx-remote-spawn | Claude Code 원격 | SSH → Claude Code 세션 → 내부 tfx 라우팅 |
+
+codex를 SSH 너머로 직접 실행하지 않는다. config.toml 충돌 + TTY 문제.
+원격에서 codex가 필요하면: remote-spawn → Claude Code → Claude가 내부에서 codex 호출.
+
+### SSH 패턴
+
+hosts.json `os` 필드로 대상 셸을 판단한다. safety-guard도 이 필드를 참조.
+
+| 대상 OS | 셸 | 패턴 |
+|---------|-----|------|
+| windows | PowerShell | scp + `pwsh -File` 필수. `$var` → `$env:VAR`, `2>/dev/null` → `2>$null` |
+| darwin | zsh | 인라인 가능. brew PATH 주의 (`/opt/homebrew/bin`) |
+| linux | bash | 인라인 가능. 표준 POSIX |
+
+- `~` → `$HOME` 변환은 모든 OS 공통
+</remote>
+
+<headless-retrieval>
+## Headless 결과 회수
+
+background로 실행한 headless 결과는 **반드시 task-notification 완료 후** 읽는다.
+
+| 패턴 | 올바름 | 이유 |
+|------|--------|------|
+| task-notification 후 output 파일 읽기 | YES | 프로세스 종료 = 워커 전부 완료 |
+| task-notification 전 output 파일 tail | NO | 시작 메시지만 보이고 "실패"로 오진 |
+| psmux capture-pane으로 중간 체크 | NO | 워커 진행 중이면 빈 화면일 수 있음 |
+
+완료 마커: `=== HEADLESS_COMPLETE succeeded=N failed=N total=N ===`
+워커 상세: `$TMPDIR/tfx-headless/{sessionName}-worker-N.txt`
+</headless-retrieval>
+
+<cross-review>
+## 교차 검증
+
+- Claude 작성 코드 → Codex 리뷰
+- Codex 작성 코드 → Claude 리뷰
+- 동일 모델 self-approve 하지 않는다
+- git commit 전 미검증 파일 감지 시 nudge
+</cross-review>
+
+<session-context>
+## 맥락 이탈 판단
+
+현재 세션 맥락과 무관한 요청이 감지되면 psmux 격리를 제안한다.
+
+| 확신도 | 신호 | 행동 |
+|--------|------|------|
+| 확실 | "새 탭", "별도로", "새 세션" | 바로 psmux spawn |
+| 높음 | 다른 프로젝트/스택 언급 | 분리 제안 |
+| 중간 | 작업 유형 전환 | 분리 제안 + 현재 세션 옵션 |
+| 낮음 | 현재 작업 연장 | 세션 유지 |
+</session-context>
+
+## 세부 규칙은 `.claude/rules/` 참조
+
+| 파일 | 내용 |
+|------|------|
+| `.claude/rules/tfx-routing.md` | 자연어 → 스킬 라우팅, CLI 라우팅 Layer 1~3, 충돌 해소 |
+| `.claude/rules/tfx-execution-skill-map.md` | tfx-auto / multi / swarm 실행 엔진 매핑, 격리 기준, 안티패턴 |
+| `.claude/rules/tfx-autoplan-principles.md` | gstack autoplan의 6 decision principles, phase 우선순위, 충돌 해소 규칙 추출본 |
+| `.claude/rules/tfx-update-logic.md` | triflux / OMC / gstack / Codex / Gemini 업데이트 로직 |
+| `.claude/rules/tfx-stack-coexistence.md` | gstack / superpowers / triflux 공존 원칙, 레이어 분리, 의존 방향, 충돌 해소 |
+| `.claude/rules/tfx-mirror-policy.md` | packages/ 3-layer mirror 정책 (core 단순 cp / remote import 변환 / triflux byte-identical), tests 제외 룰, drift 차단 |
+
+Claude Code는 `.claude/rules/*.md` 를 자동 로드한다. Codex CLI는 `@import` 미지원이므로 필요 시 `AGENTS.md` 를 독립 유지한다.
+
+## GBrain Configuration (configured by /setup-gbrain)
+- Engine: pglite
+- Config file: ~/.gbrain/config.json (mode 0600)
+- Setup date: 2026-04-25
+- MCP registered: yes (user scope, absolute path)
+- Memory sync: artifacts-only (repo: github.com/tellang/gstack-brain-tellang)
+- Current repo policy: read-write (github.com/tellang/triflux)

package/README.ko.md

@@ -10,15 +10,15 @@
 
 <p align="center">
   <strong>Consensus Intelligence 기반 Tri-CLI 오케스트레이션</strong><br>
-  <em>Claude + Codex + Gemini — 21개 코어 스킬, 23개 thin alias, 자연어 라우팅, 교차 모델 리뷰.</em>
+  <em>Claude + Codex + Gemini — 13개 공개 코어 스킬, 11개 호환 alias, 자연어 라우팅, 교차 모델 리뷰.</em>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242" alt="npm downloads"></a>
   <a href="https://github.com/tellang/triflux/stargazers"><img src="https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00" alt="GitHub stars"></a>
-  <img src="https://img.shields.io/badge/skills-21_core-F5C242?style=flat-square" alt="21개 코어 스킬">
-  <sub>+ 23개 thin alias</sub>
+  <img src="https://img.shields.io/badge/skills-13_core-F5C242?style=flat-square" alt="13개 코어 스킬">
+  <sub>+ 11개 호환 alias</sub>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
 </p>
 
@@ -29,7 +29,7 @@
 <p align="center">
   <a href="#빠른-시작">빠른 시작</a> ·
   <a href="#tri-cli-합의-엔진">Tri-CLI 합의 엔진</a> ·
-  <a href="#전체-21개-스킬-23개-thin-alias-포함">전체 21개 스킬</a> ·
+  <a href="#전체-13개-코어-스킬-호환-alias-포함">전체 13개 스킬</a> ·
   <a href="#아키텍처">아키텍처</a> ·
   <a href="#deep-vs-light">Deep vs Light</a> ·
   <a href="#보안">보안</a>
@@ -57,15 +57,14 @@ npm install -g triflux
 ### 사용법
 
 ```bash
-# Light — 단일 모델로 빠르게 실행
+# Deep 기본값 — 3자 합의로 실행
 /tfx-research "React 19 Server Actions best practices"
 /tfx-review
 /tfx-plan "add JWT auth middleware"
 
-# Deep — 중요한 작업에 3자 합의 적용
-/tfx-deep-research "microservice architecture comparison 2026"
-/tfx-deep-review
-/tfx-deep-plan "migrate REST to GraphQL"
+# Quick opt-out — 단일 모델로 빠르게 실행
+/tfx-review --quick
+/tfx-plan "add JWT auth middleware" --quick
 
 # Debate — 3개의 독립적인 의견을 확보
 /tfx-debate "Redis vs PostgreSQL LISTEN/NOTIFY for real-time events"
@@ -77,7 +76,7 @@ npm install -g triflux
 /tfx-multi "refactor auth + update UI + add tests"
 
 # Remote — setup, spawn, attach, resume를 하나의 표면으로
-/tfx-remote-setup                              # 인터랙티브 호스트 설정 위저드 (Tailscale + SSH)
+/tfx-remote setup                              # 인터랙티브 호스트 설정 위저드 (Tailscale + SSH)
 /tfx-remote spawn ultra4 "보안 리뷰 실행"       # 원격 호스트에서 세션 실행
 ```
 
@@ -89,9 +88,9 @@ npm install -g triflux
 
 ### v10.11.0 주요 특징
 
-- **자연어 라우팅** — "리뷰해줘"라고 말하면 `/tfx-review`가 자동 호출. "제대로/꼼꼼히" 수정자로 Deep 변형 자동 에스컬레이션
+- **자연어 라우팅** — "리뷰해줘"라고 말하면 `/tfx-review`가 자동 호출. 기본은 Deep이고 `--quick`으로 빠른 경로를 명시
 - **교차 모델 리뷰** — Claude가 작성하면 Codex가 리뷰, Codex가 작성하면 Claude가 리뷰. 동일 모델 self-approve 차단. 커밋 전 미검증 파일 nudge
-- **정확한 카탈로그** — 44개 스킬 파일 기준 `21 core + 23 thin alias`
+- **정확한 카탈로그** — 33개 스킬 파일 기준 `13 public core + 11 compatibility alias + 9 internal helper`
 - **Phase 3** — `--retry ralph`, `--retry auto-escalate`, `--lead codex`, `--max-iterations N`, 4단계 `DEFAULT_ESCALATION_CHAIN`
 - **Phase 4** — `tfx-auto --shape debate|panel|consensus`, `tfx-remote` 단일 진입점, `tfx-psmux-rules`는 `.claude/rules/tfx-psmux.md`로 이동
 - **하위 호환성 유지** — `tfx-persist`, `tfx-debate`, `tfx-multi`, `tfx-remote-spawn` 같은 기존 이름은 thin alias로 계속 지원
@@ -142,44 +141,39 @@ Phase 4 이후에는 `tfx-auto`가 하나의 front door 역할을 맡습니다.
 
 ---
 
-## 전체 21개 스킬 (23개 thin alias 포함)
+## 전체 13개 코어 스킬 (호환 alias 포함)
 
 ### 리서치
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-research` | Active | Exa/Brave/Tavily 자동 선택을 통한 빠른 웹 검색 |
-| `tfx-find` | Active | 파일, 심볼, 패턴 중심의 빠른 코드베이스 탐색 |
+| `tfx-index` | Core | 프로젝트 인덱싱과 컨텍스트 압축 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-research`, `tfx-autoresearch`
+내부 라우팅 helper: `tfx-research`, `tfx-find`
 
 ### 분석 및 계획
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-analysis` | Active | 빠른 코드/아키텍처 분석 |
-| `tfx-plan` | Active | 빠른 구현 계획 수립 |
-| `tfx-interview` | Active | 소크라테스식 요구사항 탐색 |
+| _독립 공개 표면 없음_ | — | 분석, 계획, 인터뷰는 내부 helper로 라우팅 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-analysis`, `tfx-deep-plan`, `tfx-deep-interview`
+내부 라우팅 helper: `tfx-analysis`, `tfx-plan`, `tfx-interview`
 
 ### 실행
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-auto` | Active | 플래그 기반 라우팅과 legacy surface folding을 담당하는 통합 CLI 오케스트레이터 |
+| `tfx-auto` | Core | 플래그 기반 라우팅과 legacy surface folding을 담당하는 통합 CLI 오케스트레이터 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-autopilot`, `tfx-fullcycle`, `tfx-codex`, `tfx-gemini`
+호환 alias: `tfx-autopilot`, `tfx-fullcycle`, `tfx-multi`, `tfx-persist`, `tfx-swarm`
 
 ### 리뷰 및 QA
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-review` | Active | 빠른 코드 리뷰 |
-| `tfx-qa` | Active | Test → Fix → Retest 순환 (최대 3회) |
-| `tfx-prune` | Active | AI slop 제거, dead code 및 과한 추상화 정리 |
+| _독립 공개 표면 없음_ | — | 리뷰, QA, 정리는 내부 helper로 라우팅 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
+내부 라우팅 helper: `tfx-review`, `tfx-qa`, `tfx-prune`
 
 ### 토론 및 의사결정
 
@@ -187,35 +181,33 @@ Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
 |------|------|------|
 | _독립 active 표면 없음_ | — | debate, consensus, panel은 이제 `tfx-auto --mode consensus`의 출력 shape로 통합 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-consensus`, `tfx-debate`, `tfx-panel`
+호환 alias: `tfx-consensus`, `tfx-debate`, `tfx-panel`
 
 ### 지속 실행 및 라우팅
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-index` | Active | 프로젝트 인덱싱으로 94% 토큰 절감 (58K→3K) |
-| `tfx-hooks` | Active | Claude Code hook priority 관리 |
-| `tfx-profile` | Active | Codex/Gemini CLI 프로필 관리 |
+| `tfx-hooks` | Core | Claude Code hook priority 관리 |
+| `tfx-profile` | Core | Codex/Gemini CLI 프로필 관리 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-persist`, `tfx-ralph`, `tfx-autoroute`, `tfx-auto-codex`
+내부 라우팅 helper: `tfx-ralph`
 
 ### 오케스트레이션
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-hub` | Active | MCP 메시지 버스 관리 |
-| `tfx-codex-swarm` | Active | Codex swarm 실행 표면 |
-| `merge-worktree` | Active | swarm 결과용 worktree merge helper |
+| `tfx-hub` | Core | MCP 메시지 버스 관리 |
+| `merge-worktree` | Core | swarm 결과용 worktree merge helper |
 
-Aliases (fold into active surfaces): `tfx-multi`, `tfx-swarm`
+Swarm 실행은 `tfx-auto --parallel swarm` 과 `tfx swarm` CLI로 노출된다.
 
 ### 원격
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-remote` | Active | setup, spawn, list, attach, send, resume, probe, rules를 묶는 원격 command family |
+| `tfx-remote` | Core | setup, spawn, list, attach, send, resume, probe, rules를 묶는 원격 command family |
 
-Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — Phase 4에서 `.claude/rules/tfx-psmux.md`로 이동
+호환 alias: `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — Phase 4에서 `.claude/rules/tfx-psmux.md`로 이동
 
 ### 메타
 
@@ -225,6 +217,7 @@ Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tf
 | `tfx-setup` | Active | 초기 설정 마법사 |
 | `tfx-doctor` | Active | 진단 및 자동 복구 |
 | `tfx-ship` | Active | ship workflow orchestration |
+| `tfx-wt` | Active | Windows Terminal 탭/패인 제어 |
 | `star-prompt` | Active | postinstall GitHub star prompt |
 
 ---
@@ -316,15 +309,14 @@ npm install -g triflux
 ### 사용법
 
 ```bash
-# Light — 단일 모델로 빠르게 실행
+# Deep 기본값 — 3자 합의로 실행
 /tfx-research "React 19 Server Actions best practices"
 /tfx-review
 /tfx-plan "add JWT auth middleware"
 
-# Deep — 중요한 작업에 3자 합의 적용
-/tfx-deep-research "microservice architecture comparison 2026"
-/tfx-deep-review
-/tfx-deep-plan "migrate REST to GraphQL"
+# Quick opt-out — 단일 모델로 빠르게 실행
+/tfx-review --quick
+/tfx-plan "add JWT auth middleware" --quick
 
 # Debate — 3개의 독립적인 의견을 확보
 /tfx-debate "Redis vs PostgreSQL LISTEN/NOTIFY for real-time events"

package/README.md

@@ -11,7 +11,7 @@
 <h3 align="center">Tri-CLI Orchestration with Consensus Intelligence</h3>
 
 <p align="center">
-  Route tasks across <strong>Claude + Codex + Gemini</strong> — 21 core skills, natural language routing,<br>
+  Route tasks across <strong>Claude + Codex + Gemini</strong> — 13 public core skills, natural language routing,<br>
   cross-model review, and reflexion-based adaptive learning.
 </p>
 
@@ -19,8 +19,8 @@
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242" alt="npm downloads"></a>
   <a href="https://github.com/tellang/triflux/stargazers"><img src="https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00" alt="GitHub stars"></a>
-  <img src="https://img.shields.io/badge/skills-21_core-F5C242?style=flat-square" alt="21 core skills">
-  <sub>+ 23 thin aliases</sub>
+  <img src="https://img.shields.io/badge/skills-13_core-F5C242?style=flat-square" alt="13 core skills">
+  <sub>+ 11 compatibility aliases</sub>
   <img src="https://img.shields.io/badge/node-%3E%3D18-374151?style=flat-square" alt="Node >= 18">
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
 </p>
@@ -33,7 +33,7 @@
   <a href="#quick-start">Quick Start</a> &middot;
   <a href="#core-engine">Core Engine</a> &middot;
   <a href="#killer-skills">Killer Skills</a> &middot;
-  <a href="#all-21-skills-plus-23-thin-aliases">All 21 Skills</a> &middot;
+  <a href="#all-13-core-skills-plus-compatibility-aliases">All 13 Skills</a> &middot;
   <a href="#deep-vs-light">Deep vs Light</a> &middot;
   <a href="#architecture">Architecture</a> &middot;
   <a href="#security">Security</a>
@@ -45,7 +45,7 @@
 
 Most AI coding tools talk to **one model**. triflux talks to **three** — and makes them argue.
 
-triflux is not a collection of skills. It is a **multi-model parallel orchestration harness**. The 21 core skills and 23 thin aliases are what it does. The harness — consensus engine, message bus, router, and security guard — is what makes it different.
+triflux is not a collection of skills. It is a **multi-model parallel orchestration harness**. The 13 public core skills, 11 compatibility aliases, and internal routed helpers are what it does. The harness — consensus engine, message bus, router, and security guard — is what makes it different.
 
 Every Deep skill runs Claude, Codex, and Gemini **independently** (no cross-visibility), then cross-validates their findings. Only consensus-verified results survive. The result: **87% fewer false positives** compared to single-model review.
 
@@ -54,10 +54,10 @@ Phase 4 folds the legacy surface into one front door: `tfx-auto` with flag-based
 You don't need to memorize commands. Say what you want in natural language — triflux routes to the right skill automatically:
 
 ```
-"review this"          → /tfx-review       (Light — single model, fast)
-"review this thoroughly" → /tfx-deep-review  (Deep — 3-party consensus)
+"review this"          → /tfx-review       (Deep by default — 3-party consensus)
+"review this --quick"  → /tfx-review --quick  (quick opt-out)
 "리뷰해줘"              → /tfx-review       (Korean works too)
-"제대로 리뷰해"          → /tfx-deep-review  (depth modifier detected)
+"제대로 리뷰해"          → /tfx-review       (depth modifier detected)
 ```
 
 ---
@@ -83,8 +83,8 @@ Then run `tfx setup` to configure your environment.
 
 ```bash
 # 3-party consensus — three models argue, only consensus survives
-/tfx-deep-review
-/tfx-deep-plan "migrate REST to GraphQL"
+/tfx-review
+/tfx-plan "migrate REST to GraphQL"
 
 # Swarm — split PRD into shards, parallel worktree execution
 /tfx-swarm
@@ -266,13 +266,13 @@ Each shard gets its own git worktree, file-lease enforcement prevents conflicts,
 /tfx-auto "implement full auth flow with tests" --retry ralph --max-iterations 10
 ```
 
-### 3-Party Consensus Reviews — `tfx-deep-review` / `tfx-deep-plan`
+### 3-Party Consensus Reviews — `tfx-review` / `tfx-plan`
 
 The bread-and-butter Deep skills. Three models independently review your code or plan your implementation, then cross-validate. Only consensus-verified findings survive.
 
 ```bash
-/tfx-deep-review            # 3-party code review
-/tfx-deep-plan "migrate to GraphQL"  # 3-party planning
+/tfx-review            # 3-party code review by default
+/tfx-plan "migrate to GraphQL"  # 3-party planning by default
 ```
 
 ### Structured Debate — `tfx-debate` (alias for `tfx-auto --mode consensus --shape debate`)
@@ -285,7 +285,7 @@ Three models take independent positions on a technical question, debate, and con
 
 ---
 
-## All 21 Skills (plus 23 thin aliases)
+## All 13 Core Skills (plus compatibility aliases)
 
 <details>
 <summary>Expand full skill list</summary>
@@ -294,38 +294,33 @@ Three models take independent positions on a technical question, debate, and con
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-research` | Active | Quick web search via Exa/Brave/Tavily auto-selection |
-| `tfx-find` | Active | Fast codebase search — files, symbols, patterns |
+| `tfx-index` | Core | Project indexing and context compression |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-research`, `tfx-autoresearch`
+Internal routed helpers: `tfx-research`, `tfx-find`
 
 ### Analysis & Planning
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-analysis` | Active | Quick code/architecture analysis |
-| `tfx-plan` | Active | Quick implementation plan |
-| `tfx-interview` | Active | Socratic requirements exploration |
+| _No standalone public surface_ | — | Analysis, planning, and interview route through internal helpers |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-analysis`, `tfx-deep-plan`, `tfx-deep-interview`
+Internal routed helpers: `tfx-analysis`, `tfx-plan`, `tfx-interview`
 
 ### Execution
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-auto` | Active | Unified CLI orchestrator — auto-triage, flag-based routing, and legacy surface folding |
+| `tfx-auto` | Core | Unified CLI orchestrator — auto-triage, flag-based routing, and legacy surface folding |
 
-Aliases (fold into `tfx-auto` flags): `tfx-autopilot`, `tfx-fullcycle`, `tfx-codex`, `tfx-gemini`
+Compatibility aliases: `tfx-autopilot`, `tfx-fullcycle`, `tfx-multi`, `tfx-persist`, `tfx-swarm`
 
 ### Review & QA
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-review` | Active | Quick code review |
-| `tfx-qa` | Active | Test → Fix → Retest cycle (max 3 rounds) |
-| `tfx-prune` | Active | AI slop removal — dead code, over-abstraction cleanup |
+| _No standalone public surface_ | — | Review, QA, and cleanup route through internal helpers |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
+Internal routed helpers: `tfx-review`, `tfx-qa`, `tfx-prune`
 
 ### Debate & Decision
 
@@ -333,27 +328,25 @@ Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
 |-------|------|-------------|
 | _No standalone active surface_ | — | Debate, consensus, and panel shapes now route through `tfx-auto --mode consensus` |
 
-Aliases (fold into `tfx-auto` flags): `tfx-consensus`, `tfx-debate`, `tfx-panel`
+Compatibility aliases: `tfx-consensus`, `tfx-debate`, `tfx-panel`
 
 ### Persistence & Routing
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-index` | Active | Project indexing — 94% token reduction (58K → 3K) |
-| `tfx-hooks` | Active | Claude Code hook priority manager |
-| `tfx-profile` | Active | Codex/Gemini CLI profile management |
+| `tfx-hooks` | Core | Claude Code hook priority manager |
+| `tfx-profile` | Core | Codex/Gemini CLI profile management |
 
-Aliases (fold into `tfx-auto` flags): `tfx-persist`, `tfx-ralph`, `tfx-autoroute`, `tfx-auto-codex`
+Internal routed helper: `tfx-ralph`
 
 ### Orchestration & Infrastructure
 
 | Skill | Description |
 |-------|-------------|
 | `tfx-hub` | MCP message bus — Named Pipe & HTTP bridge |
-| `tfx-codex-swarm` | Codex swarm execution surface |
 | `merge-worktree` | Worktree merge helper for swarm results |
 
-Aliases (fold into active surfaces): `tfx-multi`, `tfx-swarm`
+Swarm execution is exposed through `tfx-auto --parallel swarm` and the `tfx swarm` CLI.
 
 ### Remote
 
@@ -361,7 +354,7 @@ Aliases (fold into active surfaces): `tfx-multi`, `tfx-swarm`
 |-------|-------------|
 | `tfx-remote` | Unified remote command family — setup, spawn, list, attach, send, resume, probe, rules |
 
-Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — moved to `.claude/rules/tfx-psmux.md` in Phase 4
+Compatibility aliases: `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — rules moved to `.claude/rules/tfx-psmux.md` in Phase 4
 
 ### Meta & Tooling
 
@@ -371,6 +364,7 @@ Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tf
 | `tfx-setup` | Initial setup wizard |
 | `tfx-doctor` | Diagnostics and auto-repair |
 | `tfx-ship` | Ship workflow orchestration |
+| `tfx-wt` | Windows Terminal tab/pane control |
 | `star-prompt` | GitHub star prompt for postinstall |
 
 </details>
@@ -494,7 +488,7 @@ The monitor visualizes:
 - **Consensus shapes** — `--shape consensus|debate|panel` folds ensemble behaviors into the main router
 - **Remote consolidation** — `tfx-remote` becomes the single remote surface while `tfx-remote-spawn` remains a thin alias
 - **Rules relocation** — `tfx-psmux-rules` moved out of the skill surface to `.claude/rules/tfx-psmux.md`
-- **Legacy compatibility** — 23 thin aliases remain for transition safety and are slated for later removal
+- **Legacy compatibility** — 11 compatibility aliases remain for transition safety and are slated for later removal
 
 </details>