내 PI 에이전트 하네스 설정 - 자동 호출 스킬 중심
My PI agent harness setup - auto invocable skills focused
핵심 요약
INDEX.md 파일을 활용해 PI 에이전트의 자율성을 높인 워크플로우 설정 공유.
- 자동화 설정 — INDEX.md를 통해 에이전트의 스킬 사용을 강제하고 워크플로우를 일관되게 유지함.
- QOL 확장 프로그램 — 메모리 관리 및 토큰 절약을 위한 다양한 도구들을 통합함.
- 워크플로우 최적화 — Superpowers와 Matt Pocock의 방식을 결합하여 수동 개입을 최소화함.
PI 설정이긴 하지만, 내 방식은 모든 하네스 에이전트에 다 적용됨. 이유는 다음과 같음:
Extensions
이 설정에 포함된 대부분의 확장 기능은 그냥 삶의 질(QOL) 개선용임:
-
메모리
관리를 위한pi-blackhole. -
토큰 절약을 위한rtk와headroom. -
guardrails,ask questions그리고 UI 관련 몇 가지 기능들.
Skills
이 설정의 핵심은 이거임. 여기 있는 기술 대부분이 자동으로 호출되긴 하지만, 모든 하네스가 강제로 읽고 따르게 만드는 global INDEX.md 파일을 추가해서 더 자율적으로 만들었음. 이 INDEX.md 파일은 특정 기술들을 항상 사용하도록 강제해서 일관성을 유지하게 해줌 (예: i-have-adhd 기술이나 전체 워크플로우 같은 거).
- 워크플로우는
superpowers워크플로우랑matt pocock워크플로우를 합친 거임 (매트 방식은 사전 설정이 많이 필요한 수동 방식이라, 좀 더 자율적으로 돌아가게 내가 몇 군데 수정했음).
특정 기능을 구현할 때는 그냥
grill-me나grill-with-docs를 씀. 나머지는 INDEX.md 파일이 알아서 처리함. 보통 이런 식으로 돌아감: grill-me/grill-with-docs (사용 시) -> 브레인스토밍 -> 계획 작성 -> 계획 실행 -> TDD -> 코드 리뷰 요청 -> 완료 전 검증.
# pi config
https://github.com/silentFellow/public-dotfiles/tree/main/pi
skills config
should be used at ~/.agents - global skill config path
https://github.com/silentFellow/public-dotfiles/tree/main/agents

