triflux 10.58.0 → 10.59.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/rules/tfx-routing.md +5 -9
- package/bin/triflux.mjs +496 -396
- package/package.json +1 -1
- package/scripts/lib/cli-output.mjs +228 -0
- package/scripts/lib/legacy-mcp-cleanup.mjs +2 -4
- package/scripts/lib/tmr-install.mjs +4 -3
- package/scripts/setup.mjs +279 -222
- package/skills/tfx-review/SKILL.md +3 -3
|
@@ -21,7 +21,7 @@ description에는 해당 스킬을 고르는 데 필요한 좁은 activation phr
|
|
|
21
21
|
| 직접 구현/수정 | `/tfx-auto` (Codex 우선) | "이거 고쳐줘", "구현해줘". 기존 작업 연장이면 `/gstack-context-restore` 먼저. |
|
|
22
22
|
| 디버그 | Claude 기본 Explore 에이전트 → `/superpowers:systematic-debugging` → `/tfx-auto` | 코드 위치/사용처 확인과 원인 분석을 분리한다. |
|
|
23
23
|
| 리서치 | `/tfx-research` 또는 `/multilingual-parallel-research` | 외부/최신/도구 가능 여부 의문문은 `/tfx-research`; 언어권 병렬 조사는 multilingual 경로. |
|
|
24
|
-
| 검증 | `/
|
|
24
|
+
| 검증 | `/tfx-review` + `/gstack-qa` + `/superpowers:verification-before-completion` | 코드 판정은 review, 브라우저/워크플로우 게이트는 qa, 완료 주장 전 evidence 수집은 verification. |
|
|
25
25
|
| 디자인 검토 | `/gstack-design-review` | 시각/UX 판정. 코드 판정과 분리. |
|
|
26
26
|
| TDD 시작 | `/superpowers:test-driven-development` | 테스트부터 짜는 흐름. 구현 전에 invoke. |
|
|
27
27
|
| 코드 변경 병렬 실행 | 작업별 worktree와 세션을 분리하고 각 세션에서 `/tfx-auto` 실행 | Claude Agent는 `isolation: worktree` 사용 가능. |
|
|
@@ -46,7 +46,7 @@ description에는 해당 스킬을 고르는 데 필요한 좁은 activation phr
|
|
|
46
46
|
- D6: 실패/버그/test failure는 `systematic-debugging` 후 `tfx-auto`; 정상 구조 설명은 `tfx-auto --mode consensus --shape panel`.
|
|
47
47
|
- D7: 로컬 파일·심볼은 Claude 기본 Explore 에이전트(스킬 없음); 외부·최신·공식 문서는 `tfx-research`.
|
|
48
48
|
- D8: 무수식 AI slop/deslop/refactor는 host `ai-slop-cleaner`; 명시 TFX 3자 cleanup만 `tfx-auto --mode consensus`; 회고는 `retro`. “정리” 한 단어로 cleanup을 강제하지 않는다.
|
|
49
|
-
- D9: web/app flow는 `qa
|
|
49
|
+
- D9: web/app flow는 `qa`, code verdict는 review backend, 완료 주장 전 근거 수집은 `verification-before-completion`.
|
|
50
50
|
- D10: 명확한 직접 구현은 TDD 필요 여부 뒤 `tfx-auto`; 2+ code-changing lane은 worktree와 세션을 각각 분리.
|
|
51
51
|
- D11: fresh verification 없이 ship 금지. triflux release는 `tfx-ship`, 일반 release는 `ship`, 중단/재개는 context save/restore.
|
|
52
52
|
|
|
@@ -58,7 +58,7 @@ owner availability를 실제로 검출한 경우에만 `owner unavailable → tf
|
|
|
58
58
|
|------|-----------|------|
|
|
59
59
|
| 리드 운영 | 리드 맡아, 세션들 지휘, 워커 띄워서 조율, 승계·머지·릴리스 조율 | tfx-lead |
|
|
60
60
|
| 구현/수정 | 만들어, 고쳐, 구현해, 짜줘, 수정해, 바꿔 | tfx-auto |
|
|
61
|
-
| 리뷰 | 봐줘, 리뷰해, 검토해, 괜찮아? |
|
|
61
|
+
| 리뷰 | 봐줘, 리뷰해, 검토해, 괜찮아? | tfx-review |
|
|
62
62
|
| 분석 | 분석해, 어떻게 돌아가?, 구조가 뭐야 | tfx-auto (`--mode consensus --shape panel`) |
|
|
63
63
|
| 계획 | 계획, 어떻게 하지, 설계해 | superpowers `writing-plans`; TFX 다중모델 계획·실행은 `tfx-auto --mode deep` |
|
|
64
64
|
| 요구사항 명확화 | 요구사항, 인터뷰, 목표 구체화 | host `deep-interview`; 목표 변환은 Claude Code 기본 `/goal` |
|
|
@@ -90,8 +90,6 @@ owner availability를 실제로 검출한 경우에만 `owner unavailable → tf
|
|
|
90
90
|
|
|
91
91
|
> 근거(why): [ADR-0004: 기본 구현 CLI = Codex](../../docs/adr/0004-codex-as-default-cli.md). 이 절이 SSOT(어떻게), ADR은 결정 이력(왜).
|
|
92
92
|
|
|
93
|
-
triflux 본체 개발의 실측 운영 패턴 (v10.18.0 ~ v10.20.2, 2주, 25+ PR) 이 거의 전부 Codex 단독 또는 Codex worker spawn 으로 진행되었다. 이 운영 fact 를 default policy 로 명시한다.
|
|
94
|
-
|
|
95
93
|
| 우선순위 | CLI / 모델 | default 적용 lane |
|
|
96
94
|
|---------|-----------|-------------------|
|
|
97
95
|
| 1차 (default) | **Codex** (프로필 설정 기준) | 구현, 수정, 디버그, 리뷰, 분석, 테스트 작성, 회귀 가드, 릴리즈 prepare |
|
|
@@ -123,7 +121,7 @@ Codex 역할별 프로필의 SSOT는 `scripts/lib/agent-route-policy.mjs`이고,
|
|
|
123
121
|
|
|
124
122
|
## CLI 라우팅
|
|
125
123
|
|
|
126
|
-
`codex exec
|
|
124
|
+
`codex exec`와 `agy --print`를 직접 호출하지 않고 tfx 스킬을 거친다. headless-guard 훅은 제거되었으므로 호출자가 지킨다.
|
|
127
125
|
|
|
128
126
|
**Layer 1: Light** (tfx-route.sh → 단일 CLI)
|
|
129
127
|
|
|
@@ -169,10 +167,8 @@ Codex 역할별 프로필의 SSOT는 `scripts/lib/agent-route-policy.mjs`이고,
|
|
|
169
167
|
|
|
170
168
|
## 충돌 해소
|
|
171
169
|
|
|
172
|
-
- ralph = persist alias
|
|
173
170
|
- "auto" 단독 → tfx-auto. "알아서 해" → autopilot 모드 (위 깊이 수정자)
|
|
174
171
|
- "코드에서 찾아" → Claude 기본 Explore 에이전트. "알아봐" → tfx-research
|
|
175
172
|
- 복합 의도: "구현하고 리뷰까지" → tfx-auto 실행 후 리뷰 결과 확인
|
|
176
173
|
- "합의해서 비교해" 류 요청은 기본적으로 `tfx-auto --mode consensus --shape debate` 로 fold 한다
|
|
177
|
-
- `ralph` 표기는 항상 `--retry ralph` mode
|
|
178
|
-
- 코드 변경 병렬 작업은 작업별 worktree와 세션을 분리하고 각 세션에서 `tfx-auto`로 실행한다.
|
|
174
|
+
- `ralph` 표기는 항상 `--retry ralph` mode를 지칭한다. `--retry auto-escalate`와 동시에 쓸 수 없다(escalation-chain.md 규약).
|