triflux 10.0.0 → 10.0.2

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.
Files changed (426) hide show
  1. package/CLAUDE.md +171 -0
  2. package/README.md +32 -15
  3. package/bin/triflux.mjs +62 -5
  4. package/hooks/agent-route-guard.mjs +109 -0
  5. package/hooks/cross-review-tracker.mjs +122 -0
  6. package/hooks/error-context.mjs +148 -0
  7. package/hooks/hook-adaptive-collector.mjs +86 -0
  8. package/hooks/hook-manager.mjs +365 -0
  9. package/hooks/hook-orchestrator.mjs +312 -0
  10. package/hooks/hook-registry.json +246 -0
  11. package/hooks/hooks.json +89 -0
  12. package/hooks/keyword-rules.json +574 -0
  13. package/hooks/lib/resolve-root.mjs +59 -0
  14. package/hooks/mcp-config-watcher.mjs +80 -0
  15. package/hooks/pipeline-stop.mjs +76 -0
  16. package/hooks/safety-guard.mjs +169 -0
  17. package/hooks/subagent-verifier.mjs +80 -0
  18. package/hub/account-broker.mjs +251 -0
  19. package/hub/adaptive-diagnostic.mjs +323 -0
  20. package/hub/adaptive-inject.mjs +186 -0
  21. package/hub/adaptive-memory.mjs +163 -0
  22. package/hub/adaptive.mjs +143 -0
  23. package/hub/assign-callbacks.mjs +133 -0
  24. package/hub/bridge.mjs +799 -0
  25. package/hub/cli-adapter-base.mjs +280 -0
  26. package/hub/codex-adapter.mjs +199 -0
  27. package/hub/codex-compat.mjs +11 -0
  28. package/hub/codex-preflight.mjs +166 -0
  29. package/hub/delegator/contracts.mjs +37 -0
  30. package/hub/delegator/index.mjs +14 -0
  31. package/hub/delegator/schema/delegator-tools.schema.json +250 -0
  32. package/hub/delegator/service.mjs +307 -0
  33. package/hub/delegator/tool-definitions.mjs +35 -0
  34. package/hub/fullcycle.mjs +96 -0
  35. package/hub/gemini-adapter.mjs +180 -0
  36. package/hub/hitl.mjs +143 -0
  37. package/hub/intent.mjs +193 -0
  38. package/hub/lib/cache-guard.mjs +114 -0
  39. package/hub/lib/known-errors.json +72 -0
  40. package/hub/lib/memory-store.mjs +748 -0
  41. package/hub/lib/process-utils.mjs +361 -0
  42. package/hub/lib/ssh-command.mjs +211 -0
  43. package/hub/lib/ssh-retry.mjs +59 -0
  44. package/hub/lib/uuidv7.mjs +44 -0
  45. package/hub/memory-doctor.mjs +480 -0
  46. package/hub/middleware/request-logger.mjs +161 -0
  47. package/hub/paths.mjs +30 -0
  48. package/hub/pipe.mjs +664 -0
  49. package/hub/pipeline/gates/confidence.mjs +56 -0
  50. package/hub/pipeline/gates/consensus.mjs +94 -0
  51. package/hub/pipeline/gates/index.mjs +5 -0
  52. package/hub/pipeline/gates/selfcheck.mjs +82 -0
  53. package/hub/pipeline/index.mjs +318 -0
  54. package/hub/pipeline/state.mjs +191 -0
  55. package/hub/pipeline/transitions.mjs +124 -0
  56. package/hub/platform.mjs +225 -0
  57. package/hub/public/dashboard.html +355 -0
  58. package/hub/public/tray-icon.ico +0 -0
  59. package/hub/public/tray-icon.png +0 -0
  60. package/hub/quality/deslop.mjs +253 -0
  61. package/hub/reflexion.mjs +372 -0
  62. package/hub/research.mjs +146 -0
  63. package/hub/router.mjs +791 -0
  64. package/hub/routing/complexity.mjs +166 -0
  65. package/hub/routing/index.mjs +117 -0
  66. package/hub/routing/q-learning.mjs +336 -0
  67. package/hub/schema.sql +148 -0
  68. package/hub/server.mjs +1264 -0
  69. package/hub/session-fingerprint.mjs +352 -0
  70. package/hub/state.mjs +258 -0
  71. package/hub/store-adapter.mjs +118 -0
  72. package/hub/store.mjs +857 -0
  73. package/hub/team/agent-map.json +11 -0
  74. package/hub/team/ansi.mjs +379 -0
  75. package/hub/team/backend.mjs +90 -0
  76. package/hub/team/cli/commands/attach.mjs +37 -0
  77. package/hub/team/cli/commands/control.mjs +43 -0
  78. package/hub/team/cli/commands/debug.mjs +74 -0
  79. package/hub/team/cli/commands/focus.mjs +53 -0
  80. package/hub/team/cli/commands/interrupt.mjs +36 -0
  81. package/hub/team/cli/commands/kill.mjs +37 -0
  82. package/hub/team/cli/commands/list.mjs +24 -0
  83. package/hub/team/cli/commands/send.mjs +37 -0
  84. package/hub/team/cli/commands/start/index.mjs +106 -0
  85. package/hub/team/cli/commands/start/parse-args.mjs +130 -0
  86. package/hub/team/cli/commands/start/start-headless.mjs +109 -0
  87. package/hub/team/cli/commands/start/start-in-process.mjs +40 -0
  88. package/hub/team/cli/commands/start/start-mux.mjs +73 -0
  89. package/hub/team/cli/commands/start/start-wt.mjs +69 -0
  90. package/hub/team/cli/commands/status.mjs +87 -0
  91. package/hub/team/cli/commands/stop.mjs +31 -0
  92. package/hub/team/cli/commands/task.mjs +30 -0
  93. package/hub/team/cli/commands/tasks.mjs +13 -0
  94. package/hub/team/cli/help.mjs +42 -0
  95. package/hub/team/cli/index.mjs +41 -0
  96. package/hub/team/cli/manifest.mjs +29 -0
  97. package/hub/team/cli/render.mjs +30 -0
  98. package/hub/team/cli/services/attach-fallback.mjs +54 -0
  99. package/hub/team/cli/services/hub-client.mjs +227 -0
  100. package/hub/team/cli/services/member-selector.mjs +30 -0
  101. package/hub/team/cli/services/native-control.mjs +117 -0
  102. package/hub/team/cli/services/runtime-mode.mjs +62 -0
  103. package/hub/team/cli/services/state-store.mjs +48 -0
  104. package/hub/team/cli/services/task-model.mjs +30 -0
  105. package/hub/team/conductor-mesh-bridge.mjs +121 -0
  106. package/hub/team/conductor.mjs +671 -0
  107. package/hub/team/dashboard-anchor.mjs +14 -0
  108. package/hub/team/dashboard-layout.mjs +33 -0
  109. package/hub/team/dashboard-open.mjs +153 -0
  110. package/hub/team/dashboard.mjs +274 -0
  111. package/hub/team/event-log.mjs +76 -0
  112. package/hub/team/handoff.mjs +303 -0
  113. package/hub/team/headless.mjs +1156 -0
  114. package/hub/team/health-probe.mjs +272 -0
  115. package/hub/team/launcher-template.mjs +95 -0
  116. package/hub/team/lead-control.mjs +104 -0
  117. package/hub/team/native-supervisor.mjs +392 -0
  118. package/hub/team/native.mjs +649 -0
  119. package/hub/team/nativeProxy.mjs +688 -0
  120. package/hub/team/notify.mjs +293 -0
  121. package/hub/team/orchestrator.mjs +161 -0
  122. package/hub/team/pane.mjs +153 -0
  123. package/hub/team/process-cleanup.mjs +342 -0
  124. package/hub/team/psmux.mjs +1354 -0
  125. package/hub/team/remote-probe.mjs +276 -0
  126. package/hub/team/remote-session.mjs +299 -0
  127. package/hub/team/remote-watcher.mjs +478 -0
  128. package/hub/team/routing.mjs +223 -0
  129. package/hub/team/session-sync.mjs +169 -0
  130. package/hub/team/session.mjs +611 -0
  131. package/hub/team/shared.mjs +13 -0
  132. package/hub/team/staleState.mjs +361 -0
  133. package/hub/team/swarm-hypervisor.mjs +589 -0
  134. package/hub/team/swarm-locks.mjs +204 -0
  135. package/hub/team/swarm-planner.mjs +260 -0
  136. package/hub/team/swarm-reconciler.mjs +137 -0
  137. package/hub/team/tui-lite.mjs +380 -0
  138. package/hub/team/tui-remote-adapter.mjs +393 -0
  139. package/hub/team/tui-viewer.mjs +463 -0
  140. package/hub/team/tui.mjs +1449 -0
  141. package/hub/team/worktree-lifecycle.mjs +193 -0
  142. package/hub/team/wt-manager.mjs +407 -0
  143. package/hub/team/wt-templates.json +43 -0
  144. package/hub/team-bridge.mjs +27 -0
  145. package/hub/token-mode.mjs +224 -0
  146. package/hub/tools.mjs +636 -0
  147. package/hub/tray.mjs +376 -0
  148. package/hub/workers/claude-worker.mjs +475 -0
  149. package/hub/workers/codex-mcp.mjs +507 -0
  150. package/hub/workers/delegator-mcp.mjs +1076 -0
  151. package/hub/workers/factory.mjs +21 -0
  152. package/hub/workers/gemini-worker.mjs +374 -0
  153. package/hub/workers/interface.mjs +52 -0
  154. package/hub/workers/worker-utils.mjs +104 -0
  155. package/hud/colors.mjs +88 -0
  156. package/hud/constants.mjs +88 -0
  157. package/hud/context-monitor.mjs +403 -0
  158. package/hud/hud-qos-status.mjs +210 -0
  159. package/hud/providers/claude.mjs +314 -0
  160. package/hud/providers/codex.mjs +151 -0
  161. package/hud/providers/gemini.mjs +320 -0
  162. package/hud/renderers.mjs +442 -0
  163. package/hud/terminal.mjs +140 -0
  164. package/hud/utils.mjs +313 -0
  165. package/mesh/index.mjs +63 -0
  166. package/mesh/mesh-budget.mjs +128 -0
  167. package/mesh/mesh-heartbeat.mjs +100 -0
  168. package/mesh/mesh-protocol.mjs +96 -0
  169. package/mesh/mesh-queue.mjs +165 -0
  170. package/mesh/mesh-registry.mjs +78 -0
  171. package/mesh/mesh-router.mjs +76 -0
  172. package/package.json +8 -1
  173. package/references/hosts.json +33 -0
  174. package/scripts/__tests__/gen-skill-docs.test.mjs +87 -0
  175. package/scripts/__tests__/keyword-detector.test.mjs +234 -0
  176. package/scripts/__tests__/mcp-guard-engine.test.mjs +118 -0
  177. package/scripts/__tests__/remote-spawn-transfer.test.mjs +117 -0
  178. package/scripts/__tests__/remote-spawn.test.mjs +92 -0
  179. package/scripts/__tests__/skill-template.test.mjs +193 -0
  180. package/scripts/__tests__/smoke.test.mjs +34 -0
  181. package/scripts/cache-buildup.mjs +30 -0
  182. package/scripts/cache-doctor.mjs +149 -0
  183. package/scripts/cache-warmup.mjs +557 -0
  184. package/scripts/claudemd-sync.mjs +148 -0
  185. package/scripts/cli-route.sh +3 -0
  186. package/scripts/completions/tfx.bash +47 -0
  187. package/scripts/completions/tfx.fish +44 -0
  188. package/scripts/completions/tfx.zsh +83 -0
  189. package/scripts/cross-review-gate.mjs +126 -0
  190. package/scripts/cross-review-tracker.mjs +238 -0
  191. package/scripts/gen-skill-docs.mjs +111 -0
  192. package/scripts/headless-guard-fast.sh +21 -0
  193. package/scripts/headless-guard.mjs +360 -0
  194. package/scripts/hub-ensure.mjs +120 -0
  195. package/scripts/keyword-detector.mjs +272 -0
  196. package/scripts/keyword-rules-expander.mjs +521 -0
  197. package/scripts/lib/claudemd-scanner.mjs +218 -0
  198. package/scripts/lib/context.mjs +67 -0
  199. package/scripts/lib/cross-review-utils.mjs +51 -0
  200. package/scripts/lib/env-probe.mjs +241 -0
  201. package/scripts/lib/gemini-profiles.mjs +85 -0
  202. package/scripts/lib/handoff.mjs +171 -0
  203. package/scripts/lib/hook-utils.mjs +14 -0
  204. package/scripts/lib/keyword-rules.mjs +166 -0
  205. package/scripts/lib/logger.mjs +105 -0
  206. package/scripts/lib/mcp-filter.mjs +739 -0
  207. package/scripts/lib/mcp-guard-engine.mjs +954 -0
  208. package/scripts/lib/mcp-manifest.mjs +79 -0
  209. package/scripts/lib/mcp-server-catalog.mjs +118 -0
  210. package/scripts/lib/psmux-info.mjs +119 -0
  211. package/scripts/lib/remote-spawn-transfer.mjs +196 -0
  212. package/scripts/lib/skill-template.mjs +326 -0
  213. package/scripts/mcp-check.mjs +237 -0
  214. package/scripts/mcp-cleanup.ps1 +17 -0
  215. package/scripts/mcp-gateway-config.mjs +207 -0
  216. package/scripts/mcp-gateway-ensure.mjs +85 -0
  217. package/scripts/mcp-gateway-integration-test.mjs +228 -0
  218. package/scripts/mcp-gateway-start.mjs +226 -0
  219. package/scripts/mcp-gateway-start.ps1 +141 -0
  220. package/scripts/mcp-gateway-verify.mjs +77 -0
  221. package/scripts/mcp-safety-guard.mjs +44 -0
  222. package/scripts/notion-read.mjs +556 -0
  223. package/scripts/pack.mjs +295 -0
  224. package/scripts/preflight-cache.mjs +69 -0
  225. package/scripts/preinstall.mjs +96 -0
  226. package/scripts/remote-spawn.mjs +1376 -0
  227. package/scripts/run.cjs +79 -0
  228. package/scripts/session-spawn-helper.mjs +185 -0
  229. package/scripts/setup.mjs +1178 -0
  230. package/scripts/test-lock.mjs +71 -0
  231. package/scripts/test-tfx-route-no-claude-native.mjs +57 -0
  232. package/scripts/tfx-batch-stats.mjs +96 -0
  233. package/scripts/tfx-gate-activate.mjs +89 -0
  234. package/scripts/tfx-route-post.mjs +505 -0
  235. package/scripts/tfx-route-worker.mjs +223 -0
  236. package/scripts/tfx-route.sh +2014 -0
  237. package/scripts/tmp-cleanup.mjs +103 -0
  238. package/scripts/token-snapshot.mjs +575 -0
  239. package/skills/tfx-auto/SKILL.md.tmpl +2 -3
  240. package/skills/tfx-autoresearch/SKILL.md +6 -5
  241. package/skills/tfx-codex/SKILL.md.tmpl +2 -3
  242. package/skills/tfx-codex-swarm-workspace/iteration-1/benchmark.json +33 -0
  243. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/eval_metadata.json +42 -0
  244. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/grading.json +11 -0
  245. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/outputs/analysis.md +87 -0
  246. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/outputs/classification.md +35 -0
  247. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/outputs/commands.sh +275 -0
  248. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/outputs/routing.md +56 -0
  249. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/with_skill/timing.json +5 -0
  250. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/grading.json +11 -0
  251. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/outputs/analysis.md +92 -0
  252. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/outputs/classification.md +71 -0
  253. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/outputs/commands.sh +264 -0
  254. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/outputs/routing.md +113 -0
  255. package/skills/tfx-codex-swarm-workspace/iteration-1/full-swarm-all-prds/without_skill/timing.json +5 -0
  256. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/eval_metadata.json +32 -0
  257. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/grading.json +9 -0
  258. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/outputs/analysis.md +96 -0
  259. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/outputs/classification.md +38 -0
  260. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/outputs/commands.sh +151 -0
  261. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/outputs/routing.md +51 -0
  262. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/with_skill/timing.json +5 -0
  263. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/grading.json +9 -0
  264. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/outputs/analysis.md +127 -0
  265. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/outputs/classification.md +57 -0
  266. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/outputs/commands.sh +129 -0
  267. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/outputs/routing.md +84 -0
  268. package/skills/tfx-codex-swarm-workspace/iteration-1/implicit-swarm-no-keywords/without_skill/timing.json +5 -0
  269. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/eval_metadata.json +27 -0
  270. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/grading.json +8 -0
  271. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/outputs/analysis.md +98 -0
  272. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/outputs/classification.md +65 -0
  273. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/outputs/commands.sh +123 -0
  274. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/outputs/routing.md +66 -0
  275. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/with_skill/timing.json +5 -0
  276. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/grading.json +8 -0
  277. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/outputs/analysis.md +88 -0
  278. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/outputs/classification.md +40 -0
  279. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/outputs/commands.sh +130 -0
  280. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/outputs/routing.md +61 -0
  281. package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/timing.json +5 -0
  282. package/skills/tfx-deep-interview/SKILL.md +1 -2
  283. package/skills/tfx-plan/SKILL.md.tmpl +2 -3
  284. package/skills/tfx-psmux-rules/SKILL.md +11 -2
  285. package/skills/tfx-qa/SKILL.md.tmpl +2 -3
  286. package/skills/tfx-remote-spawn/SKILL.md +8 -11
  287. package/skills/tfx-research/SKILL.md.tmpl +2 -3
  288. package/skills/tfx-review/SKILL.md.tmpl +2 -3
  289. package/skills/tfx-workspace/async-tests/run-tests.sh +203 -0
  290. package/skills/tfx-workspace/evals/evals.json +79 -0
  291. package/skills/tfx-workspace/iteration-1/benchmark.json +162 -0
  292. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/eval_metadata.json +11 -0
  293. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/old_skill/grading.json +9 -0
  294. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/old_skill/outputs/analysis.md +154 -0
  295. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/old_skill/timing.json +5 -0
  296. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/with_skill/grading.json +9 -0
  297. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/with_skill/outputs/analysis.md +126 -0
  298. package/skills/tfx-workspace/iteration-1/codex-gemini-remap/with_skill/timing.json +5 -0
  299. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/eval_metadata.json +11 -0
  300. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/old_skill/grading.json +9 -0
  301. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/old_skill/outputs/analysis.md +119 -0
  302. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/old_skill/timing.json +5 -0
  303. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/with_skill/grading.json +9 -0
  304. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/with_skill/outputs/analysis.md +115 -0
  305. package/skills/tfx-workspace/iteration-1/doctor-diagnosis/with_skill/timing.json +5 -0
  306. package/skills/tfx-workspace/iteration-1/hub-start-sequence/eval_metadata.json +10 -0
  307. package/skills/tfx-workspace/iteration-1/hub-start-sequence/old_skill/grading.json +8 -0
  308. package/skills/tfx-workspace/iteration-1/hub-start-sequence/old_skill/outputs/analysis.md +86 -0
  309. package/skills/tfx-workspace/iteration-1/hub-start-sequence/old_skill/timing.json +5 -0
  310. package/skills/tfx-workspace/iteration-1/hub-start-sequence/with_skill/grading.json +8 -0
  311. package/skills/tfx-workspace/iteration-1/hub-start-sequence/with_skill/outputs/analysis.md +81 -0
  312. package/skills/tfx-workspace/iteration-1/hub-start-sequence/with_skill/timing.json +5 -0
  313. package/skills/tfx-workspace/iteration-1/multi-team-creation/eval_metadata.json +12 -0
  314. package/skills/tfx-workspace/iteration-1/multi-team-creation/old_skill/grading.json +10 -0
  315. package/skills/tfx-workspace/iteration-1/multi-team-creation/old_skill/outputs/analysis.md +316 -0
  316. package/skills/tfx-workspace/iteration-1/multi-team-creation/old_skill/timing.json +5 -0
  317. package/skills/tfx-workspace/iteration-1/multi-team-creation/with_skill/grading.json +10 -0
  318. package/skills/tfx-workspace/iteration-1/multi-team-creation/with_skill/outputs/analysis.md +352 -0
  319. package/skills/tfx-workspace/iteration-1/multi-team-creation/with_skill/timing.json +5 -0
  320. package/skills/tfx-workspace/iteration-1/review.html +1325 -0
  321. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/eval_metadata.json +12 -0
  322. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/old_skill/grading.json +10 -0
  323. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/old_skill/outputs/analysis.md +97 -0
  324. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/old_skill/timing.json +5 -0
  325. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/with_skill/grading.json +10 -0
  326. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/with_skill/outputs/analysis.md +94 -0
  327. package/skills/tfx-workspace/iteration-1/routing-implement-shortcut/with_skill/timing.json +5 -0
  328. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/eval_metadata.json +12 -0
  329. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/old_skill/grading.json +10 -0
  330. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/old_skill/outputs/analysis.md +209 -0
  331. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/old_skill/timing.json +5 -0
  332. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/with_skill/grading.json +10 -0
  333. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/with_skill/outputs/analysis.md +193 -0
  334. package/skills/tfx-workspace/iteration-1/routing-multi-task-triage/with_skill/timing.json +5 -0
  335. package/skills/tfx-workspace/iteration-2/benchmark.json +62 -0
  336. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/eval_metadata.json +13 -0
  337. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/old_skill/grading.json +11 -0
  338. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/old_skill/outputs/analysis.md +382 -0
  339. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/old_skill/timing.json +5 -0
  340. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/with_skill/grading.json +11 -0
  341. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/with_skill/outputs/analysis.md +333 -0
  342. package/skills/tfx-workspace/iteration-2/multi-team-creation-refactored/with_skill/timing.json +5 -0
  343. package/skills/tfx-workspace/iteration-2/review.html +1325 -0
  344. package/skills/tfx-workspace/skill-snapshot/tfx-auto/SKILL.md +217 -0
  345. package/skills/{tfx-auto-codex/SKILL.md.tmpl → tfx-workspace/skill-snapshot/tfx-auto-codex/SKILL.md} +3 -31
  346. package/skills/tfx-workspace/skill-snapshot/tfx-codex/SKILL.md +65 -0
  347. package/skills/tfx-workspace/skill-snapshot/tfx-doctor/SKILL.md +94 -0
  348. package/skills/{tfx-gemini/SKILL.md.tmpl → tfx-workspace/skill-snapshot/tfx-gemini/SKILL.md} +6 -14
  349. package/skills/tfx-workspace/skill-snapshot/tfx-hub/SKILL.md +133 -0
  350. package/skills/tfx-workspace/skill-snapshot/tfx-multi/SKILL.md +426 -0
  351. package/skills/tfx-workspace/skill-snapshot/tfx-setup/SKILL.md +101 -0
  352. package/skills/merge-worktree/SKILL.md.tmpl +0 -144
  353. package/skills/shared/arguments-processing.md +0 -2
  354. package/skills/shared/mandatory-rules.md +0 -6
  355. package/skills/shared/telemetry-segment.md +0 -6
  356. package/skills/star-prompt/SKILL.md.tmpl +0 -122
  357. package/skills/tfx-analysis/SKILL.md.tmpl +0 -106
  358. package/skills/tfx-analysis/skill.json +0 -11
  359. package/skills/tfx-auto/skill.json +0 -26
  360. package/skills/tfx-auto-codex/skill.json +0 -8
  361. package/skills/tfx-autopilot/SKILL.md.tmpl +0 -115
  362. package/skills/tfx-autopilot/skill.json +0 -10
  363. package/skills/tfx-autoresearch/SKILL.md.tmpl +0 -135
  364. package/skills/tfx-autoresearch/skill.json +0 -14
  365. package/skills/tfx-autoroute/SKILL.md.tmpl +0 -188
  366. package/skills/tfx-autoroute/skill.json +0 -12
  367. package/skills/tfx-codex/skill.json +0 -8
  368. package/skills/tfx-codex-swarm/SKILL.md.tmpl +0 -16
  369. package/skills/tfx-codex-swarm/skill.json +0 -5
  370. package/skills/tfx-consensus/SKILL.md.tmpl +0 -145
  371. package/skills/tfx-consensus/skill.json +0 -8
  372. package/skills/tfx-debate/SKILL.md.tmpl +0 -191
  373. package/skills/tfx-debate/skill.json +0 -12
  374. package/skills/tfx-deep-analysis/SKILL.md.tmpl +0 -227
  375. package/skills/tfx-deep-analysis/skill.json +0 -10
  376. package/skills/tfx-deep-interview/SKILL.md.tmpl +0 -203
  377. package/skills/tfx-deep-interview/skill.json +0 -12
  378. package/skills/tfx-deep-plan/SKILL.md.tmpl +0 -281
  379. package/skills/tfx-deep-plan/skill.json +0 -13
  380. package/skills/tfx-deep-qa/SKILL.md.tmpl +0 -164
  381. package/skills/tfx-deep-qa/skill.json +0 -11
  382. package/skills/tfx-deep-research/SKILL.md.tmpl +0 -216
  383. package/skills/tfx-deep-research/skill.json +0 -14
  384. package/skills/tfx-deep-review/SKILL.md.tmpl +0 -178
  385. package/skills/tfx-deep-review/skill.json +0 -12
  386. package/skills/tfx-doctor/SKILL.md.tmpl +0 -172
  387. package/skills/tfx-doctor/skill.json +0 -8
  388. package/skills/tfx-find/skill.json +0 -12
  389. package/skills/tfx-forge/SKILL.md.tmpl +0 -187
  390. package/skills/tfx-forge/skill.json +0 -12
  391. package/skills/tfx-fullcycle/SKILL.md.tmpl +0 -285
  392. package/skills/tfx-fullcycle/skill.json +0 -11
  393. package/skills/tfx-gemini/skill.json +0 -8
  394. package/skills/tfx-hooks/SKILL.md.tmpl +0 -216
  395. package/skills/tfx-hooks/skill.json +0 -8
  396. package/skills/tfx-hub/SKILL.md.tmpl +0 -212
  397. package/skills/tfx-hub/skill.json +0 -8
  398. package/skills/tfx-index/skill.json +0 -11
  399. package/skills/tfx-interview/SKILL.md.tmpl +0 -284
  400. package/skills/tfx-interview/skill.json +0 -12
  401. package/skills/tfx-multi/SKILL.md.tmpl +0 -183
  402. package/skills/tfx-multi/skill.json +0 -8
  403. package/skills/tfx-panel/SKILL.md.tmpl +0 -188
  404. package/skills/tfx-panel/skill.json +0 -12
  405. package/skills/tfx-persist/SKILL.md.tmpl +0 -269
  406. package/skills/tfx-persist/skill.json +0 -12
  407. package/skills/tfx-plan/skill.json +0 -11
  408. package/skills/tfx-profile/SKILL.md.tmpl +0 -239
  409. package/skills/tfx-profile/skill.json +0 -8
  410. package/skills/tfx-prune/SKILL.md.tmpl +0 -199
  411. package/skills/tfx-prune/skill.json +0 -12
  412. package/skills/tfx-psmux-rules/SKILL.md.tmpl +0 -317
  413. package/skills/tfx-psmux-rules/skill.json +0 -8
  414. package/skills/tfx-qa/skill.json +0 -11
  415. package/skills/tfx-ralph/SKILL.md.tmpl +0 -27
  416. package/skills/tfx-ralph/skill.json +0 -8
  417. package/skills/tfx-remote-setup/SKILL.md.tmpl +0 -576
  418. package/skills/tfx-remote-setup/skill.json +0 -8
  419. package/skills/tfx-remote-spawn/SKILL.md.tmpl +0 -263
  420. package/skills/tfx-remote-spawn/skill.json +0 -9
  421. package/skills/tfx-research/skill.json +0 -13
  422. package/skills/tfx-review/skill.json +0 -11
  423. package/skills/tfx-setup/SKILL.md.tmpl +0 -380
  424. package/skills/tfx-setup/skill.json +0 -8
  425. package/skills/tfx-swarm/SKILL.md.tmpl +0 -154
  426. package/skills/tfx-swarm/skill.json +0 -5
