curl -fsSL https://raw.githubusercontent.com/reallygood83/sukgo/main/get.sh | bash

📺 Demo

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

                    s u k g o
                  결 정 의   기 술

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   ▌ 사고 도구 — 검증된 사고 프레임워크
      1   🛡  Steel-manning      가장 강한 반대 논리
      2   🥊  Devil's Advocate   확증편향 차단
      3   ⚰  Pre-mortem          실패 시뮬레이션 (Gary Klein)
      4   🎩  6 Hats              6관점 종합 (de Bono)
      5   🔄  Inversion           거꾸로 사고 (Munger)
      6   ❓  5 Whys              근본 원인 (Toyota)
      7   ⚖  Decision Matrix    가중치 비교
      8   🧬  First Principles   본질부터 (Aristotle)
      9   🌊  OODA Loop           빠른 결정 (Boyd)
      0   🎯  Toulmin Model       논증 5요소

   ▌ 도메인 컨설턴트 — 데이터 기반 전문 분석
      c   💼  Career              이직·커리어 (정량+정성)
      i   📈  Investment          주식 9섹션 (yfinance/FDR 자동)
      e   👶  Education           자녀 교육 (발달학+연구)

   ▌ 설정
      s    설정 변경
      u    업데이트 확인  (최신 버전으로)
      q    종료

           ● claude · codex · grok · agy · gemini · MLX · Ollama
                  비교 모드 · 옵시디언 자동 저장
                made by 배움의 달인 ✨   v0.0.15

🎯 왜 sukgo?

💸 추가 결제 0원

이미 내고 있는 Claude Pro · ChatGPT Plus · Gemini 무료 구독을 그대로 활용. OpenRouter, 별도 API 키 가입, 추가 월 $20 — 모두 필요 없음.

⚡ Thought Speed

회의 5분 전, 한 줄 명령으로 사고 시작. ChatGPT 켜고 프롬프트 입력하는 30초가 사라짐.

🧠 AI가 답하지 않는다 — 너를 키운다

챗봇은 답을 준다. sukgo는 사고를 단단하게 만든다.

검증된 사고 프레임워크 13종과 AI를 결합해 사용자 자신을 더 나은 결정자로 만든다.

💾 데이터 주권

모든 분석 결과는 로컬 마크다운으로 자동 저장. 옵시디언 볼트와 통합 가능. ChatGPT 기록처럼 외부 서버에 갇히지 않음.

🌐 AI 비교 모드

같은 질문 → Claude · GPT · Gemini 동시 → 한 마크다운에 통합. "OpenRouter 결제 없이 멀티 AI 분석" — sukgo의 진짜 차별화.

🚀 한 줄 설치

🍎 macOS / 🐧 Linux

curl -fsSL https://raw.githubusercontent.com/reallygood83/sukgo/main/get.sh | bash

🪟 Windows (PowerShell)

irm https://raw.githubusercontent.com/reallygood83/sukgo/main/get.ps1 | iex

💡 PowerShell(시작 메뉴 → "PowerShell" 검색) 또는 Windows Terminal에서 실행하세요. cmd.exe 는 권장하지 않습니다.

→ 모든 OS 1~2분 안에 자동 설치. 끝나면 새 터미널을 열고 sukgo.

🌱 처음이신 분?

docs/ONBOARDING.md — 5분 가이드 (Python · AI CLI 설치 안내 + FAQ).

🛠 개발자용 (직접 클론)

# macOS / Linux
git clone https://github.com/reallygood83/sukgo.git && cd sukgo && ./install.sh

# Windows
git clone https://github.com/reallygood83/sukgo.git; cd sukgo; .\install.ps1

✨ 자동으로 처리되는 것

🔒 격리 보장: sukgo 는 사용자의 시스템 Python·다른 venv·conda 환경을 일절 건드리지 않습니다.

🔄 업데이트

새 버전이 나오면 셋 중 아무 방법이나 사용:

방법 1 — 메인 메뉴에서 (가장 쉬움)

sukgo
> u   (업데이트 확인)

→ 자동으로 변경 사항 미리보기 → 확인 후 최신으로 동기화 + 의존성 갱신.

방법 2 — 서브커맨드

sukgo update

→ 메뉴를 거치지 않고 바로 업데이트.

방법 3 — 한 줄 설치 재실행 (완전 재설치)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/reallygood83/sukgo/main/get.sh | bash

# Windows
irm https://raw.githubusercontent.com/reallygood83/sukgo/main/get.ps1 | iex

→ 코드·의존성·wrapper 전부 깨끗하게 다시 설치.

