agentic-principles

"AI는 부조종사, 주인공은 당신입니다" AI 에이전트는 개발자의 생각을 증폭시키고 반복 작업을 대신하지만, 최종 결정권과 책임은 항상 개발자에게 있습니다. AI는 크고 모호한 작업보다 작고 명확한 지시 에 훨씬 더 좋은 성능을 발휘합니다. 컨텍스트(AI의 작업 기억)는 항상 신선하고 압축된 상태 로 유지해야 합니다. 대화가 길어지면 상태를 문서화: 상황에 따라 적절한 추상화 수준을 선택합니다. 분석만 하고 수정하지 않음 사용 시점: 사용 시점: 테스트 코드 작성 시각적 검토 Draft PR 생성 자기 검증 요청 - AI 에이전트 세션 시작 시 기본 원칙 확인 - 복잡한 작업 시작 전 접근 방식 결정 - 컨텍스트 관리 전략 수립 - 생산성 향상을 위한 워크플로우 점검 - 팀원에게 AI 에이전트 사용법 온보딩 - 오래되고 관련 없는 정보는 AI 성능을 저하시킴 - 컨텍스트 드리프트: 여러 주제 혼합 시 성능 39% 저하 - Claude: /context , /clear - Gemini: 새 세션 시작 - ChatGPT: 새 채팅 시작 - 활성 도구/플러그인: 최소화 유지 - 대화 길이: 너무 길어지면 HANDOFF.md 생성 후 새 세션 - 처음 해보는 복잡한 작업 - 여러 파일에 걸친 대규모 리팩토링 - 아키텍처 변경 - 데이터베이스 마이그레이션 - 간단하고 명확한 작업 - 실험적인 프로토타입 - 반복적이고 시간이 많이 걸리는 작업 - 반드시 안전한 환경(컨테이너 등)에서 사용 - 계획 모드: 90% (기본값으로 사용) - 실행 모드: 10% (안전한 환경에서만) - 테스트 코드 작성 "이 함수에 대한 테스트를 작성해줘. 엣지 케이스도 포함해야 해." - 시각적 검토 - 변경된 파일들을 diff로 확인 - 원하지 않는 변경 사항 되돌리기 - Draft PR 생성 "draft PR을 만들어줘" - 자기 검증 요청 "방금 생성한 코드를 다시 검토해줘. 모든 주장을 검증하고, 끝에 검증 결과를 표로 정리해줘." - Claude Code Best Practices - ykdojo claude-code-tips - Ado's Advent of Claude