triflux 10.0.0 → 10.0.2

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

@@ -1,212 +0,0 @@
----
-name: tfx-hub
-description: >
-  tfx-hub MCP 메시지 버스 관리. CLI 에이전트 간 실시간 통신 허브를 시작/중지/상태확인하고,
-  hub 도메인의 자유형 작업도 처리합니다.
-  Use when: hub, 허브, 메시지 버스, message bus, 브릿지, bridge, MCP 서버 관리, 에이전트 통신
-triggers:
-  - tfx-hub
-argument-hint: "<start|stop|status|자유형 작업 설명>"
----
-
-# tfx-hub — MCP 메시지 버스 관리 + 개방형 작업
-
-> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
-> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
-
-
-> **인프라**: 다른 스킬이 내부적으로 사용. 직접 호출할 필요 없음.
-> CLI 에이전트(Codex/Gemini/Claude) 간 실시간 메시지 허브를 관리합니다.
-> **커맨드 매칭 + fallthrough**: start/stop/status에 매칭되면 즉시 실행,
-> 매칭 안 되면 **hub 도메인 컨텍스트를 활용한 범용 작업**으로 처리합니다.
-
-## 입력 해석 규칙
-
-```
-/tfx-hub start          → 커맨드 매칭 → 허브 시작
-/tfx-hub stop           → 커맨드 매칭 → 허브 중지
-/tfx-hub status         → 커맨드 매칭 → 상태 확인
-/tfx-hub 테스트해줘      → fallthrough → hub 관련 범용 작업으로 처리
-/tfx-hub 문서 저장해     → fallthrough → hub 관련 범용 작업으로 처리
-/tfx-hub 브릿지 분석해   → fallthrough → hub 관련 범용 작업으로 처리
-```
-
-**fallthrough 규칙**: 인자가 start/stop/status/--port 등 커맨드 키워드에 매칭되지 않으면,
-사용자의 입력을 **hub/브릿지/메시지버스 도메인의 자유형 작업**으로 해석한다.
-
-fallthrough 라우팅:
-```bash
-# tfx-route.sh 경유 (권장)
-Bash("bash ~/.claude/scripts/tfx-route.sh {에이전트} '{hub 컨텍스트 + 작업}' {mcp_profile}")
-
-# codex 직접 호출 시 — 반드시 exec 서브커맨드 포함
-Bash("codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
-Bash("codex --profile gpt54_xhigh exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
-#          ↑ --profile은 exec 앞에, --skip-git-repo-check은 exec 뒤에
-
-# Claude 네이티브 (탐색/검증)
-Agent(subagent_type="oh-my-claudecode:explore", prompt="{작업}")
-```
-
-## 커맨드
-
-### start — 허브 시작
-
-```bash
-Bash("node hub/server.mjs", run_in_background=true)
-```
-
-- Streamable HTTP MCP 서버를 `http://127.0.0.1:27888/mcp` 에서 시작
-- SQLite WAL DB: `~/.claude/cache/tfx-hub/state.db`
-- PID 파일: `~/.claude/cache/tfx-hub/hub.pid`
-- 환경변수: `TFX_HUB_PORT` (포트), `TFX_HUB_DB` (DB 경로)
-
-### stop — 허브 중지
-
-```bash
-# PID 파일에서 프로세스 ID 읽어서 종료
-Bash("node -e \"
-  const fs = require('fs');
-  const path = require('path');
-  const pidFile = path.join(require('os').homedir(), '.claude/cache/tfx-hub/hub.pid');
-  if (fs.existsSync(pidFile)) {
-    const info = JSON.parse(fs.readFileSync(pidFile, 'utf8'));
-    process.kill(info.pid, 'SIGTERM');
-    console.log('tfx-hub 종료 (PID ' + info.pid + ')');
-  } else {
-    console.log('tfx-hub 미실행');
-  }
-\"")
-```
-
-### status — 상태 확인
-
-```bash
-# HTTP 상태 엔드포인트 조회
-Bash("curl -s http://127.0.0.1:27888/status 2>/dev/null || echo '{\"error\":\"hub 미실행\"}'")
-```
-
-## 각 CLI 등록 방법
-
-허브 시작 후 각 CLI에 MCP 서버로 등록:
-
-```bash
-# Codex (수동 opt-in 예시)
-# triflux는 config.json을 자동 관리하며, standalone Codex 노이즈 방지를 위해
-# 사전 등록은 disabled로 두고 `tfx hub start` 이후에만 enabled로 전환한다.
-codex mcp add tfx-hub --url http://127.0.0.1:27888/mcp
-
-# Gemini (settings.json)
-# mcpServers.tfx-hub.url = "http://127.0.0.1:27888/mcp"
-
-# Claude
-claude mcp add --transport http tfx-hub http://127.0.0.1:27888/mcp
-```
-
-## MCP 도구 (20개)
-
-### Core — 기본 통신
-
-| 도구 | 설명 |
-|------|------|
-| `register` | 에이전트 등록 + lease 발급 |
-| `status` | 허브/에이전트/큐/트레이스 상태 조회 |
-| `publish` | 이벤트/응답 메시지 발행 (topic fanout 지원) |
-| `ask` | 다른 에이전트에게 질문 (request/reply, await_response_ms 폴링 지원) |
-| `handoff` | 작업 인계 (acceptance_criteria 지정 가능) |
-| `poll_messages` | 수신함에서 메시지 폴링 **(Deprecated — Named Pipe 사용)** |
-
-### Assign — 비차단 작업 할당
-
-| 도구 | 설명 |
-|------|------|
-| `assign_async` | AWS CAO 스타일 비차단 job 생성 + 워커 실시간 전달 |
-| `assign_result` | job 진행/완료 결과 보고 |
-| `assign_status` | job 단건 상태 또는 목록 조회 |
-
-### Team — Claude Native Teams 프록시
-
-| 도구 | 설명 |
-|------|------|
-| `team_info` | Teams 메타/멤버/경로 정보 조회 |
-| `team_task_list` | task 목록 조회 (owner/status 필터) |
-| `team_task_update` | task claim/update |
-| `team_send_message` | Teams inbox에 메시지 append |
-
-### Pipeline — 파이프라인 관리
-
-| 도구 | 설명 |
-|------|------|
-| `pipeline_init` | 새 파이프라인 초기화 |
-| `pipeline_state` | 파이프라인 상태 조회 |
-| `pipeline_advance` | 다음 단계로 전이 (전이 규칙 + fix loop 바운딩) |
-| `pipeline_advance_gated` | HITL 승인 게이트 포함 전이 |
-| `pipeline_list` | 활성 파이프라인 목록 조회 |
-
-### HITL — Human-in-the-Loop
-
-| 도구 | 설명 |
-|------|------|
-| `request_human_input` | 사용자 입력 요청 (CAPTCHA/승인/자격증명/선택/텍스트) |
-| `submit_human_input` | 사용자 입력 응답 (accept/decline/cancel) |
-
-## 브릿지 REST 엔드포인트 (4개)
-
-| 엔드포인트 | 설명 |
-|-----------|------|
-| `POST /bridge/register` | 에이전트 등록 (프로세스 수명 기반 lease) |
-| `POST /bridge/result` | 결과 발행 (topic fanout) |
-| `POST /bridge/context` | 선행 컨텍스트 폴링 (auto_ack) |
-| `POST /bridge/deregister` | 에이전트 offline 마킹 |
-
-## 프로젝트 구조
-
-```
-hub/
-├── server.mjs            # MCP 서버 + REST 브릿지 엔드포인트
-├── store.mjs             # SQLite WAL 상태 저장소
-├── router.mjs            # Actor mailbox 라우터 + QoS
-├── tools.mjs             # MCP 도구 20개 정의
-├── hitl.mjs              # Human-in-the-Loop 매니저
-├── bridge.mjs            # tfx-route.sh ↔ hub 브릿지 CLI
-├── schema.sql            # DB 스키마
-├── paths.mjs             # 경로 상수 (PID 파일, DB 경로 등)
-├── pipe.mjs              # Named Pipe 서버 (push 구독 채널)
-├── assign-callbacks.mjs  # assign job 콜백 처리
-├── intent.mjs            # 인텐트 파싱
-├── reflexion.mjs         # reflexion 루프
-├── research.mjs          # 리서치 프록시
-├── token-mode.mjs        # 토큰 모드 관리
-├── pipeline/             # 파이프라인 엔진
-│   ├── index.mjs         # createPipeline() 팩토리
-│   ├── state.mjs         # 파이프라인 상태 CRUD
-│   ├── transitions.mjs   # 전이 규칙
-│   └── gates/            # HITL 게이트 (selfcheck, confidence)
-├── delegator/            # 작업 위임 레이어
-│   ├── index.mjs
-│   ├── service.mjs
-│   ├── contracts.mjs
-│   └── tool-definitions.mjs
-├── team/                 # Claude Native Teams 통합
-│   ├── nativeProxy.mjs   # Teams MCP 프록시
-│   ├── orchestrator.mjs  # 팀 오케스트레이터
-│   ├── session.mjs       # 세션 관리
-│   ├── dashboard.mjs     # TUI 대시보드
-│   ├── tui.mjs           # TUI 렌더러
-│   └── cli/              # tfx team CLI 커맨드
-├── workers/              # CLI 워커 어댑터
-│   ├── factory.mjs
-│   ├── claude-worker.mjs
-│   ├── codex-mcp.mjs
-│   ├── gemini-worker.mjs
-│   └── delegator-mcp.mjs
-├── middleware/           # 요청 미들웨어
-│   └── request-logger.mjs
-├── quality/              # 품질 검사
-│   └── deslop.mjs
-└── public/               # 정적 자산 (대시보드 HTML, 트레이 아이콘)
-```
-
-## 상태
-
-**dev 전용** — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.

