npx thrunt-god@latest

왜 만들었나

저는 솔로 개발자입니다. 코드는 제가 아니라 Claude Code가 씁니다.

스펙 기반 개발 도구가 없는 건 아닙니다. BMAD, Speckit 같은 것들이 있죠. 근데 다들 필요 이상으로 복잡합니다 — 스프린트 세리머니, 스토리 포인트, 이해관계자 싱크, 회고, 지라 워크플로우. 저는 50인 규모 소프트웨어 회사가 아니에요. 기업 연극을 하고 싶지 않습니다. 그냥 좋은 걸 만들고 싶은 사람입니다.

그래서 THRUNT를 만들었습니다. 복잡함은 시스템 안에 있습니다. 워크플로우에 있는 게 아니라. 뒤에서 컨텍스트 엔지니어링, XML 프롬프트 포맷팅, 서브에이전트 오케스트레이션, 상태 관리가 돌아갑니다. 겉에서 보이는 건 그냥 몇 가지 명령어뿐입니다.

시스템이 Claude한테 작업하는 데 필요한 것과 검증하는 데 필요한 것을 모두 줍니다. 저는 이 워크플로우를 믿습니다. 그냥 잘 됩니다.

이게 전부입니다. 기업 역할극 같은 건 없습니다. Claude Code를 일관성 있게 쓰기 위한, 진짜로 잘 되는 시스템입니다.

— TÂCHES

바이브코딩은 평판이 안 좋습니다. 원하는 걸 설명하면 AI가 코드를 생성하는데, 규모가 커지면 엉망이 되는 일관성 없는 쓰레기가 나옵니다.

THRUNT가 그걸 고칩니다. Claude Code를 신뢰할 수 있게 만드는 컨텍스트 엔지니어링 레이어입니다. 아이디어를 설명하면 시스템이 필요한 걸 다 뽑아내고, Claude Code가 일을 시작합니다.

이게 누구를 위한 건가

원하는 걸 설명하면 제대로 만들어지길 바라는 사람들 — 50인 규모 엔지니어링 조직인 척하지 않아도 되는.

시작하기

npx thrunt-god@latest

설치 중에 다음을 선택합니다:

1. 런타임 — Claude Code, OpenCode, Gemini, Codex, Copilot, Cursor, Antigravity, 또는 전체 (대화형 다중 선택 — 한 번에 여러 런타임 선택 가능)
2. 위치 — 전역 (모든 프로젝트) 또는 로컬 (현재 프로젝트만)

설치가 됐는지 확인하려면:

• Claude Code / Gemini: /thrunt:help
• OpenCode: /thrunt-help
• Codex: $thrunt-help
• Copilot: /thrunt:help
• Antigravity: /thrunt:help

[!NOTE] Codex 설치는 커스텀 프롬프트 대신 스킬(skills/thrunt-*/SKILL.md)을 사용합니다.

업데이트 유지

THRUNT는 빠르게 발전합니다. 주기적으로 업데이트하세요:

npx thrunt-god@latest

# Claude Code
npx thrunt-god --claude --global   # ~/.claude/에 설치
npx thrunt-god --claude --local    # ./.claude/에 설치

# OpenCode (오픈소스, 무료 모델)
npx thrunt-god --opencode --global # ~/.config/opencode/에 설치

# Gemini CLI
npx thrunt-god --gemini --global   # ~/.gemini/에 설치

# Codex (스킬 우선)
npx thrunt-god --codex --global    # ~/.codex/에 설치
npx thrunt-god --codex --local     # ./.codex/에 설치

# Copilot (GitHub Copilot CLI)
npx thrunt-god --copilot --global  # ~/.github/에 설치
npx thrunt-god --copilot --local   # ./.github/에 설치

# Cursor CLI
npx thrunt-god --cursor --global      # ~/.cursor/에 설치
npx thrunt-god --cursor --local       # ./.cursor/에 설치

# Antigravity (Google, 스킬 우선, Gemini 기반)
npx thrunt-god --antigravity --global # ~/.gemini/antigravity/에 설치
npx thrunt-god --antigravity --local  # ./.agent/에 설치

# 전체 런타임
npx thrunt-god --all --global      # 모든 디렉터리에 설치

git clone https://github.com/thrunt-build/thrunt-god.git
cd thrunt-god
node bin/install.js --claude --local

권장: 권한 확인 건너뛰기 모드

THRUNT는 마찰 없는 자동화를 위해 설계되었습니다. Claude Code를 다음과 같이 실행하세요:

claude --dangerously-skip-permissions

[!TIP] 이게 THRUNT를 사용하는 방법입니다 — date와 git commit 50번을 승인하러 멈추면 의미가 없습니다.

{
  "permissions": {
    "allow": [
      "Bash(date:*)",
      "Bash(echo:*)",
      "Bash(cat:*)",
      "Bash(ls:*)",
      "Bash(mkdir:*)",
      "Bash(wc:*)",
      "Bash(head:*)",
      "Bash(tail:*)",
      "Bash(sort:*)",
      "Bash(grep:*)",
      "Bash(tr:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(git status:*)",
      "Bash(git log:*)",
      "Bash(git diff:*)",
      "Bash(git tag:*)"
    ]
  }
}

작동 방식

이미 코드가 있나요? 먼저 /hunt:map-environment를 실행하세요. 병렬 에이전트를 생성해 스택, 아키텍처, 컨벤션, 고려사항을 분석합니다. 그러면 /hunt:new-program가 코드베이스를 파악한 상태에서 시작되고 — 질문은 추가하는 것에 집중되고, 기획 시 자동으로 기존 패턴을 불러옵니다.

1. 프로젝트 초기화

/hunt:new-program

명령어 하나, 플로우 하나. 시스템이:

1. 질문 — 아이디어를 완전히 이해할 때까지 물어봅니다 (목표, 제약사항, 기술 선호도, 엣지 케이스)
2. 리서치 — 도메인 조사를 위해 병렬 에이전트를 생성합니다 (선택사항이지만 권장)
3. 요구사항 — v1, v2, 스코프 밖을 추출합니다
4. 로드맵 — 요구사항에 매핑된 단계를 생성합니다

로드맵을 승인하면 이제 만들 준비가 됩니다.

생성 파일: MISSION.md, HYPOTHESES.md, HUNTMAP.md, STATE.md, .planning/research/

2. 단계 논의

/hunt:shape-hypothesis 1

여기서 구현을 직접 설계합니다.

로드맵에는 단계당 한두 문장이 있습니다. 그건 당신이 상상하는 방식으로 뭔가를 만들기에 충분한 컨텍스트가 아닙니다. 리서치나 기획이 시작되기 전에 원하는 방향을 미리 잡아두는 단계입니다.

시스템이 단계를 분석하고 만들어지는 것에 기반한 회색 지대를 식별합니다:

• 시각적 기능 → 레이아웃, 밀도, 인터랙션, 빈 상태
• API/CLI → 응답 형식, 플래그, 오류 처리, 상세도
• 콘텐츠 시스템 → 구조, 톤, 깊이, 흐름
• 조직 작업 → 그룹화 기준, 이름 지정, 중복, 예외

선택한 각 영역에 대해 만족할 때까지 물어봅니다. 결과물인 CONTEXT.md는 다음 두 단계에 바로 쓰입니다.

1. 리서처가 읽습니다 — 어떤 패턴을 조사할지 파악합니다 ("카드 레이아웃 원함" → 카드 컴포넌트 라이브러리 리서치)
2. 플래너가 읽습니다 — 어떤 결정이 확정됐는지 파악합니다 ("무한 스크롤 결정됨" → 플랜에 스크롤 처리 포함)

여기서 깊이 들어갈수록 시스템이 실제로 원하는 것에 더 가깝게 만듭니다. 건너뛰면 합리적인 기본값을 얻습니다. 사용하면 당신의 비전을 얻습니다.

생성 파일: {phase_num}-CONTEXT.md

가정 모드: 질문보다 코드베이스 분석을 선호하나요? /thrunt:settings에서 workflow.discuss_mode를 assumptions로 설정하세요. 시스템이 코드를 읽고 하려는 것과 이유를 제시한 다음 틀린 부분만 수정을 요청합니다. 논의 모드 참조.

3. 단계 기획

/hunt:plan 1

시스템이:

1. 리서치 — CONTEXT.md 결정사항을 기반으로 구현 방법을 조사합니다
2. 기획 — XML 구조로 2~3개의 원자적 작업 계획을 생성합니다
3. 검증 — 요구사항 대비 계획을 확인하고, 통과할 때까지 반복합니다

각 계획은 새로운 컨텍스트 창에서 실행할 수 있을 만큼 작습니다. 저하 없이, "이제 더 간결하게 하겠습니다" 같은 말도 없습니다.

생성 파일: {phase_num}-RESEARCH.md, {phase_num}-{N}-PLAN.md

4. 단계 실행

/hunt:run 1

시스템이: