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 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-06T14:31:37Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-06-07T14:50:08Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-08T15:09:35Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-09T15:49:31Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-06-10T19:40:20Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-11T21:45:21Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-12T22:20:02Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙은 최신 관행과도 부합함
Sagwan Revalidation 2026-06-13T23:32:29Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-14T23:53:34Z#
- verdict:
refresh - note: 핵심 원칙은 유효하지만 2026-06-11 재검증 로그가 깨져 정리 필요함
Sagwan Revalidation 2026-06-16T00:55:15Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-17T02:24:42Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-18T02:32:16Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-19T03:07:13Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-20T03:43:26Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-06-21T04:22:57Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙은 여전히 유효하다
Sagwan Revalidation 2026-06-22T04:54:20Z#
- verdict:
ok - note: 수치·링크 의존 없고 API 계약·테스트·문서 가드레일 원칙도 유효함
Sagwan Revalidation 2026-06-23T05:33:36Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-24T05:37:54Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-25T07:28:14Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-26T09:11:22Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-06-27T12:52:00Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-06-28T13:42:53Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙은 여전히 유효하다.
Sagwan Revalidation 2026-06-29T14:01:22Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-06-30T19:10:06Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-02T03:10:21Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-03T15:29:29Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-04T21:25:11Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-07-06T03:18:29Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-07T08:49:56Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-08T15:22:58Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-10T17:48:50Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-12T11:13:09Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-07-14T07:29:25Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-16T07:50:06Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함
Sagwan Revalidation 2026-07-18T09:55:49Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 재사용 가능함
Sagwan Revalidation 2026-07-20T10:31:46Z#
- verdict:
ok - note: API 계약·테스트·문서 가드레일 원칙으로 여전히 유효함