triflux 10.0.0 → 10.0.2

package/skills/tfx-deep-analysis/SKILL.md.tmpl

@@ -1,227 +0,0 @@
----
-name: tfx-deep-analysis
-description: "다각도 심층 분석이 필요할 때 사용한다. 'deep analyze', '심층 분석', '제대로 분석', '3관점 분석', '편향 없이 분석' 같은 요청에 사용. 아키텍처 결정, 기술 부채 평가, 대규모 리팩터링 전 분석에 적극 활용."
-triggers:
-  - deep analyze
-  - 심층 분석
-  - deep-analysis
-argument-hint: "<분석 대상 — 파일, 디렉토리, 또는 주제>"
----
-
-# tfx-deep-analysis — Tri-CLI Deep Analysis
-
-> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
-> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
-
-
-> **Light 버전**: tfx-analysis. 기본값. 깊이 수정자 없으면 Light 선택.
-> Claude(아키텍처) + Codex(구현/보안) + Gemini(UX/문서화) → Tri-Debate → 합의.
-> 3자 전문 관점의 편향 없는 분석.
-
-## 전제조건 프로브 및 Tier Degradation
-
-> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
-
-### 환경 프로브
-
-워크플로우 진입 전, 아래 프로브를 실행하여 가용 환경을 감지한다:
-
-```bash
-psmux --version 2>/dev/null && \
-  curl -sf http://127.0.0.1:27888/status >/dev/null && \
-  codex --version 2>/dev/null && \
-  gemini --version 2>/dev/null
-```
-
-### Tier 판정
-
-| Tier | 조건 | 실행 방식 |
-|------|------|----------|
-| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
-| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
-| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
-
-```
-IF claude -p (one-shot 모드):
-  → Tier 3 즉시 fallback
-
-IF psmux 없음 OR Hub 미응답:
-  → Tier 3
-
-IF Codex 없음 AND Gemini 없음:
-  → Tier 3
-
-IF Codex 없음 OR Gemini 없음:
-  → Tier 2
-
-ELSE:
-  → Tier 1
-```
-
-### Tier 3 진입 시 필수 출력
-
-```
-⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
-  누락: {missing_components}
-  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
-```
-
-Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
-Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
-
-## HARD RULES
-
-> headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.
-
-1. **`codex exec` / `gemini -p` 직접 호출 절대 금지**
-2. Codex·Gemini → `Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'cli:프롬프트:역할' --timeout 600")` **만** 사용
-3. Claude → `Agent(run_in_background=true)`
-4. Bash + Agent를 같은 메시지에서 동시 호출하여 병렬 실행
-
-## 용도
-
-- 아키텍처 결정 전 종합 분석
-- 레거시 코드베이스 상태 진단
-- 보안 + 성능 + UX 교차 분석
-- 기술 부채 종합 평가
-- 리팩터링 범위 결정
-- 마이그레이션 전 영향도 분석
-
-## MODEL ROLES
-
-| Model | Profile | 역할 | 강점 |
-|-------|---------|------|------|
-| Claude Opus | architect | 아키텍처/설계 분석 | 레이어 분리, SOLID, 확장성 |
-| Codex | security-engineer | 구현/보안 분석 | 복잡도, OWASP, 기술 부채 |
-| Gemini | ux-engineer | UX/문서화 분석 | DX, 접근성, 네이밍, 국제화 |
-
-## EXECUTION STEPS
-
-### Step 1: 범위 파싱
-
-분석 대상(`{target}`)을 파싱하고 분석 범위를 확정한다:
-- target: 사용자가 지정한 파일/디렉토리/주제
-- scope: 디렉토리 전체 + 하위 모듈
-- analysis_depth: 파일 구조 + 코드 본문 + 의존성
-- focus_areas: 아키텍처, 보안, 성능, DX
-
-### Step 2: 3-CLI 독립 분석 (Anti-Herding)
-
-**아래 2개 도구를 반드시 같은 응답에서 동시에 호출하라.**
-
-**도구 1 — Claude Opus (아키텍처):**
-```
-Agent(
-  subagent_type="oh-my-claudecode:architect",
-  model="opus",
-  run_in_background=true,
-  name="arch-analyst",
-  description="아키텍처 심층 분석",
-  prompt="소프트웨어 아키텍트로서 분석하라. 대상: {target}. 분석 렌즈: 1. 아키텍처 — 레이어 분리, 의존성 방향, 순환 참조. 2. 설계 패턴 — SOLID 준수, 적절한 추상화 수준. 3. 모듈 응집도/결합도 — cohesion/coupling 평가. 4. 확장성 — 새 요구사항 추가 시 변경 범위. 5. 테스트 용이성 — DI, 인터페이스, mock 가능성. JSON으로 반환: { findings: [{id, category, severity, description, location, recommendation}], architecture_diagram: '텍스트 기반 구조도', health_score: 0-100 }"
-)
-```
-
-**도구 2 — Codex+Gemini headless dispatch:**
-```
-Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'codex:시니어 엔지니어+보안 전문가로서 분석하라. 대상: {target}. 분석 렌즈: 1. 구현 품질 — 복잡도, 중복, 에러 핸들링. 2. 성능 — 알고리즘 효율, 메모리 패턴, I/O 병목. 3. 보안 — OWASP Top 10, 입력 검증, 인증/인가. 4. 안정성 — 에러 전파, 장애 격리, 리소스 관리. 5. 기술 부채 — deprecated API, TODO, 하드코딩. JSON: { findings: [...], metrics: {complexity, loc, tech_debt_hours}, health_score: 0-100 }:security-engineer' --assign 'gemini:UX 엔지니어+테크니컬 라이터로서 분석하라. 대상: {target}. 분석 렌즈: 1. DX(개발자 경험) — API 직관성, 에러 메시지, 사용 용이성. 2. 문서화 — JSDoc/주석 품질, README, 예제 코드. 3. 접근성 — UI가 있으면 WCAG 2.1 AA, 키보드/스크린리더. 4. 국제화 — 하드코딩 문자열, 로케일 처리. 5. 네이밍 — 일관성, 도메인 언어, 가독성. JSON: { findings: [...], documentation_score: 0-100, health_score: 0-100 }:ux-engineer' --timeout 600")
-```
-
-### Step 3: Tri-Debate (교차검증)
-
-3개 결과를 수집한 후, **아래 2개 도구를 반드시 같은 응답에서 동시에 호출하라.**
-
-**도구 1 — Claude 교차검증:**
-```
-Agent(
-  subagent_type="oh-my-claudecode:architect",
-  model="opus",
-  run_in_background=true,
-  name="arch-debate",
-  description="교차검증 — 아키텍처 관점",
-  prompt="다른 두 분석가의 결과입니다. 분석가 A(Codex): {codex_findings_summary}. 분석가 B(Gemini): {gemini_findings_summary}. 1. 동의하는 발견에 '+1' 표시. 2. 반대하는 발견에 근거를 제시하여 반박. 3. 다른 분석가가 놓친 중요 사항 추가. 4. health_score를 재조정하라."
-)
-```
-
-**도구 2 — Codex+Gemini 교차검증:**
-```
-Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'codex:다른 두 분석가의 결과입니다. 분석가 A(Claude): {claude_findings_summary}. 분석가 B(Gemini): {gemini_findings_summary}. 1. 동의하는 발견에 +1 표시. 2. 반대하는 발견에 근거를 제시하여 반박. 3. 다른 분석가가 놓친 중요 사항 추가. 4. health_score를 재조정하라.:security-engineer' --assign 'gemini:다른 두 분석가의 결과입니다. 분석가 A(Claude): {claude_findings_summary}. 분석가 B(Codex): {codex_findings_summary}. 1. 동의하는 발견에 +1 표시. 2. 반대하는 발견에 근거를 제시하여 반박. 3. 다른 분석가가 놓친 중요 사항 추가. 4. health_score를 재조정하라.:ux-engineer' --timeout 600")
-```
-
-교차검증 후 합의 분류:
-- 3/3 동의 → CONFIRMED
-- 2/3 동의 → LIKELY (반대 의견 첨부)
-- 1/3만 지적 → UNVERIFIED
-
-### Step 4: 합의 종합 보고서 출력
-
-아래 형식으로 최종 보고서를 출력한다:
-
-```markdown
-# Deep Analysis Report: {target}
-**Consensus Score**: {score}% | **Analysts**: Claude/Codex/Gemini
-**Health Score**: {weighted_avg}/100
-
-## Executive Summary
-{3-5줄 핵심 요약 — 3자 합의 기반}
-
-## Architecture
-{Claude 주도 분석 + Codex/Gemini 교차검증}
-### 구조도
-{텍스트 기반 아키텍처 다이어그램}
-### 강점
-- {3/3 합의된 아키텍처 강점}
-### 약점
-- {2+ 합의된 아키텍처 약점}
-
-## 발견사항 (합의된 항목)
-
-### Critical
-- [C1] `{file}:{line}` — {description} — {3/3}
-  - 아키텍처: {Claude} | 구현: {Codex} | DX: {Gemini}
-  - **권장**: {recommendation}
-
-### High
-- [H1] ...
-
-### Medium
-- [M1] ...
-
-## 메트릭
-| 항목 | 값 | 평가 |
-|------|-----|------|
-| 아키텍처 건강도 | {Claude score}/100 | {평가} |
-| 구현 품질 | {Codex score}/100 | {평가} |
-| DX/문서화 | {Gemini score}/100 | {평가} |
-| 종합 (가중평균) | {avg}/100 | {평가} |
-| 기술 부채 추정 | {hours}h | {심각도} |
-
-## 개선 로드맵 (합의 순)
-| 우선순위 | 항목 | 예상 공수 | 합의도 |
-|---------|------|----------|--------|
-| P0 | {item} | {hours}h | 3/3 |
-| P1 | {item} | {hours}h | 2/3 |
-
-## Unverified (참고용)
-- [U1] {description} (by {single_cli})
-
-## 불일치 사항
-- {항목}: Claude는 {X}, Codex는 {Y}, Gemini는 {Z}
-```
-
-## ERROR RECOVERY
-
-| 상황 | 대응 |
-|------|------|
-| headless timeout (600s) | Claude Agent로 해당 역할 대체 실행 |
-| Codex 워커 실패 | Agent(oh-my-claudecode:architect, model="opus") 대체 |
-| Gemini 워커 실패 | Agent(oh-my-claudecode:critic, model="sonnet") 대체 |
-
-## 토큰 예산
-
-| Phase | 토큰 |
-|-------|------|
-| Phase 1 (수집) | ~1K |
-| Phase 2 (3x 독립분석) | ~15K |
-| Phase 3 (Tri-Debate) | ~9K |
-| Phase 4 (보고서) | ~5K |
-| **총합** | **~30K** |

