AGENT.md

Rules

• No backward compatibility: Legacy shims, re-exports, renamed _vars, deprecation wrappers, // removed comments 등 불필요. 사용하지 않는 코드는 즉시 삭제.
• Dead code 제거: 미사용 함수, 클래스, import, 설정 필드, 테스트는 항상 삭제. 미래를 위한 코드를 남기지 않는다.
• 테스트 최신화 및 수행: 코드 변경 후 반드시 관련 테스트를 최신화하고 실행하여 통과를 확인한다. 삭제된 코드의 테스트도 함께 제거.
• 커밋 메시지에 Co-Authored-By 금지: Co-Authored-By: Claude 등 AI attribution 라인을 커밋 메시지에 포함하지 않는다.
• Out of Memory 상황이 발생하지 않도록 유념하며 현재 머신의 Memory 여유를 고려하여 작업을 진행한다. 필요하면 여유 메모리를 주기적으로 확인하며 진행한다.
• Out of Disk 상황이 발생하지 않도록 Disk 용량을 고려하여 작업을 진행한다. 필요하면 여유 Disk 주기적으로 확인하며 진행한다.
• 문제가 풀기 어려울 때 임의적인 가정 금지 해결하기 어렵거나 모호한 부분이 있다면, 사용자와 논의 후 진행한다.
• 왠만하면 코드 작성과 관계된 부분들은 TDD로 진행
• 한번 더 검증된 결과물, 답변 사용자에게 답변 또는 결과물을 전달하기전에 한번 최종적으로 검증하고 답변 또는 결과물은 확정한다.
• 핵심만 간략히 사용자에게 인지부하가 크지 않도록, 핵심들만 간략하게 정리해주고, 테이블을 잘 활용해서 정리한다. 이모티콘은 특별히 유용한 경우가 아니면 자제한다.
• 깔끔한 Repository 구조
  • 생성한 조사결과, 코드, 데이터에 대해 디렉토리 구조를 잘 정의하고 진행한다.
  • root에 있으면 좋은 코드 디렉토리 만들어서 모듈, 패키지, scripts 등 별도 디렉토리로 만들면 좋을 것들을 잘 구분하여 진행한다. (아래 구분에 한정하지 않고 해당 레포에 따라 최적의 구조로 진행한다.)
  • from scracth일 경우는 왠만하면 아래의 구조처럼 진행한다.
    • 예시)
      • 데이터의 경우 "./data/"
      • 조사의 경우 "./research/"
      • 결과물의 경우 "./outputs", "./results"
  • 디렉토리가 너무 복잡해졌다면, 틈틈히 디렉토리를 정리 한다.