triflux 10.0.0 → 10.0.2

package/skills/tfx-psmux-rules/SKILL.md.tmpl

@@ -1,317 +0,0 @@
----
-name: tfx-psmux-rules
-description: >
-  psmux + Codex CLI 명령 생성 시 반드시 적용되는 강제 규칙. PowerShell/bash 구분,
-  경로 형식, 인자 이스케이프, WT 정리, 프로파일 지정 방식 등을 검증한다.
-  이 스킬은 psmux, send-keys, codex exec, codex spawn, 세션 생성, worktree 실행,
-  launch 스크립트 생성, WT attach, 패널 스플릿, 스웜 정리 시 자동 트리거된다.
-  다른 스킬(tfx-codex-swarm, tfx-multi, tfx-remote-spawn 등)이 psmux 명령을
-  생성할 때 이 스킬의 규칙을 위반하면 생성을 중단하고 수정해야 한다.
-triggers:
-  - tfx-psmux-rules
-  - psmux-rules
----
-
-# tfx-psmux-rules — psmux + Codex CLI 강제 규칙
-
-> **이 스킬은 참고 문서가 아니다. 강제 규칙이다.**
-> psmux 명령, launch 스크립트, Codex CLI 호출을 생성하는 모든 스킬은
-> 아래 규칙을 **반드시** 준수해야 한다. 위반 시 생성을 중단하고 수정한다.
-
-## 적용 시점
-
-다음 행위 중 하나라도 수행할 때 이 규칙이 자동 적용된다:
-- `psmux send-keys` 명령 생성
-- `launch-*.sh` 또는 `launch-*.ps1` 스크립트 생성
-- `codex` CLI 호출 인자 조합
-- `wt.exe` 탭/패인 명령 생성
-- 스웜 세션 정리
-
----
-
-## RULE 1: psmux 기본 셸 = PowerShell
-
-psmux 세션의 기본 셸은 **PowerShell**이다.
-
-### MUST NOT (금지)
-
-```bash
-# WRONG — bash 문법을 PowerShell 세션에 직접 전달
-psmux send-keys -t session "cd '/c/Users/...' && codex ..." Enter
-psmux send-keys -t session "prompt=\$(cat file.md)" Enter
-psmux send-keys -t session "export FOO=bar" Enter
-```
-
-### MUST (필수)
-
-```bash
-# CORRECT — PowerShell 구문으로 bash.exe 전체 경로 호출
-BASH_WIN='C:\\Program Files\\Git\\bin\\bash.exe'
-psmux send-keys -t session "& '$BASH_WIN' './launch.sh'" Enter
-
-# CORRECT — PowerShell 네이티브 명령 사용
-psmux send-keys -t session "Set-Location 'C:\\path'" Enter
-psmux send-keys -t session "\$p = Get-Content 'file.md' -Raw" Enter
-```
-
-### 금지 패턴 체크리스트
-
-| 패턴 | 문제 | 대체 |
-|------|------|------|
-| `cd '/c/...'` | PS가 `/c/`를 상대경로로 해석 → `C:\c\...` | `Set-Location 'C:\...'` |
-| `$(cat file)` | bash 명령 치환, PS에서 `Get-Content` 호출됨 | `$p = Get-Content file -Raw` |
-| `&&` | PS7에서 작동하지만 앞 명령 실패 시 의미 다름 | `;` 또는 별도 send-keys |
-| `export VAR=val` | bash 전용 | `$env:VAR = 'val'` |
-| `grep`, `awk`, `sed` | bash 유틸리티 | PS cmdlet 또는 bash.exe 경유 |
-
----
-
-## RULE 2: 경로는 Windows 형식
-
-psmux send-keys로 전달하는 경로는 반드시 **Windows 형식**이다.
-
-```
-WRONG:  /c/Users/SSAFY/Desktop/Projects/...
-RIGHT:  C:\Users\SSAFY\Desktop\Projects\...
-```
-
-`.sh` 런처 내부에서만 Unix 경로(`/c/...`) 사용 가능.
-
----
-
-## RULE 3: 프롬프트 인자 인용 필수
-
-PRD/프롬프트 내용을 CLI 인자로 전달할 때 **반드시 인용**한다.
-
-### PowerShell (.ps1)
-
-```powershell
-$p = (Get-Content 'prompt.md' -Raw) -replace "`r`n"," " -replace "`n"," "
-
-# MUST — 인용 필수
-codex -c 'model="gpt-5.3-codex"' "$p"
-
-# MUST NOT — 미인용 시 & ; | 등이 PS 연산자로 해석됨
-codex -c 'model="gpt-5.3-codex"' $p
-```
-
-### Bash (.sh)
-
-```bash
-prompt=$(cat prompt.md)
-
-# MUST — 더블쿼트 필수
-exec codex "$prompt"
-
-# MUST NOT — 워드 스플리팅 + 글로빙 발생
-exec codex $prompt
-```
-
----
-
-## RULE 4: 프로파일 사용, 인자 하드코딩 금지
-
-Codex든 Gemini든 **모델·effort·실행모드는 프로파일(config)로 관리**한다.
-CLI 인자로 하드코딩하지 않는다.
-
-### 4-1. 프로파일 우선
-
-```bash
-# CORRECT — 프로파일에 model/effort/approval_mode 모두 정의해두고 호출
-codex < prompt.md
-codex --full-auto < prompt.md   # config.toml에 approval_mode 미설정 시만
-
-# WRONG — 인자로 모델·effort 하드코딩
-codex -c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"' "prompt"
-```
-
-프로파일 관리는 `tfx-profile` 스킬 또는 `~/.codex/config.toml` 직접 편집.
-
-### 4-2. config.toml 중복 플래그 금지
-
-config.toml에 이미 설정된 값을 CLI 플래그로 다시 지정하면 **에러**:
-```
-error: the argument '--dangerously-bypass-approvals-and-sandbox' cannot be used multiple times
-```
-
-**규칙**: 런처 생성 전 config.toml을 확인하고, 이미 있는 항목은 CLI에서 생략.
-
-### 4-3. 프롬프트는 stdin으로 전달
-
-프롬프트를 CLI 인자로 넘기면 `--` 접두사 텍스트가 플래그로 파싱되는 문제 발생.
-**항상 stdin(파이프 또는 리다이렉션)으로 전달한다.**
-
-```bash
-# bash 런처
-exec codex < /c/path/prompts/prompt.md
-```
-
-```powershell
-# PS1 런처
-Get-Content 'C:\path\prompts\prompt.md' -Raw | codex
-```
-
----
-
-## RULE 5: WT 패인 정리 — CRITICAL (크래시/프리징 방지)
-
-> **이 규칙을 위반하면 Windows Terminal이 크래시/프리징된다.**
-> 원인: WT 1.24의 ConPTY close 레이스 버그 ([microsoft/terminal#17871](https://github.com/microsoft/terminal/issues/17871)).
-> `kill-session`은 물론 `send-keys "exit"`도 ConPTY 파이프 끊김 → 동일 레이스 가능.
-> **유일한 안전 경로: detach-client로 WT와 ConPTY 연결을 먼저 분리.**
-
-### MUST — 3단계 정리 (detach-first, 순서 반드시 준수)
-
-```bash
-# 1) WT 클라이언트를 세션에서 detach (ConPTY 연결 안전 분리)
-for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
-  psmux detach-client -t "$s" 2>/dev/null || true
-done
-
-# 2) WT가 detach된 pane을 정리할 시간 확보
-sleep 2
-
-# 3) detach된 세션을 안전하게 kill (WT와 무관)
-for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
-  psmux kill-session -t "$s" 2>/dev/null || true
-done
-```
-
-### MUST NOT — 아래 패턴은 전부 크래시/프리징 유발
-
-```bash
-# WRONG 1 — detach 없이 바로 kill
-psmux kill-session -t "$s"
-
-# WRONG 2 — exit도 ConPTY 파이프 끊김 → 같은 레이스
-psmux send-keys -t "$s" "exit" Enter
-
-# WRONG 3 — WT split pane 직접 닫기 (Ctrl+Shift+W 금지)
-# 대신: pane 안에서 psmux detach (또는 Ctrl+B, D) → pane이 자동으로 닫힘
-```
-
----
-
-## RULE 5-1: psmux 경로 탐색
-
-psmux는 환경마다 설치 위치가 다르다. `hub/team/psmux.mjs`의 `PSMUX_BIN`이
-자동 탐색하지만, 스크립트에서 직접 psmux를 호출할 때도 경로를 고려해야 한다.
-
-탐색 우선순위:
-1. `$PSMUX_BIN` 환경변수 (설정 시 최우선)
-2. PATH의 `psmux`
-3. `%LOCALAPPDATA%\psmux\psmux.exe` (Windows 기본)
-4. `%APPDATA%\npm\psmux.cmd` (npm global)
-5. `~\scoop\shims\psmux.exe` (Scoop)
-
----
-
-## RULE 5-2: 설치 / 업데이트 preflight
-
-`psmux`는 단순히 PATH에 있다고 끝이 아니다. Triflux는 아래 capability를 전제로 한다.
-
-- `new-session`
-- `attach-session`
-- `kill-session`
-- `capture-pane`
-- `detach-client` (있으면 attach/detach cleanup hardening에 활용)
-
-설치/업데이트가 의심될 때는 먼저:
-
-```bash
-tfx doctor --json
-```
-
-공식 설치/업데이트 기준:
-
-```bash
-# install
-winget install marlocarlo.psmux
-scoop install psmux
-choco install psmux
-cargo install psmux
-
-# update
-winget upgrade marlocarlo.psmux
-scoop update psmux
-choco upgrade psmux
-cargo install psmux --force
-```
-
-**금지:** 문서/스크립트에서 `npm install -g psmux`를 표준 설치 경로처럼 안내하지 않는다.
-
----
-
-## RULE 5-3: WT 명령 치트시트
-
-### 패인 분할
-
-```bash
-# 현재 창에서 수평 분할 (상/하)
-wt.exe -w 0 sp -H -p triflux --title "worker" psmux attach-session -t SESSION
-
-# 현재 창에서 수직 분할 (좌/우)
-wt.exe -w 0 sp -V -p triflux --title "worker" psmux attach-session -t SESSION
-
-# 2x2 그리드 (4 패인)
-wt.exe -w 0 \
-  sp -H -p triflux --title "w1" psmux attach-session -t S1 \; \
-  sp -V -p triflux --title "w2" psmux attach-session -t S2 \; \
-  move-focus up \; \
-  sp -V -p triflux --title "w3" psmux attach-session -t S3
-```
-
-### 포커스 이동
-
-```bash
-wt.exe -w 0 move-focus up|down|left|right
-```
-
-### 패인 닫기 (세션 kill보다 안전)
-
-```bash
-wt.exe -w 0 close-pane
-```
-
-### 필수 옵션
-
-| 옵션 | 의미 | 필수 여부 |
-|------|------|----------|
-| `-w 0` | 현재 WT 윈도우 | 필수 (없으면 새 창) |
-| `-p triflux` | triflux WT 프로파일 | 필수 (테마/셸 일관성) |
-| `--title "name"` | 패인 제목 | 권장 (식별용) |
-| `sp -H` / `sp -V` | 분할 방향 | 필수 |
-
-### 새 탭 금지
-
-```bash
-# WRONG — 새 탭 생성 (nt)
-wt.exe -w 0 nt -p triflux ...
-
-# RIGHT — split-pane (sp)
-wt.exe -w 0 sp -V -p triflux ...
-```
-
----
-
-## RULE 6: spark53 프로파일은 Pro 전용
-
-`spark53_med`, `spark53_low` 등 spark 모델 프로파일은 **Codex Pro 구독 전용**이다.
-비-Pro 환경에서는 `codex53_low`로 폴백한다.
-
----
-
-## RULE 7: WT 레이아웃 선택 필수
-
-WT에 패인을 배치하기 전에 **반드시** 사용자에게 레이아웃을 확인한다.
-새 탭(`nt`)은 금지 — split + dashboard가 기본.
-
-선택지: 새 창에서 스플릿 / 현재 창에서 스플릿 / dashboard / attach 안 함
-
----
-
-## 위반 감지 시 행동
-
-1. 생성한 명령/스크립트가 위 규칙을 위반하면 **즉시 수정**한다
-2. 수정 불가능하면 **생성을 중단**하고 사용자에게 알린다
-3. 다른 스킬이 이 규칙을 무시하고 명령을 생성하면 **경고를 출력**한다

package/skills/tfx-psmux-rules/skill.json

@@ -1,8 +0,0 @@
-{
-  "name": "tfx-psmux-rules",
-  "description": "psmux + Codex CLI 명령 생성 시 반드시 적용되는 강제 규칙. PowerShell/bash 구분, 경로 형식, 인자 이스케이프, WT 정리, 프로파일 지정 방식 등을 검증한다. 이 스킬은 psmux, send-keys, codex exec, codex spawn, 세션 생성, worktree 실행, launch 스크립트 생성, WT attach, 패널 스플릿, 스웜 정리 시 자동 트리거된다. 다른 스킬(tfx-codex-swarm, tfx-multi, tfx-remote-spawn 등)이 psmux 명령을 생성할 때 이 스킬의 규칙을 위반하면 생성을 중단하고 수정해야 한다.",
-  "triggers": [
-    "tfx-psmux-rules",
-    "psmux-rules"
-  ]
-}

package/skills/tfx-qa/skill.json

@@ -1,11 +0,0 @@
-{
-  "name": "tfx-qa",
-  "description": "테스트 실행하고 실패하면 수정해서 통과시켜야 할 때 사용한다. 'qa', '검증해', '테스트 돌려', 'test-fix', '테스트 통과시켜' 같은 요청에 반드시 사용. 테스트 실패를 반복 수정하여 전부 통과시켜야 할 때 적극 활용.",
-  "triggers": [
-    "qa",
-    "검증",
-    "테스트 검증",
-    "test-fix"
-  ],
-  "argument_hint": "[테스트 명령 또는 파일 경로]"
-}

package/skills/tfx-ralph/SKILL.md.tmpl

@@ -1,27 +0,0 @@
----
-name: tfx-ralph
-description: >
-  tfx-persist의 별칭(alias). 'ralph', '끝까지 해', '멈추지 마' 같은 요청에 사용.
-  실제 동작은 tfx-persist 스킬이 수행합니다.
-  Use when: ralph, 끝까지, don't stop, 멈추지 마
-triggers:
-  - tfx-ralph
-  - ralph
----
-
-# tfx-ralph — tfx-persist 별칭
-
-> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
-> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
-
-
-이 스킬은 `tfx-persist`와 동일합니다. `/tfx-persist` 스킬을 호출하세요.
-
-## 동작
-
-Skill 도구로 tfx-persist를 호출한다:
-```
-Skill: tfx-persist
-```
-
-사용자의 원래 요청을 그대로 전달한다.

package/skills/tfx-ralph/skill.json

@@ -1,8 +0,0 @@
-{
-  "name": "tfx-ralph",
-  "description": "tfx-persist의 별칭(alias). 'ralph', '끝까지 해', '멈추지 마' 같은 요청에 사용. 실제 동작은 tfx-persist 스킬이 수행합니다. Use when: ralph, 끝까지, don't stop, 멈추지 마",
-  "triggers": [
-    "tfx-ralph",
-    "ralph"
-  ]
-}