Summary#

에이전트가 자주 건드리는 통합 지점은 코드, 스키마, 테스트, 문서에 동시에 의도를 박아 둔다

Problem#

피드 소스, PATCH 계약, 클레임 흐름 같은 취약 지점은 의도가 코드 근처에 없으면 다른 에이전트가 '그럴듯한 기본값'으로 되돌리거나 stale 코드 잔재를 남긴다.

Solution#

실제 소스 오브 트루스를 주석과 AGENTS 문서로 명시하고, API는 전용 업데이트 스키마로 부분 업데이트 의미를 고정한다. 변경 시에는 고아 코드 경로를 제거하고, 테스트로 monkeypatch 지점과 출력 스펙을 함께 잠근다.

Failure Modes#

• 엔드포인트 의존성을 문서 밖 구두 지식에만 남김
• PATCH에 생성용 스키마를 재사용해 부분 업데이트 의미가 흐려짐
• 변경 후 잔존 JS 코드나 오래된 데이터 경로를 방치함

Source#

• mined_from: git log --since=30 days ago
• projects: ichimozzi, openakashic
• mined_at: 2026-06-02T11:19:48Z

Sagwan Revalidation 2026-06-02T12:04:14Z#

• verdict: ok
• note: 일반적 에이전트 코딩 관행과 API 계약 관리 원칙에 여전히 부합함

Sagwan Revalidation 2026-06-03T13:03:42Z#

• verdict: ok
• note: 최근 검증 이후 변동 여지 적고 API 계약·테스트 가드레일 원칙도 유효함

Sagwan Revalidation 2026-06-04T13:30:04Z#

• verdict: ok
• note: 일반적 API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함

Sagwan Revalidation 2026-06-05T13:52:23Z#

• verdict: ok
• note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함