package/skills/tfx-hub/skill.json

@@ -1,8 +0,0 @@
-{
-  "name": "tfx-hub",
-  "description": "tfx-hub MCP 메시지 버스 관리. CLI 에이전트 간 실시간 통신 허브를 시작/중지/상태확인하고, hub 도메인의 자유형 작업도 처리합니다. Use when: hub, 허브, 메시지 버스, message bus, 브릿지, bridge, MCP 서버 관리, 에이전트 통신",
-  "triggers": [
-    "tfx-hub"
-  ],
-  "argument_hint": "<start|stop|status|자유형 작업 설명>"
-}

package/skills/tfx-index/skill.json

@@ -1,11 +0,0 @@
-{
-  "name": "tfx-index",
-  "description": "프로젝트 구조를 빠르게 파악하거나 토큰을 절약할 때 사용한다. '인덱싱', '프로젝트 구조', '인덱스 만들어', '코드베이스 맵', '프로젝트 개요' 같은 요청에 사용. 새 프로젝트 온보딩, 세션 시작 시 컨텍스트 효율화에 적극 활용.",
-  "triggers": [
-    "인덱싱",
-    "프로젝트 인덱스",
-    "인덱스",
-    "tfx-index"
-  ],
-  "argument_hint": "[--update] [경로]"
-}

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

@@ -1,284 +0,0 @@
----
-name: tfx-interview
-description: "요구사항이 모호하거나 구현 전 명확화가 필요할 때 사용한다. 'interview', '인터뷰', '요구사항 정리', '뭘 만들어야 하는지 모르겠어', '명확하게 해줘' 같은 요청에 반드시 사용. 구현 시작 전 스펙을 확정하고 싶을 때 적극 활용."
-triggers:
-  - interview
-  - 인터뷰
-  - 요구사항 탐색
-  - tfx-interview
-  - 모호성 분석
-argument-hint: "<구현할 주제 또는 요구사항>"
----
-
-# tfx-interview — Quantified Socratic Requirements Exploration
-
-> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
-> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
-
-
-> OMC deep-interview + ouroboros 오마주. 모호성을 숫자로 측정하고 20% 미만까지 질문한다.
-> "측정할 수 없으면 개선할 수 없다."
->
-> **Gemini 위임**: 분석·점수 계산·산출물 초안은 Gemini CLI에 위임하여 Claude 토큰을 절약한다.
-> 위임 패턴: `Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")`
-
-## 위임 패턴
-
-Claude와 Gemini의 역할을 분리하여 토큰을 최적화한다.
-
-| 담당 | 작업 |
-|------|------|
-| **Claude** | AskUserQuestion (사용자 상호작용), 최종 파일 저장 |
-| **Gemini** | 모호성 점수 계산, 질문 생성, 응답 분석, 산출물 초안 |
-
-```bash
-# 위임 호출 형태
-Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")
-```
-
-Gemini 실패 시 Fallback: Claude Opus가 분석을 직접 처리한다.
-
-## 용도
-
-- 구현 전 요구사항 명확화
-- 모호한 요청을 정량적으로 분석하여 실행 가능한 수준으로 구체화
-- 빠진 제약 조건, 성공 기준, 경계 조건을 체계적으로 발견
-- 과잉 구현/과소 구현 방지
-
-## 핵심: 모호성 점수 (Ambiguity Score)
-
-요구사항의 모호성을 수학적으로 측정한다:
-
-```
-ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
-
-각 요소 (0.0 ~ 1.0):
-  goal       — 목표 명확도. "무엇을 달성하려는가?"가 명확한가?
-  constraints — 제약 조건 명확도. 범위, 기술 스택, 시간, 호환성 등
-  criteria   — 성공 기준 명확도. "어떻게 되면 완료인가?"
-
-예시:
-  입력: "인증 기능 추가해"
-  goal = 0.5 (인증이 무슨 인증? OAuth? JWT? 세션?)
-  constraints = 0.2 (기술 스택? 기존 시스템 연동?)
-  criteria = 0.1 (테스트? 성능? 보안 수준?)
-  ambiguity = 1 - (0.5×0.40 + 0.2×0.30 + 0.1×0.30) = 1 - 0.29 = 0.71 (71%)
-
-목표: ambiguity < 0.20 (20% 미만)이 될 때까지 질문 반복.
-```
-
-## 워크플로우
-
-### Step 1: 초기 모호성 평가
-
-사용자 입력을 Gemini에 전달하여 초기 ambiguity score를 계산한다:
-
-```bash
-# Claude → Gemini 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Analyze the following requirement and calculate ambiguity score. Return JSON: {goal, constraints, criteria, ambiguity, suggested_questions}: {user_input}'")
-```
-
-Gemini가 반환한 JSON에서 점수를 읽어 사용자에게 표시한다:
-
-```
-출력 예시:
-  "📊 현재 모호성: 71%
-   - 목표: 50% 명확 (어떤 인증 방식?)
-   - 제약: 20% 명확 (기술 스택 미정)
-   - 기준: 10% 명확 (완료 조건 없음)
-   → Stage 1: Clarify부터 시작합니다."
-```
-
-### Step 2: 5단계 인터뷰 (모호성 < 20%까지)
-
-각 단계에서 Claude가 AskUserQuestion으로 질문하고, 사용자 응답을 Gemini에 전달하여 분석 및 다음 질문을 생성한다.
-
-흐름: `Claude(질문) → 사용자(응답) → Gemini(분석+재계산) → Claude(다음 질문 제시)`
-
-#### Stage 1: Clarify (명확화) — goal 개선
-
-```
-질문 방향:
-  - "정확히 무엇을 달성하려는가?"
-  - "이 작업의 범위는 어디까지인가?"
-  - "완료 후 어떤 상태가 되어야 하는가?"
-```
-
-```bash
-# 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
-```
-
-```
-응답 후: Gemini JSON에서 goal 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
-```
-
-#### Stage 2: Decompose (분해) — constraints 개선
-
-```
-질문 방향:
-  - "이것을 어떤 하위 문제로 나눌 수 있는가?"
-  - "기술적 제약 조건은? (스택, 호환성, 성능)"
-  - "의존하는 외부 시스템이나 API는?"
-```
-
-```bash
-# 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
-```
-
-```
-응답 후: Gemini JSON에서 constraints 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
-```
-
-#### Stage 3: Challenge (반론) — 숨은 제약 발견
-
-```
-질문 방향:
-  - "이 접근의 약점은?"
-  - "실패할 수 있는 시나리오는?"
-  - "6개월 후 유지보수 관점에서 문제될 부분은?"
-```
-
-```bash
-# 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
-```
-
-```
-응답 후: Gemini JSON에서 constraints + criteria 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
-```
-
-#### Stage 4: Alternatives (대안) — criteria 정밀화
-
-```
-질문 방향:
-  - "다른 방법은 없는가?"
-  - "시간이 절반이라면 어떤 방식을 택하겠는가?"
-  - "각 대안의 trade-off는?"
-```
-
-```bash
-# 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
-```
-
-```
-응답 후: Gemini JSON에서 criteria 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
-```
-
-#### Stage 5: Synthesize (종합) — 최종 확인
-
-```
-질문 방향:
-  - "지금까지의 논의를 종합하면 최적 경로는?"
-  - "첫 번째로 실행할 단계는?"
-  - "이 결정에 대한 확신도는? (1-10)"
-```
-
-```bash
-# 응답 수집 후 Gemini에 최종 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 5 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
-```
-
-```
-응답 후: Gemini JSON에서 전체 점수 읽기 → 최종 ambiguity score 사용자에게 표시
-```
-
-### Step 3: 조기 종료 판단
-
-매 질문 후 ambiguity를 재계산하고, < 20%이면 남은 단계를 건너뛰고 종합 단계로 이동한다:
-
-```
-질문 후 재계산:
-  if ambiguity < 0.20:
-    → "📊 모호성 {score}% — 충분히 명확합니다. 종합 단계로 이동합니다."
-    → Step 4로 직행
-  elif ambiguity < 0.40:
-    → "📊 모호성 {score}% — 거의 명확합니다. 핵심 질문 1-2개만 더."
-  else:
-    → 다음 단계 진행
-```
-
-### Step 4: 산출물 생성
-
-Gemini가 인터뷰 전체 컨텍스트를 바탕으로 구조화된 문서 초안을 생성하고, Claude가 파일로 저장한다:
-
-```bash
-# Gemini에 산출물 초안 생성 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Generate a structured interview output document based on the following interview context: {full_context}. Return the complete markdown document.'")
-```
-
-Claude는 Gemini가 반환한 마크다운을 Write 도구로 저장한다.
-
-저장 위치: `.omc/plans/interview-{timestamp}.md`
-
-산출물 형식:
-
-```markdown
-# Interview: {topic}
-Date: {date} | Final Ambiguity: {score}%
-
-## Ambiguity Breakdown
-| 요소 | 초기 | 최종 | 개선 |
-|------|------|------|------|
-| Goal | {init}% | {final}% | +{delta}% |
-| Constraints | {init}% | {final}% | +{delta}% |
-| Criteria | {init}% | {final}% | +{delta}% |
-
-## Goal
-{1문장 목표}
-
-## Constraints
-{제약 조건 목록}
-
-## Success Criteria
-{성공 기준 목록}
-
-## Risks & Challenges
-{식별된 위험}
-
-## Alternatives Considered
-| 대안 | 장점 | 단점 | 채택 |
-|------|------|------|------|
-| ... | ... | ... | Y/N |
-
-## Decision
-{최종 결정 + 근거}
-
-## Action Plan
-1. {단계 1} → 검증: {check}
-2. {단계 2} → 검증: {check}
-3. ...
-```
-
-## 동작 규칙
-
-1. 각 단계에서 반드시 사용자 응답을 수집한 후 다음으로 이동한다.
-2. 매 응답 후 ambiguity score를 재계산하여 진행률을 표시한다.
-3. ambiguity < 20%이면 남은 단계를 건너뛰어도 된다.
-4. 5단계를 모두 거쳐도 ambiguity >= 20%이면 추가 질문 라운드를 진행한다 (최대 2회).
-5. 인터뷰 시작 시 코드베이스를 탐색하여 관련 컨텍스트를 확보한다.
-6. 이전 단계 답변을 다음 단계 질문에 반영한다 (대화형 연결).
-
-## 토큰 예산
-
-| 단계 | Claude | Gemini |
-|------|--------|--------|
-| 초기 평가 (모호성 분석) | ~0.2K | ~1K |
-| 5단계 인터뷰 (질문 제시) | ~1K | ~10K |
-| 산출물 초안 생성 | — | ~2K |
-| 최종 파일 저장 | ~0.5K | — |
-| 코드베이스 탐색 | ~0.3K | — |
-| **총합** | **~2K** | **~13K** |
-
-Fallback: Gemini 호출 실패 시 Claude Opus가 분석을 직접 처리한다 (총합 ~15K).
-
-## 사용 예
-
-```
-/tfx-interview "인증 시스템 리팩터링"
-/tfx-interview "실시간 알림 기능 추가"
-/요구사항 분석 "데이터 파이프라인 설계"
-/인터뷰 "레거시 API를 REST에서 GraphQL로 마이그레이션"
-```

package/skills/tfx-interview/skill.json

@@ -1,12 +0,0 @@
-{
-  "name": "tfx-interview",
-  "description": "요구사항이 모호하거나 구현 전 명확화가 필요할 때 사용한다. 'interview', '인터뷰', '요구사항 정리', '뭘 만들어야 하는지 모르겠어', '명확하게 해줘' 같은 요청에 반드시 사용. 구현 시작 전 스펙을 확정하고 싶을 때 적극 활용.",
-  "triggers": [
-    "interview",
-    "인터뷰",
-    "요구사항 탐색",
-    "tfx-interview",
-    "모호성 분석"
-  ],
-  "argument_hint": "<구현할 주제 또는 요구사항>"
-}