사람은 요구사항만 전달하고, AI 에이전트 팀이 알아서 수행합니다.
Pylon은 Claude Code 기반 멀티도메인 AI 오케스트레이터입니다. pylon을 실행하면 Claude Code TUI 세션이 직접 시작되고, 루트 에이전트(PO)가 사용자의 요구사항을 분석하여 적절한 도메인(소프트웨어 개발, 리서치, 콘텐츠 제작, 마케팅)과 워크플로우를 자동 선택하고 전문 에이전트 팀을 오케스트레이션합니다.
| 도구 | 용도 | 설치 |
|---|---|---|
| Go 1.24+ | 빌드 | https://go.dev/dl/ |
| git | 버전 관리 | 기본 설치 |
| gh | GitHub PR 생성 | brew install gh |
| Claude Code | AI 에이전트 백엔드 | https://docs.anthropic.com/en/docs/claude-code |
pylon doctor로 설치 상태를 확인할 수 있습니다.
Pylon은 CalVer(YYYY.M.SEQ, 예: 2026.6.3) 버전 체계를 사용하며,
플랫폼별 사전 빌드 바이너리를 GitHub Releases로 배포합니다.
Releases에서 플랫폼에 맞는 아카이브를 받습니다.
파일명 형식: pylon_<버전>_<OS>_<ARCH>.tar.gz (Windows는 .zip).
# 예시: macOS arm64, 최신 버전이 2026.6.3인 경우
curl -L -o pylon.tar.gz \
https://github.com/kyago/pylon/releases/latest/download/pylon_2026.6.3_darwin_arm64.tar.gz
tar -xzf pylon.tar.gz
sudo mv pylon /usr/local/bin/ # 또는 PATH에 포함된 임의 디렉토리로 이동
pylon version이후 업데이트는 pylon update 한 줄로 끝납니다 (아래 업데이트 참고).
go install github.com/kyago/pylon/cmd/pylon@latest참고: 릴리스 태그(
2026.6.3)는 Go 모듈 버전 형식(vX.Y.Z)이 아니므로go install은 항상main최신 커밋을 빌드하며@<버전>지정은 동작하지 않습니다. 이 경우pylon version은 릴리스 번호 대신 커밋 기반 의사 버전을 표시합니다. 특정 릴리스가 필요하면 사전 빌드 바이너리를 사용하세요.
go install은 바이너리를$GOPATH/bin(기본값:~/go/bin)에 설치합니다. 해당 디렉토리가PATH에 포함되어 있는지 확인하세요:export PATH="$PATH:$(go env GOPATH)/bin"
git clone https://github.com/kyago/pylon.git
cd pylon
make build # bin/pylon 생성
make install # $(go env GOPATH)/bin/pylon 설치설치된 바이너리는 내장 명령으로 GitHub Releases의 최신/특정 릴리스를 받아 스스로 교체합니다:
pylon update # 최신 버전 설치
pylon update 2026.6.3 # 특정 버전 설치 (CalVer)pylon update는 플랫폼에 맞는 바이너리를 내려받아 현재 실행 파일을 교체한 뒤, 자동으로
pylon doctor를 실행하여 워크스페이스의 내장 리소스(에이전트/스킬/커맨드/스크립트)와 설정
기본값을 최신 상태로 동기화합니다.
Windows는 실행 중인 바이너리 자동 교체를 지원하지 않으므로 Releases에서 수동으로 받으세요.
cd pylon
git pull origin main
make build
make installpylon version # 버전 확인
pylon doctor # 의존성 + 워크스페이스 리소스 동기화 상태 확인기존 워크스페이스 마이그레이션: 레거시 데이터(SQLite 메모리, Fossil 이력)는 새 버전으로 이전되지 않고 삭제됩니다. 슬래시 커맨드
/pl:migrate가 레거시 파일 폐기 절차를 안내합니다. 새 메모리(.pylon/memory/)와 이력(.pylon/history/pipelines/)은 빈 상태로 시작합니다.
mkdir my-workspace && cd my-workspace
pylon initpylon add-project https://github.com/user/my-app.gitpylonPermission Mode를 선택하면 Claude Code TUI 세션이 시작됩니다.
Permission Mode 선택
Claude Code 실행 권한을 설정합니다
> default — 매번 권한 확인
acceptEdits — 파일 편집 자동 허용
bypassPermissions — 모든 권한 자동 허용
TUI 세션에서 슬래시 커맨드 또는 자연어로 요구사항을 전달합니다:
> /pl:pipeline 로그인 기능 구현해줘
또는 직접 대화:
> 로그인 기능 구현해줘
PO: 몇 가지 확인이 필요합니다.
1. 인증 방식은 JWT와 세션 중 어떤 것을 선호하시나요?
2. 소셜 로그인도 필요한가요?
...
Claude Code TUI가 LLM-as-Orchestrator로 동작하며, 슬래시 커맨드와 셸 스크립트를 조합하여 전체 파이프라인(분석 → 설계 → 구현 → PR)을 자동 수행합니다.
사용자 ←→ Claude Code TUI (LLM-as-Orchestrator)
│
├── 슬래시 커맨드 (.pylon/commands/)
│ ├── /pl:pipeline ─ 전체 파이프라인
│ ├── /pl:architect ─ 아키텍처 분석
│ ├── /pl:breakdown ─ PM 태스크 분해
│ ├── /pl:execute ─── 에이전트 병렬 실행
│ ├── /pl:verify ─── 빌드/테스트/린트 검증
│ ├── /pl:pr ─────── PR 생성
│ ├── /pl:status ─── 파이프라인 상태 조회
│ ├── /pl:cancel ─── 취소 및 정리
│ ├── /pl:index ─── 코드베이스 인덱싱
│ ├── /pl:project-list ─ 프로젝트 목록 조회
│ ├── /pl:add-project ─ 프로젝트 추가
│ └── /pl:migrate ─── 레거시 마이그레이션 안내
│
└── 셸 스크립트 (.pylon/scripts/bash/)
├── init-pipeline.sh
├── run-verification.sh
├── create-pr.sh
└── ... (원자적 작업)
Pylon은 Go CLI가 워크스페이스를 준비한 뒤, Claude Code를 직접 실행(syscall.Exec)합니다. Claude Code TUI는 LLM-as-Orchestrator 패턴으로 동작하며, 슬래시 커맨드와 셸 스크립트를 조합하여 파이프라인을 실행합니다. 파일 기반 상태(artifact 존재 = 단계 완료)로 진행을 추적합니다.
| 개념 | 설명 |
|---|---|
.pylon/ |
워크스페이스 소스 오브 트루스 (설정, 에이전트 정의, 도메인 지식) |
.claude/ |
pylon 실행 시 .pylon/에서 동적 생성되는 Claude Code 설정 (agents 심링크, commands, hooks) |
| CLAUDE.md | 루트 에이전트의 시스템 프롬프트 (실행마다 자동 갱신) |
| 슬래시 커맨드 | AI가 사용하는 내부 스킬 (.pylon/commands/) |
| 파이프라인 | 파일 기반 워크플로우 (산출물 존재 = 단계 완료) |
| 프로젝트 메모리 | .pylon/memory/ 마크다운 파일 기반 지식 저장소 (git 추적) |
/pl:pipeline "로그인 기능 구현"
│
├─ [1] init-pipeline.sh ────── requirement.md
├─ [2] PO 분석 ────────────── requirement-analysis.md
├─ [3] Architect 분석 ──────── architecture.md
├─ [4] PM 태스크 분해 ──────── tasks.json
├─ [5] Agent 병렬 실행 ─────── execution-log.json
├─ [6] run-verification.sh ─── verification.json
├─ [7] create-pr.sh ────────── pr.json
└─ 완료 보고
TUI 세션 내에서 AI가 사용하는 내부 스킬입니다:
| 커맨드 | 설명 |
|---|---|
/pl:pipeline |
전체 파이프라인 실행 (요구사항 → 분석 → 설계 → 구현 → PR) |
/pl:architect |
아키텍처 분석 단독 실행 |
/pl:breakdown |
PM 태스크 분해 |
/pl:execute |
에이전트 병렬 실행 |
/pl:verify |
빌드/테스트/린트 교차 검증 |
/pl:pr |
PR 생성 |
/pl:status |
파이프라인 상태 조회 (파일 기반) |
/pl:cancel |
파이프라인 취소 및 정리 |
/pl:index |
프로젝트 코드베이스 인덱싱 |
/pl:project-list |
프로젝트 목록 및 인덱싱 상태 조회 |
/pl:add-project |
프로젝트를 워크스페이스에 clone하여 추가 |
/pl:migrate |
레거시 워크스페이스(SQLite/Fossil) 폐기·이전 절차 안내 |
pylon init 시 .pylon/agents/에 설치됩니다. pylon sync-agents로 최신 버전으로 갱신할 수 있습니다. PO가 요구사항을 분석하여 적절한 도메인의 에이전트를 자동 선택합니다.
| 에이전트 | 역할 |
|---|---|
| po | 프로덕트 오너 (요구사항 분석, 도메인 라우팅) |
| pm | 프로젝트 매니저 (태스크 분해, 조율) |
| architect | 아키텍트 (기술 방향성, 의존성 분석) |
| analyst | 분석가 (요구사항 분석) |
| backend-dev | 백엔드 개발자 |
| frontend-dev | 프론트엔드 개발자 |
| designer | UI/UX 디자이너 |
| test-engineer | 테스트 엔지니어 |
| code-reviewer | 코드 리뷰어 |
| code-simplifier | 코드 단순화 |
| debugger | 디버거 |
| devops | DevOps 엔지니어 |
| explorer | 코드베이스 탐색 |
| git-master | Git 워크플로 |
| perf-engineer | 성능 엔지니어 |
| refactorer | 리팩토링 |
| researcher | 리서치 |
| security-reviewer | 보안 리뷰 |
| tech-writer | 기술 문서 작성 |
| doc-specialist | 외부 문서 전문가 |
| tracer | 추적/디버깅 |
| verifier | 검증 |
| critic | 비평/리뷰 |
| 에이전트 | 역할 |
|---|---|
| lead-researcher | 리서치 리더 (조사 계획, 팀 조율) |
| web-searcher | 웹 검색 전문가 |
| academic-analyst | 학술 자료 분석가 |
| fact-checker | 팩트 체커 (교차 검증) |
| report-writer | 보고서 작성자 |
| 에이전트 | 역할 |
|---|---|
| content-strategist | 콘텐츠 전략가 |
| writer | 콘텐츠 작가 |
| editor | 편집자 |
| seo-specialist | SEO 전문가 |
| content-reviewer | 콘텐츠 QA 리뷰어 |
| 에이전트 | 역할 |
|---|---|
| market-researcher | 시장 조사 분석가 |
| copywriter | 카피라이터 |
| campaign-planner | 캠페인 기획자 |
| data-analyst | 마케팅 데이터 분석가 |
| brand-strategist | 브랜드 전략가 |
Go 바이너리가 제공하는 유틸리티 명령입니다. 루트 에이전트가 파이프라인 제어와 메모리 접근에 사용합니다.
| 명령어 | 설명 |
|---|---|
pylon |
Claude Code TUI 세션 실행 (기본 동작) |
pylon init |
워크스페이스 초기화 |
pylon doctor |
필수 도구(git/gh/claude) 확인 + 워크스페이스 리소스·설정 동기화 (--fix-excludes) |
pylon version |
버전 정보 |
pylon update [version] |
최신/특정 릴리스 바이너리로 자체 업데이트 |
pylon add-project <url> |
프로젝트를 워크스페이스에 clone하여 추가 |
pylon delete-project <name> |
프로젝트 등록 해제 (--purge로 디렉터리까지 삭제, --force로 확인 생략) |
pylon add-agent <name> |
커스텀 에이전트 추가 (--domain, --role) |
pylon add-skill <name> |
커스텀 스킬 추가 |
pylon status |
파이프라인 및 에이전트 상태 조회 |
pylon cancel [pipeline-id] |
진행 중인 파이프라인 취소 |
pylon uninstall |
워크스페이스 완전 제거 |
에이전트가 프로젝트 지식을 저장/검색할 때 사용합니다:
pylon mem list --project <name> # 메모리 목록
pylon mem search --project <name> --query "검색어" # 토큰 매칭 검색
pylon mem store --project <name> --key "키" --content "내용" # 저장 (--category 지정 가능)
pylon mem delete --project <name> --key "키" # 삭제 (--category, --dry-run 지원)| 명령어 | 설명 |
|---|---|
pylon sync-agents |
내장 에이전트 정의를 워크스페이스에 동기화 (--force로 덮어쓰기) |
pylon sync-memory |
세션 학습 내용을 프로젝트 메모리에 동기화 |
Pylon은 .pylon/history/pipelines/<pipeline-id>/<phase>/ 디렉토리 스냅샷에 선별된 작업 이력을
기록합니다. 파이프라인마다 계획 완료, 실행 완료, 최종 완료의 세 체크포인트가 생성됩니다.
pylon history log --pipeline <pipeline-id>
pylon history show <pipeline-id>/<phase>
pylon history diff <from-ref> <to-ref>
pylon history export <pipeline-id>/<phase> --output <new-directory>모든 명령에 --json 플래그를 추가하면 JSON 형식으로 출력됩니다.
workspace/
├── .pylon/ # 소스 오브 트루스 (git 추적)
│ ├── config.yml # 워크스페이스 설정
│ ├── agents/ # 에이전트 정의 (38종)
│ ├── skills/ # 에이전트 스킬
│ ├── domain/ # 팀 도메인 지식 (위키)
│ ├── commands/ # 파이프라인 슬래시 커맨드
│ │ ├── pl-pipeline.md
│ │ ├── pl-architect.md
│ │ └── ...
│ ├── scripts/bash/ # 파이프라인 셸 스크립트
│ │ ├── common.sh
│ │ ├── init-pipeline.sh
│ │ └── ...
│ ├── tasks/ # 확정된 태스크 스펙
│ ├── memory/ # 프로젝트 메모리 (git 추적)
│ │ └── {project}/ # 프로젝트별 <category>/<slug>.md + INDEX.md
│ ├── runtime/ # (git 무시)
│ │ ├── {pipeline-id}/ # 파이프라인별 산출물
│ │ └── sessions/ # 세션 상태
│ ├── conversations/ # 대화 이력 (git 무시)
│ └── history/ # 파일 기반 작업 이력 (git 무시)
│ └── pipelines/ # {pipeline-id}/{phase}/ 디렉토리 스냅샷
│
├── .claude/ # 동적 생성 (git 무시)
│ ├── agents/ # .pylon/agents/ 심링크
│ ├── commands/ # 슬래시 커맨드 심링크
│ └── settings.json # Claude Code hooks 설정
│
├── CLAUDE.md # 루트 에이전트 시스템 프롬프트 (동적 생성)
│
├── project-a/ # 프로젝트 디렉토리
│ └── .pylon/context.md # 프로젝트 컨텍스트
└── project-b/ # 프로젝트 디렉토리
.pylon/config.yml:
version: "0.1"
runtime:
backend: claude-code # AI 백엔드
max_concurrent: 5 # 동시 에이전트 수
max_turns: 50 # Claude 최대 턴 수
max_attempts: 2 # 검증 재시도 횟수
task_timeout: 30m # 태스크 타임아웃
permission_mode: acceptEdits # default | acceptEdits | bypassPermissions
env: # Claude Code 프로세스에 주입할 환경 변수
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: "80" # 자동 컴팩트 임계값(%)
CLAUDE_CODE_EFFORT_LEVEL: high # 추론 강도
git:
branch_prefix: task # 작업 브랜치 접두사
default_base: main # 기본 베이스 브랜치
auto_push: true # 자동 푸시
worktree:
enabled: true # git worktree 격리
auto_cleanup: true # 완료 후 자동 정리
pr:
draft: false
reviewers: []
wiki:
auto_update: true # 위키 자동 갱신
update_on:
- task_complete
- pr_merged
memory:
proactive_injection: true
proactive_max_tokens: 2000
retention_days: # 카테고리별 보존 일수 — 미지정/0 이하 = 영구 보존, {} = 전체 영구 보존
learning: 30
skills:
enabled: true # 에이전트 스킬 주입 활성화
preload_to_agents: true # .claude/agents/ 생성 시 스킬 주입
progressive_disclosure: true # 메타데이터만 주입(true) vs 전체 본문 주입(false)모든 설정에는 기본값이 있으므로 version 필드만 필수입니다. 위 예시는 전체 필드와 기본값을 보여주며,
명시하지 않은 필드는 로드 시 코드 기본값으로 자동 채워집니다. pylon init이 처음 생성하는 config.yml은
최소 필드(runtime의 backend/max_concurrent/max_turns/permission_mode)만 포함하고, 이후
pylon doctor가 누락된 필드를 감지해 기본값으로 동기화합니다.
make build # 빌드
make test # 테스트
make lint # 린트
make clean # 정리| 영역 | 기술 |
|---|---|
| 언어 | Go |
| CLI 프레임워크 | Cobra |
| TUI 컴포넌트 | charmbracelet/huh |
| 프로세스 실행 | syscall.Exec (최소 런처) + Claude Code Agent 도구 (서브에이전트) |
| 파이프라인 작업 | Shell Scripts (원자적 작업) |
| AI 백엔드 | Claude Code CLI |
| 저장소 | 마크다운/JSON 파일 (.pylon/memory, .pylon/history) |
| 메모리 검색 | 토큰 매칭 + INDEX.md 주입 |
| 작업 이력 | 디렉토리 스냅샷 (.pylon/history/pipelines) |
MIT