Install
pnpm dlx @codeharbor/agent-playbook init누구에게 맞나
코딩 Agent에 로컬 우선 Behavior CI, 즉 행동 지속 통합을 더하고 싶을 때 Agent Playbook을 쓰세요. 공식 한 줄 위치는 Local-first Behavior CI for coding agents입니다. Claude Code, Codex, Gemini, DeepSeek Harness용 스킬을 설정합니다. 이미 이 네 호스트를 쓰고, init이 저장소에 설정을 쓴다는 점을 받아들이는 사람에게 맞습니다. 요약은 반복 교정을 되돌릴 수 있는 행동 변경으로 바꾼다고 하지만, 페이지의 그 소개 문장은 메커니즘을 펼치지 않으므로, 적히지 않은 수신함이나 자기 개선 흐름을 입증된 능력으로 보지 마세요. hooks 캡처를 전혀 받아들일 수 없으면 기본을 유지하세요. 새 설치는 Claude hooks를 끕니다.
3분 만에 첫 시도
공식 우선 초기화만 권합니다.
pnpm dlx @codeharbor/agent-playbook init
같은 페이지에 npm 표기도 있습니다.
npm exec -- @codeharbor/agent-playbook init
처음에는 pnpm 줄을 쓰세요. 이는 파일을 쓰므로 읽기 전용이 아닙니다. 먼저 Agent가 되풀이하게 하세요. 현재 저장소에서 init을 실행하고, Claude Code, Codex, Gemini, DeepSeek Harness에 스킬을 설정하며, 기본으로 Claude hooks는 켜지 않는다고. 작업 영역 경로를 확인한 뒤에만 실행을 허용하세요. 나타나지 않은 skills add로 바꾸지 말고 스킬 디렉터리도 만들지 마세요.
성공 신호: 초기화가 끝나고, 그때 --hooks를 분명히 요청하지 않는 한 hooks는 꺼진 채입니다. 공식은 apb를 agent-playbook의 짧은 별칭이라고 적습니다. 처음에는 apb 하위 명령을 만들지 마세요. 페이지가 보장하는 것은 별칭 자체뿐입니다. 초기화 후 읽기 전용 질문을 한 번 하고, Agent가 이 저장소에서 Behavior CI가 무엇을 뜻하는지 설명하게 하며, 행동 규칙은 아직 바꾸지 마세요.
사용 사례
사례 1: 네 호스트용 스킬을 초기화합니다. 프로젝트 루트에서 init을 실행해 Claude Code, Codex, Gemini 또는 DeepSeek Harness가 Playbook 스킬을 읽게 하세요. 행동 제약을 로컬 저장소에 남기고 싶은 사람에게 맞습니다. 설명은 생성될 파일 이름을 나열하지 않으므로, 실행 전에 확인할 수 있는 것은 「설정을 쓴다」뿐이며 경로를 미리 채울 수 없습니다.
사례 2: Claude hooks를 명시적으로 켭니다. 공식은 새 설치가 기본으로 비활성한다고 적습니다. --hooks를 붙일 때만 경계 있고 비식별화된 비공개 세션 요약과 실패 캡처가 켜집니다. 실패한 세션을 돌아보고 요약 캡처를 받아들이는 사람에게 맞습니다. 켜기 전에 Agent가 되풀이하게 하세요. bounded, redacted 비공개 요약과 실패 캡처를 켤 것이며 기본 설치가 아니라고. --hooks를 기록되지 않은 다른 클라이언트 스위치에 붙이지 마세요. 요약이 언급한 행동 수신함과 자기 개선은 페이지에 명령이 없으니 만들지 마세요.
사용 한계
기본 명령은 pnpm dlx @codeharbor/agent-playbook init입니다. npm exec는 나란한 표기이며 세 번째 설치기가 아닙니다. 호스트 이름은 Claude Code, Codex, Gemini, DeepSeek Harness입니다. 스킬이 설정되는 범위이며 「이 네 곳만 SKILL.md를 읽는다」는 전 세계 단정이 아닙니다. 새 설치는 기본으로 hooks를 끄고, --hooks가 비식별화 요약을 캡처합니다. apb는 별칭으로만 적혀 있습니다. 적히지 않은 하위 명령, 디렉터리, 상점 설치는 채우지 마세요. 저장소 페이지:
https://github.com/zhaono1/agent-playbook