사용자가 회고를 요청했습니다. 향후 실행을 개선하기 위해 코딩 에이전트의 환경에 대한 개선 사항을 제안합니다.
단계
-
writing-for-agents스킬 도구를 호출하여 작성 스타일 가이드를 참조하세요. -
사용자가 지정한 세션의 기본 소스를 읽습니다. 이는 이 머신에서 세션 로그를 검색하는 것을 의미할 수 있습니다. 사용자가 세션을 지정하지 않으면 현재 세션을 기본값으로 사용합니다.
-
다음 범주에서 개선 후보를 찾습니다.
- 탐색: 에이전트가 올바른 파일을 찾는 것이 얼마나 쉬웠나요? 파일 간에 숨겨진 종속성이 있나요? 탐색 포인터가 더 쉽게 만들어 줄 수 있나요? 세션이 정보를 찾는 데 오랜 시간이 걸렸을 때 사용합니다.
- 자동화된 검사: 에이전트가 저지른 오류를 잡을 수 있는 자동화된 검사가 있나요? 린팅, 타입 검사, 테스트, 파일시스템 린터? 먼저 리포지토리의 자체 검사 명령(
package.json/빌드 도구lint/check스크립트, CI 워크플로우)을 읽어서, 이미 존재하지만 연결되지 않았거나 조용히 깨진 검사가 발견 사항이지 재발명이 아닙니다. 가드레일(pre-commit 훅과 CI 작업에서 린트/타입 검사/테스트 명령을 실행하는 것)이 없는 리포지토리 자체가 발견 사항입니다: 린트되지 않은 리포지토리는 놓친 기회이지 중립적인 기본값이 아닙니다. 에이전트가 자동화된 검사가 잡을 수 있었던 실수를 했거나, 리포지토리에 가드레일이 전혀 없을 때 사용합니다. - 코딩 표준: 리뷰어 에이전트에게 새로운 규칙을 부여해야 하나요? 기존 규칙을 제거하거나 명확히 해야 하나요? 먼저 위반을 분류하세요: 기계적 위반(고정된 구문 패턴, 금지된 API, 임포트 형태, 파일 위치 규칙)은 결정론적 검사로 처리합니다. 리포지토리의 언어와 기존 가드레일을 고려하여 가장 저렴한 방법(리포지토리 자체 린터의 사용자 지정 규칙, 새로운 pre-commit 훅, 새로운 CI 작업)을 선택합니다. 기본값은 규칙을 작성하는 것보다 검사를 구축하는 것입니다.
CODING_STANDARDS.md는 진정한 판단 호출(파일 간 일관성, "주변 스타일과 일치", 어떤 가드레일도 대체할 수 없는 모든 것)을 위해 남겨둡니다. 리뷰어 에이전트가 실수를 잡지 못했을 때 사용합니다. - 전역 AGENTS.md: 대신 코딩 표준(또는 자동화된 검사)으로 옮겨야 할 지침 명령이 있나요? 리포지토리 또는 사용자의 전역 범위에서 AGENTS.md 파일이 특히 클 때 사용합니다.
- 도구 경제성: 에이전트가 간소화할 수 있는 비용이 많이 드는 도구 호출을 했나요? 특히 토큰 비효율적인 사용자 지정 도구(CLI, MCP)가 있나요? 에이전트가 비용이 많이 드는 도구 호출을 했을 때 사용합니다.
- 무효 명령: 에이전트의 행동을 수정하지 않는 지침 파일의 명령을 찾습니다. 지침 파일이 크고 다루기 어려울 때 사용합니다.
- 정보 접근: 에이전트의 정보 접근성을 높일 기회를 찾습니다. 개발 서버 로그 기록, 타사 서비스에 대한 읽기 전용 접근 등. 중요한 정보를 에이전트가 사용할 수 없었을 때 사용합니다.
- 이러한 후보를 심각도 순서로 사용자에게 제시합니다.
참고
구현 대 검토
모든 작업은 구현과 검토의 두 단계를 거칩니다. 구현 에이전트가 가장 많은 컨텍스트 압박을 받습니다. 탐색, 코드 작성, 디버깅을 담당합니다.
검토 에이전트는 컨텍스트 압박이 가장 적습니다. diff를 받기 때문에 탐색이 필요 없습니다. 종종 코드를 작성하거나 디버깅할 필요가 없습니다.
이는 검토 에이전트가 코딩 표준을 적용해야 하며, 구현 에이전트가 그렇게 해서는 안 된다는 것을 의미합니다.
파일
리포지토리에서 여러 파일에 접근할 수 있습니다:
CLAUDE.md/AGENTS.md: 이 파일들은 이 리포지토리에서 작업하는 모든 에이전트의 컨텍스트 창에 푸시됩니다. 매우 드물게, 보통 다른 파일에 대한 탐색 포인터로만 사용해야 합니다.CODING_STANDARDS.md: 이 파일은 구현 중이 아닌 검토 중에 읽습니다. 표준 파일이 1,000줄을 초과하면 문서 폴더에 탐색 포인터를 추가합니다.- 문서: 다른 파일이 가리키는 참조 파일로 문서를 사용합니다. 새 문서를 작성하기 전에 기존 문서를 찾습니다.
- 스킬: 설명이 에이전트의 컨텍스트 창에 들어가므로 문서용으로 스킬을 사용하거나 사용자가 호출하는 명령에 사용합니다.
writing-for-agents스킬의 조언을 따릅니다.