본문으로 건너뛰기

소개

10년 차 개발자가 코딩 에이전트에 붙인 원칙·설정·워크플로우·스킬을 정리한 가이드의 시작점.

코딩 에이전트에게 일을 맡기면서 붙인 규칙·훅·스킬과, 그게 왜 그 모양인지를 정리한 문서예요. 에이전트를 처음 켜는 법이나 설치 방법은 다루지 않아요. 가이드마다 동작 원리, 제 설정 순서로 읽으면 돼요.

레포 하나의 규칙·훅·스킬을 세 하네스가 같이 써요agent-config 레포 하나에 규칙, 훅, 스킬이 있어요. 규칙은 에이전트가 읽고 따르는 글이고, 훅은 규칙을 어기는 명령을 실행 전에 막고, 스킬은 작업 순서를 정해요. 이 세 가지를 Claude Code, opencode, pi 가 같이 써요.agent-config레포 하나규칙읽고 따라요훅어기면 막아요스킬순서를 정해요Claude Code · opencode · pi세 하네스가 같이 써요

다루는 것

  • 원칙 — 이 설정 전체를 받치는 원칙과 그 근거가 된 사고 기록
  • 에이전트 설정 — Claude Code·pi·opencode 의 규칙·훅·서브에이전트, 켜 두는 플러그인·MCP
  • 워크플로우 — 작업 하나가 계획에서 머지까지 가는 길
  • 자주 쓰는 스킬과 습관 — 워크플로우 단계마다 옆에서 부르는 스킬과, 손에 익은 습관
  • 지식 루프 — 끝난 작업의 기록이 지식베이스로 증류돼 다음 플랜으로 돌아오는 한 바퀴
  • Herdr — 에이전트 세션을 전부 띄워 두는 터미널 작업 공간