triflux 10.43.0 → 10.45.0

package/README.md

@@ -264,6 +264,8 @@ state without replaying the entire conversation.
 
 ## Architecture
 
+> 상세 구조·패키지 레이아웃·실행 경로는 [ARCHITECTURE.md](ARCHITECTURE.md), 문서 전체 지도는 [docs/README.md](docs/README.md) 참조.
+
 <p align="center">
   <img src="docs/assets/architecture.svg" alt="triflux architecture" width="680">
 </p>
@@ -391,7 +393,7 @@ folders. Keep it synchronized when touching mirrored runtime files.
 | Linux | tmux | Supported. |
 | Windows | psmux + Windows Terminal | Supported through managed psmux/WT paths. PowerShell is the default psmux shell. |
 
-See `AGENTS.md` and `.claude/rules/tfx-psmux.md` for the stricter Windows/psmux
+See `.claude/rules/tfx-psmux.md` for the stricter Windows/psmux
 rules used by agents and launch scripts.
 
 ---

package/adapters/codex/skills/tfx-harness/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: tfx-harness
+description: >
+  Use for meta-routing questions. Read the canonical routing SSOT and return
+  exactly one branch and immediate owner; do not execute the requested work.
+---
+
+# tfx-harness — Codex adapter
+
+This skill is a routing adapter, not an execution engine. Read D0–D11 from the
+canonical routing SSOT, classify the user intent against available host
+capability evidence, and return one immediate owner. Do not copy the routing
+tree, keyword rules, or owner matrix into this file.
+
+## Locate the routing SSOT
+
+This skill is installed globally but the SSOT belongs to the Triflux project.
+Try these locations in order and return blocked only when all three fail:
+
+1. `$TFX_ROUTING_SSOT`, when set.
+2. `.claude/rules/tfx-routing.md` below the main Git worktree, derived from
+   the parent of `git rev-parse --git-common-dir`.
+3. Walk upward from the current working directory looking for
+   `.claude/rules/tfx-routing.md`.
+
+Do not use `git rev-parse --show-toplevel` for step 2. In a linked worktree it
+returns that worktree root, whose SSOT may be a stale branch snapshot.
+`--git-common-dir` still points to the main repository's `.git` directory.
+
+When blocked, include this one-line remedy:
+
+`export TFX_ROUTING_SSOT=<triflux clone>/.claude/rules/tfx-routing.md`
+
+Prefer `~/.zshenv` for this variable because hooks and headless workers may not
+load interactive `~/.zshrc`. Do not create a global copy or symlink under
+`~/.claude/rules/`; Claude auto-loads that directory into unrelated sessions.
+
+## Return contract
+
+Translate only host syntax. Hook-injected routing context is authoritative for
+the current turn. Resolve the SSOT owner against the current Codex Available
+Skills inventory, preserving the exact `$skill` name when it exists.
+
+```text
+[tfx-harness]
+branch: D<n>
+owner: <exactly one immediate owner>
+availability: available | unavailable | unknown
+fallback_notice: <optional>
+status: recommendation-only | dispatching | blocked
+```
+
+- Return exactly one branch and one immediate owner.
+- With unknown availability, do not infer a fallback.
+- With measured unavailability, report
+  `owner unavailable → tfx-X fallback` before using the fallback.
+- If the SSOT cannot be read, return
+  `blocked: routing SSOT unavailable` and the remedy above.
+- For a “which skill/path?” question, remain recommendation-only.
+- When the user clearly requests execution, read the selected downstream
+  `SKILL.md`, invoke or follow that exact Codex `$skill`, and then relinquish
+  routing ownership. Do not keep solving the downstream task inside this
+  adapter once its owner is available.
+- If the owner is unavailable, use only the fallback explicitly allowed by the
+  SSOT and label the measured unavailability before dispatch.
+- Do not select downstream implementation agents, models, profiles, or effort.

package/adapters/codex/skills/tfx-harness/skill.json

@@ -0,0 +1,5 @@
+{
+  "name": "tfx-harness",
+  "version": "1.0.0",
+  "host": "codex"
+}