Pylon

사람은 요구사항만 전달하고, 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로 배포합니다.

1) 사전 빌드 바이너리 (권장)

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 한 줄로 끝납니다 (아래 업데이트 참고).

2) go install

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"

3) 소스 빌드

git clone https://github.com/kyago/pylon.git
cd pylon
make build    # bin/pylon 생성
make install  # $(go env GOPATH)/bin/pylon 설치

업데이트

pylon update (권장)

설치된 바이너리는 내장 명령으로 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 install

업데이트 후 확인

pylon version    # 버전 확인
pylon doctor     # 의존성 + 워크스페이스 리소스 동기화 상태 확인

기존 워크스페이스 마이그레이션: 레거시 데이터(SQLite 메모리, Fossil 이력)는 새 버전으로 이전되지 않고 삭제됩니다. 슬래시 커맨드 /pl:migrate가 레거시 파일 폐기 절차를 안내합니다. 새 메모리(.pylon/memory/)와 이력(.pylon/history/pipelines/)은 빈 상태로 시작합니다.

빠른 시작

1. 워크스페이스 초기화

mkdir my-workspace && cd my-workspace
pylon init

2. 프로젝트 추가

pylon add-project https://github.com/user/my-app.git

3. 실행

pylon

Permission Mode를 선택하면 Claude Code TUI 세션이 시작됩니다.

Permission Mode 선택
Claude Code 실행 권한을 설정합니다

> default — 매번 권한 확인
  acceptEdits — 파일 편집 자동 허용
  bypassPermissions — 모든 권한 자동 허용

4. 파이프라인 실행

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) 폐기·이전 절차 안내

내장 에이전트 (38종)

pylon init 시 .pylon/agents/에 설치됩니다. pylon sync-agents로 최신 버전으로 갱신할 수 있습니다. PO가 요구사항을 분석하여 적절한 도메인의 에이전트를 자동 선택합니다.

소프트웨어 개발 (23종)

에이전트	역할
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	비평/리뷰

리서치/조사 (5종)

에이전트	역할
lead-researcher	리서치 리더 (조사 계획, 팀 조율)
web-searcher	웹 검색 전문가
academic-analyst	학술 자료 분석가
fact-checker	팩트 체커 (교차 검증)
report-writer	보고서 작성자

콘텐츠 제작 (5종)

에이전트	역할
content-strategist	콘텐츠 전략가
writer	콘텐츠 작가
editor	편집자
seo-specialist	SEO 전문가
content-reviewer	콘텐츠 QA 리뷰어

마케팅 (5종)

에이전트	역할
market-researcher	시장 조사 분석가
copywriter	카피라이터
campaign-planner	캠페인 기획자
data-analyst	마케팅 데이터 분석가
brand-strategist	브랜드 전략가

CLI 명령어

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

Name		Name	Last commit message	Last commit date
Latest commit History 380 Commits
.claude/commands		.claude/commands
.github/workflows		.github/workflows
claudedocs		claudedocs
cmd/pylon		cmd/pylon
docs		docs
internal		internal
specs		specs
testdata		testdata
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
CLAUDE.md		CLAUDE.md
Makefile		Makefile
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Folders and files

Latest commit

History

Repository files navigation