파일럿 쉘: 클로드 코드를 위한 구조화된 워크플로우 레이어

Pilot Shell은 Claude Code 위에 설치되는 오픈소스 레이어로, 계획, 수정, 브레인스토밍을 위한 구조화된 워크플로우를 적용합니다. 테스트 생략, 컨텍스트 손실, 일관성 없는 출력과 같은 일반적인 문제점을 해결하면서 수십 개의 에이전트나 수천 줄의 설정이 필요한 프레임워크의 오버헤드를 피합니다.

주요 구성 요소

• /spec — TDD로 기능을 처음부터 끝까지 계획, 구현 및 검증합니다.
• /fix — TDD를 사용한 버그 수정 워크플로우; 복잡도가 표준 수정 범위를 초과하면 중단합니다.
• /prd — 아이디어를 명확한 요구사항으로 발전시키며, 선택적으로 심층 조사를 수행합니다.
• 품질 후크 — 린팅, 포맷팅, 타입 검사, 테스트를 품질 게이트로 강제합니다.
• 컨텍스트 엔지니어링 — 세션 간 결정 사항과 지식을 보존합니다.
• 코드 인텔리전스 — 의미 검색(Probe) + 코드 지식 그래프(CodeGraph).
• 토큰 최적화 — RTK 및 컨텍스트 모드를 통해 비용을 60~90% 절감합니다.
• 확장 기능 — 재사용 가능한 규칙, 스킬, MCP 서버를 팀 공유 및 커스터마이징과 함께 제공합니다.
• 콘솔 — 실시간 알림 및 세션 관리를 지원하는 로컬 웹 대시보드입니다.
• Pilot Bot — 예약 작업 및 백그라운드 작업이 있는 지속적 자동화 에이전트입니다.

설치

macOS, Linux, Windows(WSL2)에서 작동합니다. 단일 명령어로 전역 설치됩니다:

curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

모든 도구와 규칙은 ~/.pilot/ 및 ~/.claude/에 위치합니다. 설치 후 프로젝트 디렉토리에서 pilot 또는 ccp를 실행하세요.

대상 사용자

이미 Claude Code를 사용 중이며, 무거운 에이전트 프레임워크로 전환하지 않고 구조화되고 반복 가능한 워크플로우를 원하는 개발자.