AI 에이전트 개발 문서를 관리하는 방법 가이드
이 가이드는 AI 에이전트를 위한 문서를 코드와 함께 레포 안에서 버전 관리하고, 유효 기간과 적용 범위에 따라 계층으로 나누라고 권한다. 에이전트는 세션마다 기억이 초기화되므로 레포에 명시된 내용만 사실로 다루도록 설계해야 한다. 상시 규칙은 CLAUDE.md에 짧게 적고 상세 내용은 docs 폴더에 두어 필요할 때만 읽게 한다. 요구사항이 바뀌면 코드보다 스펙 문서를 먼저 수정하고, 기술 결정은 ADR로 기록해 추가만 하는 방식을 따른다. 반복되는 실수는 문서 한 줄보다 테스트, 린트 규칙, Hook 같은 기계적 장치로 막는 것이 권장된다.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)
Log in to join the discussion and vote.
Log in