Gentleman-Programming/gentle-shell

gentle-shell™ – Pi 개발 환경을 위한 AI 기반 코딩 에이전트

무엇인가요 – gentle-shell(배포 패키지: gentle-pi)은 터미널 기반 워크스페이스로, 대규모 언어 모델(LLM)을 기반으로 하는 코딩 에이전트를 프로젝트 내부에서 실행할 수 있게 해줍니다. 에이전트는 코드베이스를 탐색하고, 변경 사항을 제안하며, 테스트를 실행하고, 변경 사항을 표시할 수 있습니다. 동시에 활성 작업, 세션 변경 사항, 런타임 상태를 보여주는 UI를 통해 사용자는 항상 제어권을 유지할 수 있습니다.

핵심 아이디어

• 워크스페이스 중심 – 쉘은 단일 패널(/gentle:… 명령어)을 제공하여 에이전트의 작업, 하위 에이전트, 할 일 목록을 통합하여 타이머에서 벗어나지 않고 작업할 수 있습니다.
• 집중형 에이전트 – 부모 세션은 제한된 ‘워커’ 에이전트(예: 리포지토리 매핑, 변경 사항 구현, 검증)를 생성하고, 간결한 확인과 증거를 받을 수 있습니다.
• 유기적 개발 주도(Organic Driven Development, ODD) – 기본 워크플로우는 가벼운 단계적 작업을 장려합니다: 원하는 결과를 설명하고, 에이전트가 행동하게 한 후, 구체적인 변경 사항을 검토합니다. 더 큰, 단계적 작업에는 선택적 사양 기반 개발(Specification-Driven Development, SDD) 사이클이 제공됩니다.
• 네이티브 리뷰 – 어떤 변경 사항도 적용되기 전에, 에이전트는 승인, 거부, 수정 요청이 가능한 '고정된 후보 변경 사항(diff)'을 제시하여 인간이 항상 루프에 참여할 수 있도록 합니다.
• 확장 가능한 '동반자' – 선택적 패키지(gentle-engram, pi-intercom 등)는 지속적 메모리, 세션 간 메시징, 웹 접근 등 기능을 추가하지만 필수는 아닙니다.

시작하기

# 최신 안정판(v2.6.0, 작성 시점 기준) 설치
pi install npm:gentle-pi@2.6.0

# Pi 재시작 후 자산 동기화
gentle-ai sync

# 프로젝트 내에서 Pi REPL 실행 – gentle-shell UI 표시
pi

이후 /gentle:status, /gentle:doctor, /gentle:review-mode enable 등의 내장 명령어를 사용해 에이전트 상태를 확인하거나, 문제 진단, 선택적 리뷰 모드 활성화가 가능합니다.

주요 문서

• 워크스페이스 레이아웃 – docs/gentle-shell.md는 패널, /gentle:changes 뷰, UI 탐색 방법을 설명합니다.
• ODD 워크플로우 – docs/readme-reference.md#organic-driven-development는 일상적인 ‘의도 → 결과’ 루프를 단계별로 안내합니다.
• SDD/OpenSpec 흐름 – 선택적 형식적 단계는 동일한 참조 문서의 SDD/OpenSpec 섹션에 설명되어 있습니다.
• 리뷰 통합 – docs/review-integration.md는 에이전트가 구체적인 변경 사항을 인간의 승인을 위해 넘기는 경계를 상세히 설명합니다.
• 네이티브 권한 아키텍처 – docs/native-authority-architecture.md는 파괴적 작업에 대한 소유권과 안전 경계를 명확히 설명합니다.

커뮤니티 및 지원

• 이슈 및 기능 요청: https://github.com/Gentleman-Programming/gentle-pi/issues
• 실시간 도움을 위한 디스코드 채팅: https://discord.com/invite/gentleman-programming-769863833996754944
• 기여자는 리포지토리의 기여자 그래프에 나열되며, contrib.rocks 배지로 시각화됩니다.

라이선스 – MIT (자세한 내용은 LICENSE 참조). 프로젝트의 상표(gentle-shell™, gentle-pi™)는 저자인 Alan Buscaglia에게 귀속됩니다.

---

gentle-shell은 진정한 오픈소스 도구로, LLM 기반 코딩 어시스턴트를 개발자의 터미널에 직접 도입하여, 빠른 수정부터 형식적으로 사양된 대규모 변경까지 구조적이고 유연한 워크플로우를 제공합니다.