Tfx Harness

---
name: tfx-harness
internal: true
description: >
  어떤 스킬·경로를 선택할지 묻는 메타 라우팅 요청에 사용한다. 실행하지 않고
  canonical routing SSOT에서 branch와 즉시 owner 하나만 반환한다.
---

# tfx-harness — Claude adapter

이 스킬은 실행 엔진이 아니다. routing SSOT의 D0–D11을 읽어 사용자 intent와 확인 가능한
host capability evidence를 판정한다. 정책 표, keyword 표, owner 매트릭스를 이 파일에
복제하지 않는다.

## SSOT 탐색

이 스킬은 글로벌 설치이고 triflux 밖에서도 호출되지만 SSOT는 프로젝트 로컬 파일이다.
아래를 순서대로 시도하고, **전부 실패할 때만** blocked를 반환한다.

1. `$TFX_ROUTING_SSOT` (설정돼 있으면 1순위)
2. git 메인 워크트리 — `$(git rev-parse --git-common-dir)`의 부모 아래
   `.claude/rules/tfx-routing.md`
3. cwd에서 위로 올라가며 `.claude/rules/tfx-routing.md`

2순위에 `--show-toplevel`을 쓰지 않는다. linked worktree 안에서는 worktree 루트를
반환하는데 그곳의 SSOT는 브랜치 분기 시점 사본이라, blocked 없이 stale 정책으로
조용히 오판정한다. `--git-common-dir`은 worktree 안에서도 메인 repo의 `.git`을 가리킨다.

blocked를 반환할 때는 해소 방법을 한 줄 덧붙인다:
`export TFX_ROUTING_SSOT=<triflux clone>/.claude/rules/tfx-routing.md`
(`~/.zshrc`가 아니라 `~/.zshenv`에 둔다. zshrc는 interactive 전용이라 훅·headless
워커·툴 셸에서는 1순위가 통째로 죽는다.)

`~/.claude/rules/`에 사본이나 symlink를 두지 않는다. 그 디렉터리는 Claude가 모든 세션에
자동 로드하므로 tfx와 무관한 세션까지 SSOT 전문을 매번 컨텍스트에 싣게 된다.
npm 패키지에도 `.claude/`는 없다(`tfx-mirror-policy.md` mirror 제외 대상).

반환 형식:

```text
[tfx-harness]
branch: D<n>
owner: <exactly one immediate owner>
availability: available | unavailable | unknown
fallback_notice: <optional>
status: recommendation-only | dispatching | blocked
```

- 한 판정에는 branch 하나와 immediate owner 하나만 둔다.
- availability가 unknown이면 fallback하지 않는다. 실제 unavailable 증거가 있을 때만
  `owner unavailable → tfx-X fallback`을 함께 알릴 수 있다.
- SSOT를 읽지 못하면 추측하지 말고 `blocked: routing SSOT unavailable`을 반환한다.
- “어떤 스킬/경로?” 질문은 recommendation-only다. 명백한 진행 요청만 `/skill` 문법으로
  owner에 handoff한다.
- downstream implementation agent나 model은 선택하지 않는다.