Gentleman-Programming/gentle-ai

Gentle‑AI™ – 기존 AI 코드 에이전트를 위한 생태계 구성 도구

기능 설명

• Gentle‑AI는 자체 AI 모델을 제공하지 않습니다. 대신 이미 설치된 코드 보조 도구(Claude Code, Cursor, OpenCode 등)에 지속적 메모리, 계획, 기술 라이브러리, 보안 가드레일, 리뷰 워크플로우를 추가하는 옵션 컴포넌트 세트를 연결합니다.
• 도구는 작고 가벼운 Go 바이너리(gentle-ai)로 실행됩니다. 한 번의 설치 후 인터랙티브 터미널 UI를 시작하여 사용 중인 에이전트를 선택하고, 프리셋이나 개별 컴포넌트를 선택하면 프로그램이 에이전트의 네이티브 설정 디렉터리에 적절한 설정 파일을 작성합니다.

주요 컴포넌트

컴포넌트	목적
Engram™	재시작 후에도 유지되는 지속적 메모리로, 에이전트가 과거 결정, 버그 수정, 컨텍스트를 기억할 수 있습니다.
Skills	작업이 일치할 때 자동으로 로드되는 선택된 코드 "기술" 라이브러리입니다.
Persona	선택적 교육 중심의 음성(예: Gentleman 또는 중립)으로 사용자 정의 가능합니다.
Spec‑Driven Development (SDD)	대규모 기능을 위한 계획 워크플로우: 탐색 → 제안 → 사양 → 설계 → 작업 목록 → 구현 → 검증.
Context7	세션 중 실시간 프레임워크 및 라이브러리 문서를 가져오는 MCP(메타데이터 중심 프록시) 서버입니다.
Permissions	~/.ssh 또는 .env와 같은 민감한 경로에 대한 접근을 차단하는 보안 가드레일입니다.
GGA (Gentleman Guardian Angel)	다양한 백엔드로 요청을 라우팅할 수 있는 AI 제공자 스위처입니다.
Theme	지원되는 에이전트(Claude Code, OpenCode)용 선택적 시각 테마입니다.

프리셋은 이러한 컴포넌트를 묶어 빠른 설정을 가능하게 합니다:

• full‑gentleman – 모든 기능(메모리, SDD, 모든 기술 등)
• ecosystem‑only – 선택적 추가 기능을 제외한 핵심 컴포넌트
• minimal – Engram과 SDD만
• custom – 원하는 조합을 자유롭게 선택 가능.

지원되는 에이전트 Gentle‑AI는 Claude Code, OpenCode(서브에이전트 지원)부터 Windsurf와 같은 단일 에이전트 도구까지 다양한 기존 코드 에이전트와 호환됩니다. 각 에이전트에 대해 네이티브 설정 형식(TOML for Codex, ~/.cursor/agents/ 하위 파일 등)을 생성하며, 에이전트 자체의 위임 모델을 존중합니다.

설치 및 사용법

1. 사전 요구 사항 – Node 18+, npm, Git 2.38+, Go 1.25.10+ (Windows 또는 소스에서 빌드할 경우 필요). 사용 중인 AI 에이전트는 이미 PATH에 있어야 합니다.
2. 바이너리 설치 – macOS/Linux는 curl … | bash 단일 명령어, Windows는 go install … 사용.
3. TUI 실행 – gentle-ai를 실행하면 에이전트, 컴포넌트, 페르소나를 선택할 수 있습니다. 설정 파일 덮어쓰기 전에 기존 설정을 백업합니다.
4. 검증 – gentle-ai doctor는 읽기 전용 헬스 리포트(바이너리 존재 여부, Engram 접근성, 디스크 공간, 손상된 심볼릭 링크 등)를 생성합니다.

작업 결정 방식 Gentle‑AI는 요청에 따라 가능한 최소 워크플로우를 선택하는 라우팅 계층을 추가합니다:

• 소규모이고 범위가 명확한 변경 → 직접 인라인 실행.
• 중간 규모 변경(4개 이상 파일, 광범위한 조사 포함) → 추가 아티팩트 없이 위임된 서브에이전트가 작업 처리.
• 모호하고 대규모 기능 → 에이전트가 선택적 SDD 워크플로우를 제안하며, 승인 시에만 진행. 라우팅 결정은 이후 리뷰 단계와는 독립적입니다.

Spec‑Driven Development (SDD)

• "SDD 사용" 이라고 말하거나 에이전트의 제안을 수락하면 트리거됩니다.
• 지속 가능한 아티팩트(제안, 사양, 설계, 작업 목록)를 생성하며, Engram, 버전 관리 파일(OpenSpec) 또는 둘 다에 저장 가능합니다.
• 선택적 Research lane은 감사 가능한 외부 증거를 기록합니다.
• TDD가 활성화된 경우에도 이후 Receipt‑Driven Development (RDD) 리뷰와는 별개로 작동합니다.

Receipt‑Driven Development (RDD) (옵션)

• 구현 후 증거 기반 리뷰를 제공합니다.
• 후보(변경된 바이트), 프리즈(시작 시 스냅샷), 렌즈(위험, 회복력, 가독성, 신뢰성)의 세트를 정의합니다.
• 리뷰 작업량은 파일 수가 아니라 선언된 위험 수준에 따라 결정됩니다.
• 결과(정보적 증거)와 확인(에이전트가 리뷰 결과를 기록함)을 생성합니다.

문서 및 커뮤니티

• 전체 문서는 리포지토리의 docs/ 폴더와 공개 위키에 있습니다.
• "doctor" 명령어로 문제 해결이 가능합니다.
• 프로젝트는 MIT 라이선스이며 macOS, Linux, Windows를 지원합니다.

결론 Gentle‑AI는 단독 AI 코드 보조 도구를 더 체계적인 개발 파트너로 만드는 설정 계층입니다. 새로운 모델을 설치하지 않고도 메모리, 계획, 기술 선택, 그리고 선택적 증거 기반 리뷰를 추가합니다.