Gentleman-Programming/gentle-pi

해결하는 문제

많은 AI 코드 에이전트의 실패는 모델의 지능 부족 때문이 아니라, 운영적 규율 부족 때문입니다. 흔한 문제로는 요구사항이 명확해지기 전에 코드에 뛰어드는 것, 채팅 기록에 아키텍처 결정이 사라지는 것, 과도한 크기의 풀 리퀘스트를 생성하는 것, 테스트를 소홀히 하는 것이 있습니다. gentle-pi는 엔지니어링의 엄격함과 구조화된 워크플로우를 강제함으로써 Pi 코드 에이전트를 제어 가능한 개발 환경으로 전환합니다.

작동 방식

Pi에 "시니어 아키텍트" 운영 계층인 el Gentleman을 설치합니다. 이 계층은 Spec-Driven Development (SDD)와 OpenSpec를 도입하여, 대규모 또는 위험한 변경 사항이 초기화, 설계, 검증의 엄격한 파이프라인을 거치도록 보장합니다. 복잡도에 따라 작업을 라우팅합니다: 작은 수정은 인라인으로 유지하고, 컨텍스트가 많은 탐색은 집중형 하위 에이전트에게 위임하며, 아키텍처 변경은 SDD 흐름을 트리거합니다.

품질을 유지하기 위해 엄격한 TDD(Test-Driven Development) 지원을 구현하여, RED → GREEN → TRIANGULATE → REFACTOR 사이클의 증거를 요구합니다. 또한 검증된 네이티브 런타임을 통합하여 파괴적인 쉘 명령어를 차단하고 민감한 파일 경로에 대한 접근을 보호합니다.

대상 사용자

Pi 코드 에이전트를 사용하면서 단순한 채팅 기반 개발을 넘어, 검토 가능한 작업 단위와 아키텍처 가드레일을 갖춘 체계적이고 전문적인 엔지니어링 환경을 원하는 개발자들입니다.

주요 특징

• Spec-Driven Development (SDD): 복잡한 변경 사항을 처리하기 위한 단계별 에이전트(초기화, 설계, 작업, 검증 등)의 구조화된 체인 제공.
• 서브에이전트 오케스트레이션: 탐색 및 구현을 전문적인 자식 에이전트에게 위임함으로써 부모 세션을 가볍게 유지.
• uma Skill Discovery Registry: 프로젝트 및 사용자 기술을 등록하여 작업에 적절한 전문 지식이 적용되도록 보장.
• 엄격한 TDD 증거: 프로젝트 설정에서 요구할 경우, 테스트 주도 개발 사이클의 기록을 강제.
• 런타임 안전성: 파괴적인 명령어 및 민감한 경로 접근을 차단하는 검증된 네이티브 런타임 포함.