개발 팀을 위한 Pi 기반 공유 AI 하네스 구축기

저자는 개발 팀을 위한 공유 AI 하네스를 설계했는데, 'agent'라는 전용 Git 저장소를 중심으로 구성했습니다. 이 저장소에는 프로젝트 설명, 문서, Pi 설정, 내부 CLI 통합을 위한 스킬이 포함되어 있습니다. 작업 공간에는 메인 애플리케이션, 인프라, 테라폼, 텔레그램 봇, 분석, QA를 위한 형제 저장소가 포함됩니다. AGENTS.md 파일은 에이전트를 위한 프로젝트 맵과 규칙을 제공하며, 필요에 따라 관련 형제 저장소와 문서를 읽도록 안내합니다. 스킬은 SKILL.md 파일로 정의되며, 이 파일은 CLI를 사용해야 하는 시점과 운영 지침에 대한 참조(예: YouTrack에서 작업 읽기 또는 생성)를 지정합니다. 자격 증명은 Git에 포함되지 않도록 환경 변수를 통해 전달됩니다. 이 하네스는 작업 준비, 문제 조사, 변경 수행, 데이터 질문에 답변, 프로덕션 확인 등 다양한 시나리오를 지원합니다. 텔레그램 통합은 동일한 하네스를 사용하며, 채팅 어시스턴트가 에이전트를 Git 서브모듈로 고정하여 일관된 컨텍스트를 보장합니다. 설정에는 제한된 채팅 액세스, 범위가 제한된 자격 증명, 읽기 전용 프로덕션 데이터베이스, 변경 작업에 대한 승인 등 안전 조치가 포함됩니다.