yzhao062/agent-style

21 writing rules for AI coding and writing agents. Drop-in for Claude Code, Codex, Copilot, Cursor, and Aider, so their output reads like a tech pro.

에이전트 스타일의 요소 – 무엇인가

agent-style 는 Python/Node용으로, AI 코딩 및 글쓰기 에이전트를 위한 21개의 글쓰기 규칙을 제공하는 작고 언어에 구애받지 않는 라이브러리입니다 (PyPI 및 npm에서 사용 가능). 이 규칙들은 스트랭크 & 화이트, 오웰, 핀커, 고펜 & 스완의 고전적 스타일 조언과 2022–2026년 사이에 LLM 생성 글쓰기에서 관찰한 패턴을 결합한 것입니다. 핵심 아이디어는 에이전트가 생성 시점에 규칙을 읽는 것입니다. 이는 시스템 프롬프트의 일부가 되어 모델이 첫 초안을 작성할 때 규칙을 따르려고 노력하게 하며, 이후에 텍스트를 수정하는 것보다 더 자연스럽게 스타일을 통합합니다.

규칙의 범위

적용 대상 문서 유형	적용 제외
API 문서, 설계 문서, 연구 논문, 기금 신청서, README, 런북, 커밋 메시지, 기술 블로그 글, 포스트모어텀, 이슈 리포트	소설, 시, 마케팅 콘텐츠, 장편 서사 비소설, 비영어 글쓰기, 리듬이나 감정이 정확성보다 더 중요한 글

21개의 규칙은 두 개의 동등한 그룹으로 나뉩니다:

RULE‑01 … 12 – 네 가지 고전적 스타일 참고문헌에서 직접 인용된 정립된 규칙으로, 각각 정확한 출처를 명시합니다.
RULE‑A … I – LLM 특유의 반복적인 실수를 포착한 ‘현장 관찰 규칙’ (예: 점선의 과도한 사용, 대시의 남용, 반복되는 문장 시작, 불필요한 전환어, 인용 누락 등).

두 그룹 모두 동등하게 취급되며, 우선순위가 높은 규칙은 없습니다.

작동 방식

소프트 강제 (생성 시점) – 사용 중인 AI 도구(Claude Code, GitHub Copilot, Cursor, Aider 등)에 맞는 agent-style enable <adapter> 를 실행합니다. CLI는 도구가 시스템 프롬프트로 읽는 위치에 작은 규칙 파일을 작성하거나 마커 블록을 추가합니다. 모델이 텍스트를 생성할 때 규칙이 컨텍스트에 포함되어, 원하는 스타일로 자연스럽게 유도됩니다.
스킬 / 두 번째 검토 – 초안 생성 후 agent-style style-review <path> 를 실행하거나 (또는 스킬을 지원하는 호스트에서 style-review 스킬을 호출), 동일한 21개의 규칙에 따라 초안을 심사합니다. 승인을 얻은 후 원본과 함께 다듬어진 버전을 생성합니다.

이 패키지는 많은 인기 있는 에이전트(Claude Code, Codex/AGENTS.md, GitHub Copilot, Cursor, Anthropic Skills, Kiro 등)용 어댑터를 포함하며, 설치 없이 .agent-style 폴더에 규칙 파일을 다운로드하는 curl 레시피도 제공합니다.

도움이 되나요?

저자는 10개의 고정된 기술적 글쓰기 작업(제품 설명, 설계 문서 섹션, 논문 관련 연구, PR 설명, 커밋 메시지 등)에 대한 정신 건강 벤치마크를 포함하고 있습니다. 각 작업에서 모델은 규칙을 로드한 상태와 로드하지 않은 상태로 두 번 실행되었으며, 기계적 리뷰어가 규칙 위반 수를 세었습니다.

모델 (2026)	규칙 없음	규칙 있음	감소율
Claude Opus 4.7	88	47	‑47 %
OpenAI GPT‑5.4 (Codex CLI)	48	26	‑46 %
Gemini 3 Flash	65	9	‑86 %
GitHub Copilot (컨트롤)	52	52	0 %

벤치마크는 ‘기계적 전용 모드’에서 작동하므로, 규칙의 일부(7개의 기계적 규칙)만 측정됩니다. 가장 큰 개선은 긴 문장 감소(RULE‑12), em/en 대시 회피(RULE‑B), 전문 용어 제거(RULE‑06)에서 나타납니다. 의미적 규칙(예: 인용의 엄격함(RULE‑H), 지식의 저주(RULE‑01))은 현재 벤치에 포함되지 않아 수치는 방향성만을 나타내며, 통계적 유의성 주장은 아닙니다.

누구에게 적합한가?

AI 코딩 또는 글쓰기 보조 도구 개발자 (Claude Code, Codex, GitHub Copilot, Cursor, Aider, Kiro, Replit 등)로, 에이전트가 더 명확하고 전통적인 기술 문서를 생성하도록 하고 싶은 사람.
이러한 에이전트의 유지보수자로, 모델 프롬프트에 스타일 가이드를 간단히 삽입하거나, 생성 후 검토 단계를 추가하고 싶은 사람.

빠른 시작 (Python 예제)

pip install agent-style          # 또는 npm i -g agent-style
agent-style enable claude-code   # Claude Code용 규칙 파일 작성
# 나중에 초안이 생성된 후:
agent-style style-review path/to/file.md

README에는 각 지원 도구에 대해 생성되는 파일 목록, 향후 계획된 어댑터 목록, BAD/GOOD 예제를 포함한 전체 RULES.md 가 포함되어 있습니다.

결론: agent-style 는 어떤 LLM 기반 글쓰기 에이전트의 프롬프트에 간결하고 문헌 기반의 스타일 가이드를 삽입할 수 있는 실용적이고 오픈소스 도구이며, 생성 후 가벼운 규칙 기반 검토를 선택적으로 실행할 수 있습니다. 새로운 모델이나 학습 파이프라인을 구축하는 것이 아니라, AI 생성 기술 문서의 명확성과 일관성을 향상시키는 데 초점을 맞춘 전문 분야에 적합합니다.