💡 이미 최신이면 ✅ 이미 최신입니다 라고 알려주고 끝나므로 안심하고 자주 눌러도 됨.

현재 버전 확인

sukgo --version

📋 요구사항

💡 하나만 있어도 작동. 여러 개 등록 시 비교 모드 사용 가능.

🛠 사용법

메인 메뉴

sukgo

→ 메뉴에서 도구 선택 → AI 백엔드 선택 (1개 또는 비교 모드 a) → 주제 입력

사고 도구 사용 예시

> 4   (6 Hats 선택)
> 어떤 AI? a   (모두 — 비교 모드)
> 주제: 회사를 이직해야 한다

⠋ claude · codex · grok · agy · gemini 가 6관점에서 분석 중...

[5개 AI의 6색 모자 관점 분석 통합 출력]

💾 저장됨: ~/Documents/Vault/000-Inbox/2026-04-26_..._6hats_compare.md
   3개 AI 응답이 한 파일에 통합됨

Investment 도구 (자동 데이터 수집)

> i   (Investment)
> 종목: NVDA

📊 NVDA 데이터 수집 중...
✅ NVIDIA Corporation
   현재가:    $182.15
   PER:       65.40
   시가총액:  4.47T
   52주 범위: $86.62 ~ $195.31
   뉴스:      5건 수집

⠋ 9섹션 종합 리포트 생성 중...

[Executive Summary / Fundamental / Catalyst / Valuation / Risk /
 Technical / Market Positioning / Behavioral Check / 종합 평가]

💾 저장됨: ~/Documents/Vault/000-Inbox/_investments/2026-04-26_..._NVDA.md

한국 주식도 동일 (6자리 종목코드):

> 종목: 005930   (← 삼성전자)

💬 Clarifying Questions — 맞춤형 분석 (v0.0.11+)

Career · Investment · Education · Pre-mortem · Decision Matrix 도구는 본 분석 전에 사용자가 컨텍스트 수집 방식을 선택합니다.

> c   (Career)
> 주제: 5년차 개발자, 스타트업 CTO 제안 받음. 이직할까?

🎯 Career  — 컨텍스트 수집 방식
    1  ⚡ Quick   — sukgo 가 핵심 질문 3~5개 한 번에 (1~2분)
    2  🎤 Deep    — codex omx deep-interview 인터랙티브 (5~10분, 정밀)
    3  ⏭  Skip    — 즉시 분석 (컨텍스트 수집 X)

선택 [기본 1]:

⚡ Quick 모드 (기본)

LLM 이 자동으로 핵심 질문 3~5개를 한 번에 만들어 사용자에게 묻고, 자유 답변(multi-line)을 받아 컨텍스트 보강.

📋 답변할 질문
**Q1.** 현재 연봉/총보상과 스타트업이 제안한 연봉·지분 조건은?
**Q2.** 스타트업의 단계와 런웨이는?
**Q3.** 가족 상황과 재정적 안전마진은?
... (총 3~5개)

답변: [자유롭게 작성 → 빈 줄 두 번 또는 '---' 입력으로 종료]

🎤 Deep 모드 — Socratic 인터랙티브 인터뷰 (v0.0.12+)

한 라운드 = 한 질문, 5~12라운드 반복. 5차원(intent / outcome / scope / constraints / success) 가중 점수로 ambiguity 를 측정하고 임계치(0.20) 도달 + Mandatory gates (Non-goals · Decision Boundaries · Pressure Pass) 충족 시 자동 종료.

두 엔진 — 자동/수동 선택:

• codex omx deep-interview (권장, codex+omx 설치 시) — 검증된 Reference 구현, .omx/specs/ 에 spec 파일 생성
• sukgo native (v0.0.13+, 기본 폴백) — codex 없어도 동일 알고리즘. LLM 한 호출 = 한 라운드, JSON 형식으로 점수·gates 추적

🎯 Career  — 컨텍스트 수집 방식
    1  ⚡ Quick   — 핵심 질문 3~5개 한 번에
    2  🎤 Deep    — Socratic 인터뷰 (5~12라운드)
        └ codex omx 감지됨 → 권장 엔진으로 선택 가능
    3  ⏭  Skip
선택 [기본 1]: 2

Deep 엔진 선택:
    a  codex omx deep-interview  (권장 — 검증된 구현)
    b  sukgo native              (LLM 한 호출 = 한 라운드)
엔진 [기본 a]: b

━━━ Deep Interview (Native, Standard) ━━━

⠋  Round 1/12 — 다음 질문 생성 중...

