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 제외 대상).

반환 형식:

[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은 선택하지 않는다.