@@ -1,11 +0,0 @@
1
- {
2
- "name": "tfx-plan",
3
- "description": "구현 계획이 필요할 때 사용한다. '계획 세워줘', 'plan', '플랜', '어떻게 구현하지', '태스크 분해', '작업 순서' 같은 요청에 반드시 사용. 기능 구현 전 영향 범위 파악과 태스크 분해가 필요할 때 적극 활용. 작업 분해, 순서 정리, '어떤 순서로', '먼저 뭐 해야', 'breakdown', 'decompose', 'task list' 같은 요청에도 적극 활용. 단순 계획은 이 스킬, 3자 합의 계획은 tfx-deep-plan을 사용.",
4
- "triggers": [
5
- "plan",
6
- "계획",
7
- "플랜",
8
- "설계"
9
- ],
10
- "argument_hint": "<구현할 기능 설명>"
11
- }
@@ -1,239 +0,0 @@
1
- ---
2
- name: tfx-profile
3
- description: >
4
- Codex/Gemini CLI 프로파일·모델 관리 인터랙티브 UI. tfx-route가 사용하는
5
- 프로파일 목록 조회, 모델 변경, effort 조정, 추가/삭제를 AskUserQuestion 기반
6
- 인터랙티브 선택지로 수행합니다.
7
- Use when: codex profile, codex model, gemini profile, gemini model,
8
- 프로파일 변경, 모델 변경, effort 변경, codex 설정, gemini 설정,
9
- profile manager, 프로파일 관리, 어떤 모델, tfx profile
10
- triggers:
11
- - tfx-profile
12
- argument-hint: "[--list] [--codex | --gemini]"
13
- ---
14
-
15
- # tfx-profile — Codex/Gemini 프로파일 매니저
16
-
17
- > CLI 프로파일의 모델/effort를 AskUserQuestion 선택지로 관리합니다.
18
- > Codex(`~/.codex/config.toml`)와 Gemini(`~/.gemini/triflux-profiles.json`) 모두 지원.
19
-
20
- ## 워크플로우
21
-
22
- ### Step 0: CLI 선택
23
-
24
- 인자에 `--codex` 또는 `--gemini`가 있으면 해당 CLI로 직행.
25
- 없으면 AskUserQuestion으로 선택:
26
-
27
- ```
28
- question: "어느 CLI의 프로파일을 관리하시겠습니까?"
29
- header: "CLI"
30
- options:
31
- - label: "Codex"
32
- description: "~/.codex/config.toml (TOML)"
33
- - label: "Gemini"
34
- description: "~/.gemini/triflux-profiles.json (JSON)"
35
- ```
36
-
37
- ---
38
-
39
- ## Codex 워크플로우
40
-
41
- ### Step 1: config.toml 읽기 + 현재 상태 표시
42
-
43
- `~/.codex/config.toml`을 Read 도구로 읽고 프로파일 테이블을 마크다운으로 출력한다:
44
-
45
- ```
46
- | 프로파일 | 모델 | Effort |
47
- |----------|------|--------|
48
- | fast | gpt-5.3-codex | low |
49
- | ... | ... | ... |
50
- ```
51
-
52
- 기본 모델(top-level `model`)과 기본 effort도 함께 표시.
53
-
54
- ### Step 2: 작업 선택 (AskUserQuestion)
55
-
56
- ```
57
- question: "어떤 작업을 하시겠습니까?"
58
- header: "작업"
59
- options:
60
- - label: "프로파일 모델 변경"
61
- description: "기존 프로파일의 모델/effort를 수정"
62
- - label: "기본 모델 변경"
63
- description: "top-level default 모델/effort 수정"
64
- - label: "프로파일 추가"
65
- description: "새 프로파일 생성"
66
- - label: "프로파일 삭제"
67
- description: "기존 프로파일 제거"
68
- ```
69
-
70
- ### Step 3: 선택에 따른 세부 플로우
71
-
72
- #### 프로파일 모델 변경
73
-
74
- 1. AskUserQuestion으로 프로파일 선택
75
- 2. AskUserQuestion으로 모델 선택:
76
- ```
77
- options:
78
- - label: "gpt-5.4" → 최신 플래그십
79
- - label: "gpt-5.3-codex" → 코딩 특화 (Recommended)
80
- - label: "gpt-5.1-codex-mini" → 경량 Spark
81
- - label: "o3" → 추론 특화
82
- - label: "o4-mini" → 추론 경량
83
- ```
84
- 3. AskUserQuestion으로 effort 선택: `low | medium | high | xhigh`
85
- 4. Edit 도구로 config.toml 수정
86
-
87
- #### 기본 모델 변경
88
-
89
- 위와 동일한 모델/effort 선택 후 top-level `model`, `model_reasoning_effort` 수정.
90
-
91
- #### 프로파일 추가/삭제
92
-
93
- 추가: 이름 → 모델 → effort → `[profiles.name]` 섹션 추가
94
- 삭제: 선택 → 확인 → 섹션 제거
95
-
96
- ### Step 4: 결과 확인
97
-
98
- 변경된 config.toml을 다시 읽어 업데이트된 테이블 표시.
99
-
100
- ---
101
-
102
- ## Gemini 워크플로우
103
-
104
- ### Step 1: triflux-profiles.json 읽기 + 현재 상태 표시
105
-
106
- `~/.gemini/triflux-profiles.json`을 Read 도구로 읽고 프로필 테이블을 마크다운으로 출력한다:
107
-
108
- ```
109
- | 프로필 | 모델 | 설명 |
110
- |--------|------|------|
111
- | pro31 | gemini-3.1-pro-preview | 3.1 Pro — 플래그십 |
112
- | flash3 | gemini-3-flash-preview | 3.0 Flash — 빠른 응답 |
113
- | ... | ... | ... |
114
- ```
115
-
116
- 기본 모델(top-level `model`)도 함께 표시.
117
-
118
- ### Step 2: 작업 선택 (AskUserQuestion)
119
-
120
- ```
121
- question: "어떤 작업을 하시겠습니까?"
122
- header: "작업"
123
- options:
124
- - label: "프로필 모델 변경"
125
- description: "기존 프로필의 모델을 수정"
126
- - label: "기본 모델 변경"
127
- description: "top-level default 모델 수정"
128
- - label: "프로필 추가"
129
- description: "새 프로필 생성"
130
- - label: "프로필 삭제"
131
- description: "기존 프로필 제거"
132
- ```
133
-
134
- ### Step 3: 선택에 따른 세부 플로우
135
-
136
- #### 프로필 모델 변경
137
-
138
- 1. AskUserQuestion으로 프로필 선택
139
- 2. AskUserQuestion으로 모델 선택:
140
- ```
141
- options:
142
- - label: "gemini-3.1-pro-preview" → 3.1 Pro — 플래그십
143
- - label: "gemini-3-flash-preview" → 3.0 Flash — 빠른 응답
144
- - label: "gemini-2.5-pro" → 2.5 Pro — 안정
145
- - label: "gemini-2.5-flash" → 2.5 Flash — 경량
146
- - label: "gemini-2.5-flash-lite" → 2.5 Flash Lite — 최경량
147
- ```
148
- 3. Edit 도구로 triflux-profiles.json 수정
149
-
150
- #### 기본 모델 변경
151
-
152
- 모델 선택 후 top-level `model` 수정.
153
-
154
- #### 프로필 추가/삭제
155
-
156
- 추가: 이름 → 모델 → 설명 → profiles에 추가
157
- 삭제: 선택 → 확인 → profiles에서 제거
158
-
159
- ### Step 4: 결과 확인
160
-
161
- 변경된 JSON을 다시 읽어 업데이트된 테이블 표시.
162
-
163
- ---
164
-
165
- ## 수정 규칙
166
-
167
- ### Codex (config.toml)
168
-
169
- - **백업 필수**: 수정 전 원본 기억
170
- - **프로파일 섹션 형식**: `[profiles.name]\nmodel = "..."\nmodel_reasoning_effort = "..."`
171
- - **다른 섹션 건드리지 않기**: `[notice]`, `[features]`, `[mcp_servers.*]` 등 절대 수정 금지
172
- - **Edit 도구 사용**: old_string → new_string으로 정확한 섹션만 치환
173
-
174
- ### Gemini (triflux-profiles.json)
175
-
176
- - **백업 필수**: `.bak` 자동 생성
177
- - **JSON 형식 유지**: `profiles.{name}.model`, `profiles.{name}.hint`
178
- - **Edit 도구 사용**: old_string → new_string으로 해당 프로필만 치환
179
-
180
- ## 참조
181
-
182
- ### Codex 모델
183
-
184
- | 모델 | 용도 |
185
- |------|------|
186
- | gpt-5.4 | 최신 플래그십 |
187
- | gpt-5.3-codex | 코딩 특화 |
188
- | gpt-5.1-codex-mini | 경량 Spark |
189
- | o3 | 추론 특화 |
190
- | o4-mini | 추론 경량 |
191
-
192
- ### Codex Effort 레벨
193
-
194
- | 레벨 | 설명 |
195
- |------|------|
196
- | low | 빠른 응답, 최소 추론 |
197
- | medium | 균형 잡힌 추론 |
198
- | high | 깊은 추론 |
199
- | xhigh | 최대 추론 (느림) |
200
-
201
- ### Gemini 모델
202
-
203
- | 모델 | 용도 |
204
- |------|------|
205
- | gemini-3.1-pro-preview | 3.1 Pro — 플래그십 (1M ctx) |
206
- | gemini-3-flash-preview | 3.0 Flash — 빠른 응답, 비용 효율 |
207
- | gemini-2.5-pro | 2.5 Pro — 안정 (추론 강화) |
208
- | gemini-2.5-flash | 2.5 Flash — 경량 범용 |
209
- | gemini-2.5-flash-lite | 2.5 Flash Lite — 최경량 |
210
-
211
- ### Gemini → 에이전트 배치 (벤치마크 기반)
212
-
213
- | 프로필 | 모델 | 에이전트 |
214
- |--------|------|----------|
215
- | pro31 | gemini-3.1-pro-preview | executor, debugger, deep-executor, architect, planner, critic, analyst, code-reviewer, security-reviewer, quality-reviewer, scientist-deep, designer |
216
- | flash3 | gemini-3-flash-preview | writer, build-fixer, spark, 기본 폴백 |
217
- | pro25 | gemini-2.5-pro | (예비 — 3.1 불안정 시 폴백) |
218
- | flash25 | gemini-2.5-flash | (예비 — 대량 배치) |
219
- | lite25 | gemini-2.5-flash-lite | (예비 — 최경량) |
220
-
221
- ### 설정 파일 경로
222
-
223
- - Codex: `~/.codex/config.toml`
224
- - Gemini: `~/.gemini/triflux-profiles.json`
225
-
226
- ## 에러 처리
227
-
228
- | 상황 | 처리 |
229
- |------|------|
230
- | config.toml 미존재 | `/tfx-setup` 안내 |
231
- | triflux-profiles.json 미존재 | 기본값으로 자동 생성 |
232
- | 파싱 실패 | 백업 후 수동 수정 안내 |
233
- | 중복 프로파일명 | 이미 존재함 알림, 기존 편집으로 전환 |
234
-
235
- ## standalone TUI
236
-
237
- 터미널에서 직접 실행:
238
- - Codex: `node tui/codex-profile.mjs`
239
- - Gemini: `node tui/gemini-profile.mjs`
@@ -1,8 +0,0 @@
1
- {
2
- "name": "tfx-profile",
3
- "description": "Codex/Gemini CLI 프로파일·모델 관리 인터랙티브 UI. tfx-route가 사용하는 프로파일 목록 조회, 모델 변경, effort 조정, 추가/삭제를 AskUserQuestion 기반 인터랙티브 선택지로 수행합니다. Use when: codex profile, codex model, gemini profile, gemini model, 프로파일 변경, 모델 변경, effort 변경, codex 설정, gemini 설정, profile manager, 프로파일 관리, 어떤 모델, tfx profile",
4
- "triggers": [
5
- "tfx-profile"
6
- ],
7
- "argument_hint": "[--list] [--codex | --gemini]"
8
- }
@@ -1,199 +0,0 @@
1
- ---
2
- name: tfx-prune
3
- description: "AI가 생성한 불필요한 코드(슬롭)를 제거할 때 사용한다. 'deslop', '슬롭 제거', 'anti-slop', '코드 정리', '불필요한 코드 제거', '과잉 추상화 정리' 같은 요청에 반드시 사용. AI 생성 코드의 중복, 불필요 추상화, 과잉 에러 핸들링을 정리할 때 적극 활용."
4
- triggers:
5
- - deslop
6
- - 슬롭 제거
7
- - anti-slop
8
- - 정리
9
- - slop
10
- argument-hint: "[파일 경로 또는 git diff 범위]"
11
- ---
12
-
13
- # tfx-prune — Tri-Verified AI Slop Remover
14
-
15
- > **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
16
- > 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
17
-
18
-
19
- > OMC ai-slop-cleaner 오마주. 핵심 차별점: 단일 판단이 아닌 **3자 독립 감지 + 합의** 기반 제거.
20
- > "AI가 만든 슬롭은 AI 3명이 합의해야 슬롭이다."
21
-
22
- ## HARD RULES
23
-
24
- > headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.
25
-
26
- 1. **`codex exec` / `gemini -p` 직접 호출 절대 금지**
27
- 2. Codex·Gemini → `Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'cli:프롬프트:역할' --timeout 600")` **만** 사용
28
- 3. Claude → `Agent(run_in_background=true)`
29
- 4. Bash + Agent를 같은 메시지에서 동시 호출하여 병렬 실행
30
-
31
- ## MODEL ROLES
32
-
33
- | CLI | 역할 | 감지 관점 |
34
- |-----|------|----------|
35
- | Claude (Opus) | 코드 품질 분석 + 합의 중재 | 설계 원칙, 코드 구조, 불필요 추상화 |
36
- | Codex | AI 슬롭 탐지 | 구현 효율, 중복 패턴, 과잉 에러 핸들링 |
37
- | Gemini | 가독성 평가 | 가독성/DX, 과잉 주석, 과잉 타입 |
38
-
39
- ## 슬롭 카테고리
40
-
41
- | 카테고리 | 설명 | 예시 |
42
- |----------|------|------|
43
- | 불필요 추상화 | 단일 용도인데 인터페이스/팩토리/전략 패턴 적용 | `UserFactory` for 1 user type |
44
- | 중복 코드 | 같은 로직의 반복 | 동일 validation을 3곳에 복붙 |
45
- | 과잉 에러 핸들링 | 발생 불가능한 에러를 처리 | `catch (e) { /* impossible */ }` |
46
- | 과잉 주석 | 코드가 이미 명확한데 주석 | `// increment i by 1` `i++` |
47
- | 과잉 타입 | 불필요하게 복잡한 타입 정의 | 5단계 중첩 제네릭 |
48
- | 사용되지 않는 코드 | import 했지만 사용 안 함 | dead imports, unused variables |
49
- | 과잉 로깅 | 불필요한 console.log/debug | `console.log("here")` |
50
-
51
- ## EXECUTION STEPS
52
-
53
- ### Step 0: 슬롭 제거 범위 선택
54
-
55
- 인자 없이 호출된 경우 사용자에게 범위를 선택받는다:
56
-
57
- ```
58
- 1. 최근 변경 파일만 (git diff)
59
- 2. 전체 프로젝트
60
- 3. 특정 디렉토리 지정
61
- ```
62
-
63
- - 1번 → `git diff HEAD`로 최근 변경 파일 대상
64
- - 2번 → 프로젝트 전체 소스 파일 대상 (대규모 주의 경고 표시)
65
- - 3번 → 추가 AskUserQuestion으로 대상 디렉토리 경로 입력받음
66
-
67
- 파일 경로나 git diff 범위가 인자로 이미 제공된 경우 이 단계를 건너뛴다.
68
-
69
- ### Step 1: 대상 파일 수집
70
-
71
- 대상 결정 우선순위:
72
- 1. 파일 경로 지정 → 해당 파일만
73
- 2. git diff 범위 지정 → diff에 포함된 파일
74
- 3. 입력 없음 → `git diff --name-only HEAD~1`로 최근 변경 파일
75
- 4. "all" → 프로젝트 전체 소스 파일 (주의: 대규모)
76
-
77
- 소스 파일만 필터: `.ts`, `.js`, `.mjs`, `.tsx`, `.py` 등. `node_modules`, `dist`, `build` 제외.
78
-
79
- ### Step 2: 3자 독립 슬롭 감지 (Anti-Herding)
80
-
81
- **아래 2개 도구를 반드시 같은 응답에서 동시에 호출하라.**
82
-
83
- Claude (Agent, background):
84
- ```
85
- Agent(
86
- subagent_type="claude-sonnet-4-5",
87
- model="opus",
88
- run_in_background=true,
89
- prompt="다음 파일에서 AI 슬롭을 감지하세요. 코드 품질 관점으로 분석합니다.
90
- 슬롭 정의: 불필요 추상화, 중복, 과잉 에러핸들링, 과잉 주석, 과잉 타입, 미사용 코드, 과잉 로깅.
91
- 파일: {file_content}
92
- 각 발견에 대해 JSON: [{ id, category, line_start, line_end, description, severity, suggested_fix }]
93
- severity: critical(기능에 영향) | high(가독성 심각) | medium(개선) | low(취향)
94
- 슬롭이 아닌 것은 보고하지 마세요. 과탐(false positive)보다 미탐이 낫습니다."
95
- )
96
- ```
97
-
98
- Codex + Gemini (Bash, background):
99
- ```
100
- Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
101
- --assign 'codex:다음 파일에서 AI 슬롭을 감지하세요. 구현 효율 관점(중복 패턴, 과잉 에러핸들링, 미사용 코드)으로 분석. 파일: {file_content}. JSON: [{id,category,line_start,line_end,description,severity,suggested_fix}]. severity: critical|high|medium|low. 과탐보다 미탐이 낫습니다.:slop-detector' \
102
- --assign 'gemini:다음 파일에서 AI 슬롭을 감지하세요. 가독성/DX 관점(과잉 주석, 과잉 타입, 불필요 추상화)으로 분석. 파일: {file_content}. JSON: [{id,category,line_start,line_end,description,severity,suggested_fix}]. severity: critical|high|medium|low. 과탐보다 미탐이 낫습니다.:readability-reviewer' \
103
- --timeout 600")
104
- ```
105
-
106
- ### Step 3: 합의 필터링
107
-
108
- 3개 CLI 결과를 교차검증한다:
109
-
110
- ```
111
- for each finding in ALL results:
112
- agreement = count(CLIs that found same or similar slop at same location)
113
-
114
- if agreement >= 2:
115
- → "CONFIRMED SLOP" — 제거 대상
116
- elif agreement == 1:
117
- → "UNCONFIRMED" — 제거하지 않음 (과탐 방지)
118
- ```
119
-
120
- 원칙: 2+ 합의된 항목만 제거한다. 1개 CLI만 지적한 항목은 무시한다.
121
-
122
- ### Step 4: 슬롭 제거
123
-
124
- 확정된 슬롭을 안전 순서대로 제거한다:
125
-
126
- 1. 과잉 주석 제거 (가장 안전)
127
- 2. 미사용 코드/import 제거
128
- 3. 과잉 로깅 제거
129
- 4. 과잉 에러핸들링 간소화
130
- 5. 중복 코드 통합
131
- 6. 불필요 추상화 제거 (가장 위험 — 인터페이스 변경 가능)
132
-
133
- 각 제거 후 변경 내용을 기록한다. 제거 이유를 주석으로 남기지 않는다 (그것 자체가 슬롭).
134
-
135
- ### Step 5: 회귀 테스트
136
-
137
- 제거 후 안전성을 검증한다:
138
-
139
- 1. 기존 테스트 실행: `Bash("npm test")` (또는 프로젝트 테스트 명령)
140
- 2. 테스트 실패 시 → 해당 제거를 롤백 → 롤백된 항목을 "위험 — 수동 검토 필요"로 표시
141
- 3. 테스트 통과 시 → 제거 확정
142
-
143
- ### Step 6: 보고서 출력
144
-
145
- ```markdown
146
- ## Deslop 보고서
147
-
148
- ### 요약
149
- | 항목 | 수 |
150
- |------|-----|
151
- | 대상 파일 | {count} |
152
- | 감지 (전체) | {total_findings} |
153
- | 합의 확정 | {confirmed} |
154
- | 미확정 (무시) | {unconfirmed} |
155
- | 제거 완료 | {removed} |
156
- | 롤백 (테스트 실패) | {rolled_back} |
157
-
158
- ### 제거된 슬롭
159
- | # | 파일 | 라인 | 카테고리 | 합의 | 설명 |
160
- |---|------|------|----------|------|------|
161
- | 1 | auth.ts | 42-48 | 과잉 주석 | 3/3 | 자명한 코드에 장문 주석 |
162
- | 2 | utils.ts | 15-20 | 미사용 import | 2/3 | lodash 미사용 |
163
-
164
- ### 미확정 (수동 검토 권장)
165
- | # | 파일 | 라인 | 카테고리 | 지적 CLI | 설명 |
166
- |---|------|------|----------|---------|------|
167
- | 1 | api.ts | 80-95 | 불필요 추상화 | Codex만 | Factory 패턴 필요성 논쟁 |
168
-
169
- ### 테스트 결과
170
- 통과: {pass}/{total} | 실패: {fail} | 롤백: {rollback}
171
- ```
172
-
173
- ## ERROR RECOVERY
174
-
175
- - Codex/Gemini 타임아웃(600s 초과) → Claude Agent 단독으로 2자 합의 기준(단독 감지도 제거 대상) 적용
176
- - 테스트 명령 없음 → Step 5 건너뜀, 보고서에 "테스트 미실행 — 수동 검증 필요" 표시
177
- - 파일 파싱 오류 → 해당 파일 스킵 후 보고서에 "파싱 실패" 기록
178
-
179
- ## TOKEN BUDGET
180
-
181
- | 단계 | 토큰 |
182
- |------|------|
183
- | Step 1 (파일 수집) | ~0.5K |
184
- | Step 2 (3x 독립 감지) | ~6K |
185
- | Step 3 (합의 필터링) | ~1K |
186
- | Step 4 (제거) | ~1.5K |
187
- | Step 5 (회귀 테스트) | ~0.5K |
188
- | Step 6 (보고서) | ~0.5K |
189
- | **총합** | **~10K** |
190
-
191
- ## 사용 예
192
-
193
- ```
194
- /tfx-prune
195
- /tfx-prune src/auth/middleware.ts
196
- /tfx-prune HEAD~5..HEAD
197
- /정리 src/
198
- /anti-slop "과잉 에러 핸들링 제거"
199
- ```
@@ -1,12 +0,0 @@
1
- {
2
- "name": "tfx-prune",
3
- "description": "AI가 생성한 불필요한 코드(슬롭)를 제거할 때 사용한다. 'deslop', '슬롭 제거', 'anti-slop', '코드 정리', '불필요한 코드 제거', '과잉 추상화 정리' 같은 요청에 반드시 사용. AI 생성 코드의 중복, 불필요 추상화, 과잉 에러 핸들링을 정리할 때 적극 활용.",
4
- "triggers": [
5
- "deslop",
6
- "슬롭 제거",
7
- "anti-slop",
8
- "정리",
9
- "slop"
10
- ],
11
- "argument_hint": "[파일 경로 또는 git diff 범위]"
12
- }