── Round 1/12 ──
clarity: [██░░░░░░░░░░░░░░░░░░] 11%  target: intent  gates 미충족

❓ 현재 직장에서 'CTO 제안을 받아들여야겠다'는 생각이 든 가장 결정적인 순간은
   언제였나요? (예: 연봉 정체 / 기술 도전 부족 / 주도하고 싶은 욕구 등)

>  [사용자 답변]

── Round 2/12 ──
clarity: [██████░░░░░░░░░░░░░░] 32%  target: outcome  NG✓
...

✅ 임계치·gates 모두 충족 — 인터뷰 종료
⠋  Spec 정리 중... (7 라운드 종합)
✅ Spec 생성 완료 (2,841 자)

조기 종료: 인터뷰 중 done / enough / exit 입력 시 즉시 spec 작성. 자동 폴백: codex 위임 실패 → 네이티브 / 네이티브 실패 → Quick

🧠 사고 도구 13종

사고 프레임워크 (10종 — 어떤 주제든 적용)

도메인 컨설턴트 (3종 — 특정 영역 전문 분석)

🔌 백엔드 7종

→ 사용자가 가진 CLI 자동 감지. 여러 개 등록 시 비교 모드 (같은 질문, 다른 시각).

비교 모드 — sukgo의 진짜 강점

주제: "AI 시대에는 학생들에게 코딩보다 비판적 사고를 먼저 가르쳐야 한다"

🧠 claude    →  학술적·구조적 (Willingham, MIT Resnick 인용)
🧠 codex     →  실용적·시장 관점 (GPT-5.4 학습 지식)
🧠 grok      →  실시간 이슈·반대 관점·대담한 가설
🧠 agy       →  에이전트 작업 흐름·검증·실행 계획
🧠 gemini    →  데이터·트렌드 관점 (Google 인덱스)

→ 한 마크다운 파일에 3개 시각 통합 → 옵시디언에서 한눈에 비교

OpenRouter 등 별도 결제 없이 자기 구독으로 다관점 분석 가능.

👥 누가 쓰면 좋은가

🎓 학생 — 토론·디베이트 준비

sukgo → 1   (Steel-manning)
> 주제: 인공지능 규제 강화 (찬성 입장)

→ 가장 강한 반대 논리 + 본인 입장 보강 가이드 (Toulmin 모델 자동 적용).

💼 회사원 — 회의 준비

