tofu-at

Tofu-AT (Tofu Agent Teams)

🇰🇷 한국어 설명입니다. English guide is below ↓

워크플로우를 Claude Code의 Agent Teams (Split Pane / Swarm)로 자동 변환하는 오케스트레이션 프레임워크.

---

💡 Claude Code에 아래 메시지를 그대로 전달하면 가장 정확하게 설치됩니다

https://github.com/treylom/tofu-at 설치해줘. https://tofu-at.manus.space 를 참고하면 더 도움이 될거야.

---

Tofu-AT는 기존 스킬, 에이전트, 커맨드를 분석하여 병렬화된 Agent Teams 구성을 자동 생성합니다. 스폰 프롬프트·품질 게이트·공유 메모리를 포함한 최적 팀 구성안을 즉시 실행할 수 있습니다.

빠른 시작

# 1. 클론
git clone https://github.com/treylom/tofu-at.git /tmp/tofu-at

# 2. 프로젝트 디렉토리로 이동
cd ~/my-project

# 3. 설치
bash /tmp/tofu-at/install.sh

# 4. Claude Code 실행
claude --model=opus[1m]

# 5. Tofu-AT 실행
# 입력: /tofu-at

원클릭 설치

cd ~/my-project
curl -fsSL https://raw.githubusercontent.com/treylom/tofu-at/main/install.sh | bash

설치 스크립트가 모든 과정을 자동으로 처리합니다: 필수 요건 확인, 파일 복사, settings.local.json 설정, hooks 설치.

주요 기능

• 동적 리소스 스캔 — 스킬, 에이전트, MCP 서버, CLI 도구 자동 발견
• 워크플로우 분석 — 병렬화 가능한 에이전트 단위로 자동 분해
• 전문가 도메인 프라이밍 — 27개 도메인, 137명의 전문가 페르소나 내장
• Ralph Loop — 반복적 리뷰-피드백-재작업 품질 보장 사이클
• Devil's Advocate — 팀 전체 일관성을 위한 교차 리뷰
• 3계층 공유 메모리 — Markdown + SQLite WAL + MCP Memory
• Agent Office 대시보드 — 실시간 진행 상황 추적 (선택)
• 원클릭 재실행 — 자동 슬래시 커맨드 생성으로 팀 즉시 재실행

필수 요구사항

항목	최소 버전	확인 명령어
Claude Code	v2.1.45+	claude --version
Node.js	v18+	node --version
tmux	2.0+	tmux -V
git	2.0+	git --version

install.sh가 자동으로 확인하고 누락된 의존성 설치를 안내합니다.

설치

자동 설치 (권장)

install.sh가 7단계를 자동 처리합니다:

1. 필수 요건 확인 (Node.js, tmux, git, Claude Code)
2. OS 감지 (WSL, macOS, Linux)
3. 파일 설치 (commands, skills)
4. .team-os 인프라 설정 (hooks, artifacts, registry)
5. settings.local.json 자동 설정 (env vars, hooks, teammateMode)
6. 설치 검증
7. 다음 단계 안내

bash install.sh

수동 설치

직접 설치를 원하는 경우:

# 1. 커맨드 복사
mkdir -p .claude/commands
cp commands/tofu-at.md .claude/commands/

# 2. 스킬 복사 (flat files + directories)
mkdir -p .claude/skills
cp skills/*.md .claude/skills/ 2>/dev/null || true
cp -r skills/*/ .claude/skills/ 2>/dev/null || true

# 3. .team-os 복사
cp -r .team-os .

# 4. settings.local.json 설정
# .claude/settings.local.json에 아래 내용 추가:
# {
#   "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" },
#   "teammateMode": "tmux",
#   "hooks": {
#     "TeammateIdle": [{"hooks": [{"type": "command", "command": "node .team-os/hooks/teammate-idle-gate.js"}]}],
#     "TaskCompleted": [{"hooks": [{"type": "command", "command": "node .team-os/hooks/task-completed-gate.js"}]}]
#   }
# }

Claude.ai (.skill ZIP)

Releases에서 tofu-at.skill 다운로드 후 Claude.ai에 업로드. 스킬만 포함되며, .team-os 인프라는 첫 실행 시 자동 생성됩니다.

OS별 설치 안내

WSL (Windows)

• WSL 먼저 설치: PowerShell(관리자)에서 wsl --install
• Windows 경로(/mnt/c/...) 대신 Linux 파일시스템(~/project) 사용 권장 (성능)
• install.sh가 WSL을 자동 감지하여 apt 사용
• 전체 WSL 설치 가이드: docs/installation-guide.md

macOS

• tmux 설치에 Homebrew 필요: brew install tmux
• install.sh가 macOS를 자동 감지하여 brew 사용

Linux (Debian/Ubuntu)

sudo apt install -y tmux git

Linux (RHEL/Fedora)

sudo dnf install -y tmux git

ai / ain 단축 명령어 (선택)

tmux 세션에서 Claude Code를 빠르게 실행하는 쉘 단축키입니다:

bash setup-bashrc.sh ~/my-project                    # 기본 (auto-push OFF)
bash setup-bashrc.sh ~/my-project --with-auto-push   # 종료 시 git 자동 동기화
bash setup-bashrc.sh ~/my-project --shell=zsh        # zsh 사용자

명령어 목록

명령어	설명
ai	tmux 세션 "claude"에서 Claude Code 실행
ai pass	--dangerously-skip-permissions 옵션으로 실행
ain [이름]	이름 지정 tmux 세션 (tmux 내부면 window)
ain pass [이름]	이름 지정 세션 + skip-permissions
cleanup	모든 tmux 세션 목록 확인 및 종료 (확인 후)
cleanup <이름>	특정 tmux 세션 종료
ai-sync	수동 git 동기화 (add → commit → pull → push)

동작 방식

1. _ai_setup() 먼저 실행: 최신 코드 pull, settings.local.json 점검
2. Claude Code opus[1m]으로 tmux 세션 생성
3. Claude 종료 시: git 동기화 (--with-auto-push 옵션 사용 시)

사용법

인터랙티브 모드

/tofu-at

액션 메뉴 표시: Scan, Inventory, Spawn, Catalog.

워크플로우 분석

/tofu-at scan .claude/skills/my-workflow.md

워크플로우를 분석하여 팀 구성안을 제안하고, 선택 시 팀을 즉시 스폰합니다.

리소스 조회

/tofu-at inventory

사용 가능한 스킬, 에이전트, MCP 서버, CLI 도구 전체 목록을 표시합니다.

등록된 팀 즉시 실행

/tofu-at spawn km.ingest.web.standard --url https://example.com

registry.yaml에 등록된 팀을 즉시 생성하고 실행합니다.

팀 템플릿 저장

/tofu-at catalog my-team-id

팀 구성을 .team-os/registry.yaml에 저장/갱신합니다.

아키텍처