package/skills/tfx-deep-analysis/skill.json

@@ -1,10 +0,0 @@
-{
-  "name": "tfx-deep-analysis",
-  "description": "다각도 심층 분석이 필요할 때 사용한다. 'deep analyze', '심층 분석', '제대로 분석', '3관점 분석', '편향 없이 분석' 같은 요청에 사용. 아키텍처 결정, 기술 부채 평가, 대규모 리팩터링 전 분석에 적극 활용.",
-  "triggers": [
-    "deep analyze",
-    "심층 분석",
-    "deep-analysis"
-  ],
-  "argument_hint": "<분석 대상 — 파일, 디렉토리, 또는 주제>"
-}

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

@@ -1,203 +0,0 @@
----
-name: tfx-deep-interview
-description: >
-  구현 전 소크라테스식 질의로 요구사항 깊이 탐색.
-  5단계 인터뷰를 통해 요구사항을 명확히 하고 최적 구현 경로를 도출합니다.
-triggers:
-  - deep-interview
-  - 딥인터뷰
-  - 소크라테스
-  - 깊이 탐색
-  - 요구사항 분석
-argument-hint: "<topic>"
----
-
-# tfx-deep-interview — 소크라테스식 깊이 탐색
-
-> **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
-> 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
-
-
-> 구현 전에 질문을 통해 요구사항의 깊이를 탐색합니다.
-> "좋은 답은 좋은 질문에서 나온다."
-
-## 사용법
-
-```
-/deep-interview 인증 시스템 리팩터링
-/deep-interview JWT 기반 세션 관리
-/딥인터뷰 데이터 파이프라인 설계
-```
-
-## 위임 패턴
-
-Claude 토큰을 절약하기 위해 분석 작업은 Gemini CLI에 위임합니다.
-
-- **Claude 담당**: AskUserQuestion (사용자 상호작용), 산출물 저장
-- **Gemini 담당**: 질문 생성, 응답 분석, 종합 문서 초안 작성
-
-각 단계에서 Claude는 누적 컨텍스트를 Gemini에 전달하고, Gemini가 반환한 질문을 AskUserQuestion으로 사용자에게 제시합니다. 사용자 답변은 다음 단계 Gemini 호출의 입력으로 전달됩니다.
-
-**Fallback**: Gemini 호출이 실패하면 Claude Opus가 모든 분석을 직접 수행합니다 (원래 동작 유지).
-
-## 토큰 예산
-
-| 담당 | 토큰 | 역할 |
-|------|------|------|
-| Claude | ~2K | 오케스트레이션 + AskUserQuestion만 |
-| Gemini | ~10K | 분석 + 질문 생성 + 문서 초안 |
-
-## 5단계 인터뷰 프로세스
-
-인터뷰는 반드시 아래 5단계를 순서대로 진행합니다. 각 단계에서 사용자 응답을 수집한 후 다음 단계로 이동합니다.
-
-### Stage 1: Clarify (명확화)
-
-> "정확히 무엇을 달성하려는가?"
-
-목표를 한 문장으로 정의하고, 성공 기준과 현재 상태의 차이를 파악합니다.
-
-**단계 진입 시 Gemini 위임:**
-
-```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 1: Clarify. Topic: {topic}. Previous answers: none. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
-```
-
-Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
-
-**질문 템플릿 (Gemini 실패 시 Fallback):**
-
-1. "이 작업의 핵심 목표를 한 문장으로 설명해주세요."
-2. "완료 후 어떤 상태가 되어야 성공인가요?"
-3. "현재 상태에서 가장 큰 문제점은 무엇인가요?"
-
-### Stage 2: Decompose (분해)
-
-> "이것을 어떤 하위 문제로 나눌 수 있는가?"
-
-대상을 3-5개의 독립적 하위 문제로 분해하고, 의존성과 우선순위를 결정합니다.
-
-**단계 진입 시 Gemini 위임:**
-
-```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 2: Decompose. Topic: {topic}. Previous answers: {stage1_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
-```
-
-Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
-
-**질문 템플릿 (Gemini 실패 시 Fallback):**
-
-1. "이 작업을 3-5개의 독립된 단계로 나눈다면?"
-2. "각 단계 사이에 의존성이 있나요?"
-3. "가장 먼저 해결해야 할 핵심 문제는?"
-
-### Stage 3: Challenge (반론)
-
-> "이 접근의 약점은?"
-
-선택한 접근 방식의 단점을 식별하고, 실패 시나리오와 기술 부채 가능성을 탐색합니다.
-
-**단계 진입 시 Gemini 위임:**
-
-```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 3: Challenge. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
-```
-
-Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
-
-**질문 템플릿 (Gemini 실패 시 Fallback):**
-
-1. "이 방식이 실패할 수 있는 시나리오는?"
-2. "6개월 후 이 코드를 유지보수할 때 문제가 될 부분은?"
-3. "이 접근이 다른 시스템에 미치는 영향은?"
-
-### Stage 4: Alternatives (대안)
-
-> "다른 방법은?"
-
-최소 2개의 대안을 검토하고, 각 대안의 trade-off를 비교합니다.
-
-**단계 진입 시 Gemini 위임:**
-
-```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 4: Alternatives. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
-```
-
-Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
-
-**질문 템플릿 (Gemini 실패 시 Fallback):**
-
-1. "같은 목표를 달성할 수 있는 완전히 다른 접근은?"
-2. "시간이 절반밖에 없다면 어떤 방식을 택하겠습니까?"
-3. "이 기술 대신 다른 것을 사용하면 어떤 trade-off가 있나요?"
-
-### Stage 5: Synthesize (종합)
-
-> "최적 경로는?"
-
-인터뷰 결과를 종합하여 실행 계획을 도출하고, 구조화된 요구사항 문서를 생성합니다.
-
-**단계 진입 시 Gemini 위임:**
-
-```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 5: Synthesize. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers} {stage4_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
-```
-
-Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
-
-**질문 템플릿 (Gemini 실패 시 Fallback):**
-
-1. "지금까지의 논의를 종합하면, 최적의 접근 방식은?"
-2. "첫 번째 단계로 무엇을 실행하시겠습니까?"
-3. "이 결정에 대해 확신하는 정도는? (1-10)"
-
-## 산출물
-
-인터뷰 완료 후 Gemini가 전체 인터뷰 문서 초안을 생성하고, Claude가 Write 툴로 `.tfx/plans/interview-{timestamp}.md`에 저장합니다.
-
-**산출물 생성 Gemini 위임:**
-
-```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview complete. Topic: {topic}. All answers: {all_answers}. Generate a structured requirements document draft. Return the full markdown document.'")
-```
-
-Gemini 실패 시 Claude가 직접 아래 형식으로 문서를 작성합니다.
-
-### 산출물 형식
-
-```markdown
-# Interview: {topic}
-Date: {date}
-
-## Goal
-{1문장 목표}
-
-## Decomposition
-{하위 문제 목록}
-
-## Risks & Challenges
-{식별된 위험}
-
-## Alternatives Considered
-| 대안 | 장점 | 단점 |
-|------|------|------|
-| ... | ... | ... |
-
-## Decision
-{최종 결정 + 근거}
-
-## Action Plan
-1. {단계 1}
-2. {단계 2}
-3. ...
-```
-
-## 동작 규칙
-
-1. 각 단계에서 반드시 사용자 응답을 수집한 후 다음 단계로 이동합니다.
-2. 사용자가 명확한 답을 못 할 경우, 후속 질문으로 유도합니다.
-3. 단계를 건너뛰지 않습니다 (5단계 모두 필수).
-4. 이전 단계의 답변을 다음 단계 질문에 반영합니다 (대화형 연결).
-5. 최종 산출물은 항상 `.tfx/plans/interview-{timestamp}.md`에 마크다운 파일로 저장합니다.
-6. 인터뷰 시작 시 현재 주제와 관련된 코드베이스를 탐색하여 컨텍스트를 확보합니다.
-7. 각 단계 전환 시 이전 단계 요약을 한 줄로 보여줍니다.

package/skills/tfx-deep-interview/skill.json

@@ -1,12 +0,0 @@
-{
-  "name": "tfx-deep-interview",
-  "description": "구현 전 소크라테스식 질의로 요구사항 깊이 탐색. 5단계 인터뷰를 통해 요구사항을 명확히 하고 최적 구현 경로를 도출합니다.",
-  "triggers": [
-    "deep-interview",
-    "딥인터뷰",
-    "소크라테스",
-    "깊이 탐색",
-    "요구사항 분석"
-  ],
-  "argument_hint": "<topic>"
-}