artwist-polyakov/polyakov-claude-skills

Agent Deck CLI

터미널 기반 AI 에이전트 세션 관리자입니다. 자식 Claude 세션을 실행, 제어하고 결과를 가져올 수 있습니다.

서브 에이전트 실행

트리거: "에이전트 실행", "서브 에이전트 실행", "launch sub-agent"

간단 실행 (CLI 명령어)

# 세션 생성
agent-deck add -t "세션 이름" -c claude /path/to/workdir

# 현재 에이전트의 자식 세션으로 생성
agent-deck add -t "세션 이름" --parent "부모 세션" -c claude /path/to/workdir

# 실행
agent-deck session start "세션 이름"

# 작업 전송
agent-deck session send "세션 이름" "작업 내용..."

자동 실행 (스크립트)

scripts/launch-subagent.sh "세션 이름" "프롬프트" [--mcp exa] [--wait]

스크립트는 자동으로:

• 현재 세션과 프로필을 확인합니다
• 자식 세션을 생성합니다
• Claude 초기화를 기다립니다
• 프롬프트를 전송합니다

결과 수집 모드

모드	명령어	사용 시기
Fire & forget	(--wait 없이)	기본값. "준비되면 알려줘"라고 말하세요
On-demand	agent-deck session output "세션 이름"	사용자가 결과를 요청할 때
Blocking	--wait	즉시 결과가 필요할 때

---

상태 확인

트리거: "세션 확인", "상태 확인", "check session"

agent-deck status                      # 모든 세션 (요약)
agent-deck session show "세션 이름"     # 특정 세션 상세 정보
agent-deck session show -json "세션 이름"  # JSON 형식
agent-deck session current             # 현재 작업 중인 세션
agent-deck session current --json      # 현재 세션을 JSON으로

상태 아이콘:

• ● 실행 중 (running)
• ◐ 입력 대기 (waiting)
• ○ 유휴 (idle)
• ✕ 오류 (error)

---

결과 확인

트리거: "에이전트 출력 보기", "에이전트가 뭐라고 했어", "show agent output"

agent-deck session output "세션 이름"

---

MCP 연결

agent-deck mcp list                        # 사용 가능한 MCP 서버 목록
agent-deck mcp attach "세션 이름" exa       # 세션에 MCP 연결
agent-deck session restart "세션 이름"      # MCP 연결 후 반드시 실행!

추천 MCP

작업	MCP 서버
웹 검색	exa, firecrawl
코드 문서화	context7
복잡한 추론	sequential-thinking

---

세션 관리

# 생명주기
agent-deck session start "세션 이름"
agent-deck session stop "세션 이름"
agent-deck session restart "세션 이름"

# 모든 세션 목록
agent-deck ls
agent-deck ls -json

# 세션 삭제
agent-deck rm "세션 이름"

---

중요 규칙

1. 플래그는 인자 앞에: session show -json name ( session show name -json 아님)
2. mcp attach 후 반드시 session restart를 실행하여 변경 사항을 적용하세요
3. 다른 에이전트의 결과를 폴링하지 마세요 — 대상 세션에 방해가 될 수 있습니다
4. 세션 식별: 이름, ID(6자 이상), 또는 경로를 사용할 수 있습니다

---

사용 예제

연구 에이전트 실행

# 웹 연구용 에이전트 생성
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "최신 AI 트렌드 정보를 찾아줘"

완료 확인

# 상태 확인
agent-deck session show "Researcher"

# 상태가 ◐ (waiting)이면 에이전트가 완료된 것, 결과 확인:
agent-deck session output "Researcher"