<div align="center">
AndySoul
프로젝트 루트 디렉터리에 넣는 규칙 파일로, Claude Code, Codex, Cursor가 흔히 저지르는 실수를 줄여줍니다.
생각한 후에 코드를 작성하기 · 수정해야 할 부분만 바꾸기 · 매 단계마다 검수하기 · 확신이 서지 않으면 바로 말하기
License: MIT
GitHub stars
PRs Welcome
간체 중국어 · English · 템플릿 · 전후 비교 예시
</div>
요약(TL;DR): AndySoul은 AI 리더 Andy가 공개한 CLAUDE.md / AGENTS.md / .cursorrules 규칙 템플릿입니다. Claude Code, Codex, Cursor를 사용하여 코딩하는 개발자에게 적합합니다. 이 파일을 프로젝트 루트 디렉터리에 넣으면, AI 프로그래밍 에이전트(Agent)가 먼저 생각한 후에 작성하고, 수정해야 할 부분만 바꾸며, 매 단계마다 검수하여 흔한 오류를 줄여줍니다.
저자: AI 리더 Andy (Andy Liu; Flow AI 공동 창립자, StarSense AI 설립자; GitHub @AIPMAndy · X @AIPMAndy · metaver.vip)
CLAUDE.md / AGENTS.md 규칙 템플릿을 찾고 계신가요? AndySoul은 프로젝트 루트 디렉터리에 바로 넣을 수 있는 규칙 파일입니다. Claude Code는 CLAUDE.md를 읽고, Codex는 AGENTS.md를 읽으며, Cursor는 .cursorrules를 읽습니다. 같은 내용을 다운로드하여 해당 이름의 파일로 저장하면 사용할 수 있습니다.
English: a drop-in CLAUDE.md / AGENTS.md / .cursorrules rules template that helps Claude Code, Codex and Cursor make fewer mistakes.
30초 만에 설치하기
curl -o CLAUDE.md https://raw.githubusercontent.com/AIPMAndy/AndySoul/main/CLAUDE.md
...
다른 Agent의 경우: CLAUDE.md의 내용을 해당 에이전트의 시스템 프롬프트 또는 프로젝트 지침 파일에 붙여넣으세요.
설치 후 달라지는 점
이전 (일반적인 LLM 행동):
사용자: "로그인 폼에 유효성 검사를 추가해줘"
AI: [유효성 검사 추가 + 폼 리팩토링 + 스타일 업데이트 + 사용되지 않은 오류 상태 추가]
이후 (AndySoul 사용 시):
사용자: "로그인 폼에 유효성 검사를 추가해줘"
AI: "이메일/비밀번호 유효성 검사를 추가하겠습니다. 계획:
1. 유효성 규칙 추가 → 무효 입력으로 테스트 진행
...
EXAMPLES.md에는 로그인 추가, 인터페이스 타임아웃 수정, 데이터 분석, 리팩토링 등 5가지 세부 전후 비교 사례가 있습니다.
규칙의 출처
- 9가지 인지 공리: 엔트로피 증가(Entropy Increase), 환원론(Reductionism), 확률과 불확실성 등
- 마스크(Musk) 5단계 공학법: 의심하기 → 삭제하기 → 단순화하기 → 가속화하기 → 자동화하기
- Karpathy의 4가지 코딩 원칙: 먼저 생각하고 작성하기, 단순성을 우선시하기, 외과 수술식 수정(Surgical Modification), 목표 지향적 실행
이것들이 Agent에게 적용된 것이 바로 다음 내용입니다:
- 먼저 요구사항을 의심하여, 정말 필요한 것인지 확인한 후에 작업에 착수합니다.
- 반드시 수정해야 할 부분만 수정하며, 모든 라인 변경은 당신의 요구사항과 일치하고 주변 코드를 임의로 "최적화"하지 않습니다.
- 모든 단계마다 검수 기준을 두어 스스로 확인합니다.
- 데이터를 미화하지 않습니다: 명확하게 보이지 않는 것은 추측하지 않고, 계산 과정은 모두 작성하며, 틀린 부분은 즉시 인정합니다.
- 불확실하면 질문하고, 대신 결정해주지 않습니다.
6가지 시나리오 템플릿
TEMPLATES.md에는 시나리오별로 준비되어 있습니다: 초간단 버전(Minimal), 풀스택 버전(Full Stack), 데이터 집약형(Data Intensive), 스타트업 MVP 등. 자신에게 적합한 부분을 유지하고, 여기에 자신의 기술 스택, 프로젝트 규칙, 팀의 git 습관 및 도메인 지식을 추가하세요.
누가 사용하기 좋은가?
- AI Agent가 오류를 적게 내고 추론 과정이 투명하기를 원하는 사람
- 변경 사항이 작고 정확한 것을 중요하게 생각하는 사람
- 프로젝트의 데이터 정확도 요구 수준이 높은 경우
포함하지 않은 것: 프로젝트 스캐폴딩(Scaffolding), CI/CD, 기술 스택 등이며, 사용자의 자체 규칙을 대체할 수 없습니다.
선택과 집중: 이 규칙 세트는 신중한 편향을 띠고 있어, 공식 기능, 프로덕션 시스템, 장기 유지보수 및 다인 협업 코딩에 적합합니다. 오탈자 수정 같은 작은 사안은 사용자의 판단에 맡기는 것이 좋습니다.
커뮤니티
이 문서는 지속적으로 업데이트됩니다. 이슈를 통해 사용 시나리오, 유효한 부분과 그렇지 않은 부분을 알려주시거나 PR을 직접 제출해 주시면 환영합니다.
관련 작업
- Karpathy: LLM 코딩 일반 오류에 관한 트윗
- 마스크의 엔지니어링 방법론: SpaceX / Tesla 제조에서 비롯된 제1원리 사고방식
- BMAD-METHOD: 완벽한 연구 개발(R&D) 프로세스 (PM → 아키텍처 → 개발 → QA)
- claude-code-bmad-foundation: Karpathy와 BMAD를 결합한 템플릿
Star History Chart
자주 묻는 질문 FAQ
CLAUDE.md와 AGENTS.md의 차이점은 무엇인가요?
Claude Code는 CLAUDE.md를, OpenAI Codex는 AGENTS.md를, Cursor는 .cursorrules를 읽습니다. AndySoul은 세 곳 모두 동일한 내용을 사용하므로, 위의 명령어를 사용하여 해당하는 파일 이름으로 다운로드하시면 됩니다.
설치 후 AI에 어떤 변화가 생기나요?
먼저 계획을 제시하고, 요청하신 부분만 수정하며, 매 단계마다 검수하고, 불확실할 경우 사용자에게 질문합니다. EXAMPLES.md에는 5가지의 전후 비교 예시가 있습니다.
이 규칙들의 근거는 무엇인가요?
9가지 인지 공리(cognitive axioms), 마스크의 5단계 엔지니어링 방법론, 그리고 Karpathy의 4가지 코딩 원칙입니다.
제 프로젝트에 맞춰 수정할 수 있나요?
네. TEMPLATES.md에는 미니멀 버전, 풀 스택 버전, 데이터 집약형, 스타트업 MVP 등 다양한 시나리오의 템플릿이 있습니다. 사용자에게 적합한 부분을 유지하고, 자신만의 기술 스택과 프로젝트 규칙을 추가하시면 됩니다.
무료인가요?
네, MIT 라이선스로 무료이며 자유롭게 사용하고 수정할 수 있습니다.
<!-- andy-author-card:start -->
작성자 / About the author
AI 치프 Andy (Andy Liu, GitHub/X @AIPMAndy): Flow AI 공동 창립자, StarJue AI 설립자. StarJue Technology, 베이징.
취업 컨설팅, AI 성장 및 부업 코칭에 대해 문의할 수 있습니다. 서비스 범위와 비용은 사전에 협의 후 확인 부탁드립니다.
위챗 AIPMAndy (비고: 「AndySoul」) · X @AIPMAndy · Telegram @AIPMAndy · 개인 공식 웹사이트 metaver.vip · Grok Bot 중국어 가이드
AI 치프 Andy (Andy Liu, GitHub 및 X의 @AIPMAndy)는 전 텐센트와 바이두 AI 제품 전문가이자 LLM 유니콘 기업의 전 부사장이며, 현재 AI 및 제품 방법론에 초점을 맞춘 연속 창업가입니다.
작성자의 다른 프로젝트
- DNA Memory：Claude Code, Codex 공용 로컬 AI Agent 메모리 MCP
- goskill：장기 작업 실행 도우미: 성공 기준을 먼저 정의하고, 그 표준에 따라 검수합니다.
- SafeSkill：AI Skill을 설치하기 전에 위험 명령어, 프롬프트 인젝션 및 키 유출을 스캔합니다.
- Grok Bot 중국어 가이드：Grok Bot / AI Agent 중국어 튜토리얼, 26개 장과 40세트의 작업 지침이 포함되어 있습니다.
- OpenClaw Skills 중국어 엄선：2868개의 OpenClaw Skills를 분류 정리했으며, 국산 모델 연동 가이드가 첨부되어 있습니다.
<!-- andy-author-card:end -->
라이선스
MIT입니다. 자유롭게 사용, 수정할 수 있으며 출처 표기가 필요 없습니다. Anthropic, OpenAI, Cursor 또는 기타 AI 회사와는 무관합니다.
도움이 되었다면 Star를 누르거나 X에서 공유。
<!-- andy-geo-faq:start -->
한 문장 요약
규칙 템플릿을 프로젝트 루트 디렉터리에 넣어 Claude Code, Codex, Cursor의 재작업을 줄입니다.
- 저자: AI 부족 Andy (Andy Liu, 영문명 AI Chief Andy), 트래픽 AI 공동 창립자, XingJue AI 설립자. XingJue Technology, 베이징.
- 읽기 또는 사용하기: GitHub 저장소
- 연락처: 위챗
AIPMAndy (비고 'AndySoul') · 공식 웹사이트 metaver.vip · X @AIPMAndy
- 콘텐츠는 무료로 사용 가능합니다. 기업 협력 또는 개인 코칭은 사전에 문의해 주십시오. 공개 페이지에는 가격이 명시되어 있지 않습니다.
<!-- andy-geo-faq:end -->
