agent-rules-books
무엇인가
agent-rules-books는 리팩터링, 아키텍처 경계, 도메인 모델링, 데이터 집약 시스템의 신뢰성처럼 설계 단계에서 반복적으로 갈리는 문제 영역을 규칙 목록으로 고정해 에이전트에 주입한다. 코드 품질·의존성 방향·트랜잭션과 일관성 시맨틱·실패 격리 같은 항목을 책별 규칙 세트로 나눠 두고, 작업 중 에이전트가 그 규칙을 근거로 구현 결정을 내리게 한다.
어떻게 동작하나
각 책 디렉터리에는 표준 SKILL.md 진입점이 있고, 규칙 본문은 도구 비종속 Markdown 세 가지 버전으로 배포된다. mini는 실제 작업용 권장본, nano는 컨텍스트 예산이 매우 좁을 때의 축약본, full은 전체 원본 겸 참조본이다. 스킬은 기본적으로 해당 책의 mini 세트를 로드하고 full 파일을 더 깊은 참조 자료로 남겨 둔다. USAGE.md는 상시 적용(always-on)과 요청 시 적용(on-demand), 스코프 규칙 같은 배치 방식을 편집기별로 정리한다.
무엇과 다른가
프롬프트를 매번 직접 쓰는 방식과 달리 규칙이 저장소 안 파일로 남아 버전 관리되고, 책 단위로 분리돼 필요한 스킬만 골라 설치할 수 있다. 단일 CLAUDE.md·AGENTS.md에 모든 규칙을 몰아넣는 방식과도 다르다. 컨텍스트 예산에 따라 mini·nano·full 중 하나를 고르고, 스코프 규칙으로 특정 경로에만 적용 범위를 좁힐 수 있으며, 규칙 본문이 특정 편집기 형식에 묶이지 않는다.
어떻게 쓰나
설치는 Node.js와 npm이 있는 환경에서 npx로 Agent Skills CLI를 실행한다. 전체 설치는 `npx skills add ciembor/agent-rules-books --all`, 설치 없이 목록만 보려면 `npx skills add ciembor/agent-rules-books --list`, 개별 설치는 `npx skills add ciembor/agent-rules-books --skill refactoring`처럼 책 이름을 지정한다. 수동 설치나 편집기별 배치가 필요하면 USAGE.md의 패턴을 따른다.
전제와 한계
Codex, Cursor, Claude Code에서 쓰도록 안내되며 MIT 라이선스다. 규칙은 Markdown 텍스트로 주입될 뿐 위반을 자동 검증하거나 차단하는 실행 장치가 아니므로, 규칙 준수 여부는 에이전트의 판단과 리뷰에 의존한다.
유사 스킬
- copilot-instructionsCopilot에 DDD·클린 아키텍처·CQRS·테스트 규칙과 TDD 우선 워크플로를 주입하는 프롬프트 팩이다. instructions·skills·agents·plugins로 배포한다.
- cc-skills커밋·브랜치 명명, Chrome 확장 MV3 구조, 카피라이팅 훅·CTA, 기술 글쓰기 규칙을 SKILL.md 단위로 쪼개 필요할 때만 컨텍스트에 로드하는 Claude Code 플러그인이다.
- pm-claude-skillsPRD 작성·계약서 해독·사후 분석 등 업무별 절차를 SKILL.md로 주입해 프레임워크·출력 템플릿·품질 검사·안티패턴에 따라 산출물을 내도록 강제하는 Claude Code 플러그인이다.