정리와 실습

핵심 요점

• 좋은 작업 공간은 AI에게 컨텍스트, 빠른 피드백 루프, 값싼 되돌리기를 준다 — 설정이 곱셈기이며, 종종 모델 자체보다 더 중요하다.
• 컨텍스트 파일(AGENTS.md / CLAUDE.md)은 작성할 수 있는 가장 레버리지 높은 것이다. 구체적인 규칙, 큰 목소리의 금지 사항, 예시에 대한 포인터를 담아라.
• 버전 관리를 반사 신경으로 만들어라 — 작게 커밋하고, 디프를 읽고, 위험한 작업은 브랜치로 — 그러면 AI가 하는 어떤 것도 진정으로 되돌릴 수 없는 것이 아니다.
• 루프를 타이트하게 유지하고 에이전트가 스스로 닫게 하라: 편집, 실행, 실패 읽기, 수정. 진단(LSP, 린트, 타입체크)을 AI에게 되먹여라.
• 모든 유료 API를 하드 상한과 스로틀로 가둬라. 비밀을 저장소 밖에 두고, 하네스를 써서 안전 검사를 AI가 건너뛸 수 없게 만들어라.

해보기

작업 중인 프로젝트를 열거나(또는 빈 프로젝트를 스캐폴딩하고) AGENTS.md 초안을 손으로 작성하라: 프로젝트가 무엇인지, 기술 스택, dev/test/lint 실행 정확한 명령어, 실제 컨벤션 세 가지, 그리고 최소 두 개의 큰 목소리 금지 사항(예: "절대 .env를 읽거나 출력하지 말 것", "먼저 알리지 않고 의존성을 추가하지 말 것"). 그런 다음 AI 도구에게 사소한 변경을 요청하고 파일을 존중하는지 지켜보라. 원하지 않은 일을 할 때마다 한 줄을 추가하거나 다듬어라. 코드만이 아니라 방을 튜닝하는 것이다.

이 장의 프롬프트

Read my project and help me write a concise AGENTS.md context file for it.

First, inspect the repo and tell me:
- the tech stack and versions you detect
- the commands for install / dev / test / lint / build
- the layout and where the entry point is

Then draft an AGENTS.md with these sections: What this is, Tech stack,
Commands, Conventions, and Don'ts. Be specific and concrete (name the
exact libraries and rules, not "follow our conventions"). State the don'ts
as loudly as the do's, and point to one existing file as a style example.
Keep it under ~40 lines — I'll prune from there.