sukgo → 2   (Devil's Advocate)
> 주제: Q3 마케팅 예산 30% 증액

→ 예상 반대 의견 5가지 + 답변 템플릿 (5분 만에 무장).

💰 투자자 — 종목 검토

sukgo → i   (Investment)
> 종목: NVDA

→ yfinance 자동 데이터 + 9섹션 종합 리포트 + Bull/Base/Bear 시나리오.

👶 부모 — 자녀 교육 결정

sukgo → e   (Education)
> 고민: 초등 3학년, 영어 학원 그만두고 코딩 학원 가고 싶어함

→ 발달 단계 적합성 + 검증된 연구 + 한국 입시 현실 + 부모-자녀 관계 영향.

🤔 일반인 — 인생 결정

sukgo → 3   (Pre-mortem)
> 주제: 결혼 5년차, 둘째 아이 가질지 말지

→ "1년 후 후회한다면 이유 5가지" + 사전 차단 전략.

🏗 아키텍처

┌─────────────────────────────────────────┐
│              User Input                  │
│           (CLI args / TUI)               │
└─────────────────────────────────────────┘
                   ↓
┌─────────────────────────────────────────┐
│              sukgo Core                  │
│  ┌──────┐  ┌──────┐  ┌──────────────┐  │
│  │Tools │→ │Data  │→ │Renderer      │  │
│  │ (13) │  │Fetch │  │(Rich/ANSI)   │  │
│  └──────┘  └──────┘  └──────────────┘  │
└─────────────────────────────────────────┘
                   ↓
┌─────────────────────────────────────────┐
│         Backend Adapter (7종)            │
│  claude · codex · grok · agy · gemini    │
│  · MLX · Ollama                          │
│  (subprocess / HTTP, 자동 감지)          │
└─────────────────────────────────────────┘
                   ↓
┌─────────────────────────────────────────┐
│              Persistence                 │
│  ~/.config/sukgo/    (설정)              │
│  $OBSIDIAN_VAULT/    (자동 저장)          │
└─────────────────────────────────────────┘

🔑 핵심 디자인 패턴

Wrapper Script Pattern

~/.local/bin/sukgo  (bash wrapper)
       ↓
exec ~/.sukgo/venv/bin/python ~/Desktop/sukgo/poc.py "$@"
       ↓
사용자가 어떤 venv에 있든 → 항상 자기 venv 사용
   = 영원히 의존성 안 깨짐

외부 프롬프트 파일

prompts/investment.md   ← 9섹션 분석 (코드와 분리)
                        ← Claude Code 슬래시 커맨드와 동기화 가능

🔒 보안

본인의 API 키는 본인 컴퓨터에만.

• API 키는 ~/.config/sukgo/secrets.json에 권한 600으로 저장
• 코드와 완전 분리 — .gitignore로 GitHub 업로드 차단
• 첫 사용 시 wizard로 안전하게 입력
• AI CLI(claude/codex/grok/agy/gemini)는 자체 OAuth 사용 — sukgo가 키 보지 않음

🐛 트러블슈팅

command not found: sukgo (macOS / Linux)

새 터미널 창을 여세요. 또는:

source ~/.zshrc    # 또는 ~/.bashrc

'sukgo' 용어가 cmdlet ... 인식되지 않습니다 (Windows)

새 PowerShell 창을 여세요. 그래도 안 되면 PATH 직접 확인:

$env:Path -split ';' | Select-String '.sukgo'
# 비어 있으면 PATH 수동 추가:
[Environment]::SetEnvironmentVariable('Path', "$env:Path;$env:USERPROFILE\.sukgo\bin", 'User')

irm ... | iex 실행 시 ExecutionPolicy 차단 (Windows)

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
irm https://raw.githubusercontent.com/reallygood83/sukgo/main/get.ps1 | iex

Python 의존성 에러

# macOS / Linux
~/.sukgo/venv/bin/pip install --upgrade pip
~/.sukgo/venv/bin/pip install yfinance finance-datareader requests

# Windows
& "$env:USERPROFILE\.sukgo\venv\Scripts\python.exe" -m pip install --upgrade pip
& "$env:USERPROFILE\.sukgo\venv\Scripts\python.exe" -m pip install yfinance finance-datareader requests

가상환경 충돌

sukgo는 ~/.sukgo/venv 격리 환경 사용. 사용자 다른 venv 영향 받지 않음. 완전 재설치:

# macOS / Linux
rm -rf ~/.sukgo ~/.local/bin/sukgo
curl -fsSL https://raw.githubusercontent.com/reallygood83/sukgo/main/get.sh | bash

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.sukgo"
irm https://raw.githubusercontent.com/reallygood83/sukgo/main/get.ps1 | iex

Windows 한글 깨짐 (cmd.exe)

sukgo wrapper가 chcp 65001로 UTF-8 코드페이지를 자동 설정하므로 정상 동작합니다. 그래도 깨지면 Windows Terminal (시작 메뉴 → "Terminal" 검색) 사용을 권장합니다.

AI 응답이 너무 느림

• 단일 AI: 10~60초 정상
• 비교 모드 (35 AI): 15분 정상 (순차 호출)
• Investment 9섹션: 30~120초 정상

한국 주식 데이터 안 옴

6자리 종목코드만 입력. 회사명·괄호는 자동 무시되지만, 안전하게:

종목: 005930      ← OK
종목: 005930(삼성)  ← OK (자동 정규화)
종목: 삼성전자      ← ❌ (6자리 코드 필요)

더 많은 도움

• 📖 docs/ONBOARDING.md — 초보자 가이드 + FAQ
• 🐛 GitHub Issues

🗺 로드맵

상세: CHANGELOG.md

🤝 기여

PR / 이슈 환영합니다.

새 사고 도구 추가 (5분 가이드)

1. prompts/<도구이름>.md 작성 (Steel-manning 참고)
2. poc.py TOOLS 리스트에 항목 추가:

   Tool(
       key="X",                    # 메뉴 단축키
       name="My Tool",
       emoji="🔮",
       short_desc="한 줄 설명",
       save_id="mytool",
       category="thinking",        # or "domain"
       prompt_file="mytool.md",    # prompts/ 폴더 파일명
   )
   

3. PR 생성 — 끝!

📚 문서

📄 라이선스

MIT — 자유롭게 사용·수정·배포 (상업 사용 포함).

⚠ Investment 도구의 분석 결과는 교육·참고용이며 투자 자문이 아닙니다. 실제 투자는 본인 판단·책임이며, 추가 리서치(공시·증권사 리포트·전문가 자문)가 필요합니다.

👤 Made by

curl -fsSL https://raw.githubusercontent.com/reallygood83/sukgo/main/get.sh | bash