Files

koseokmin cb29b192b4 docs를 저장소로 되돌리고 계약 예제를 복원한다

5cfb8a1이 .gitignore에 docs/를 넣고 68개 파일을 지웠다. 그런데
AgentBuilderContractExampleTest, ToolBundleContractExampleTest,
ArchitectureDocumentContractTest는 docs/ 아래 계약 예제와 architecture
문서를 입력으로 직접 읽는다. 그 결과 clean clone에서 테스트 10건이
입력을 찾지 못해 실패했다.

제외 범위를 원래 의도대로 좁힌다. 에이전트 산출물(AGENTS.md, .agents/,
.codex/, docs/superpowers/)은 계속 제외하고 저장소 문서는 추적한다.

문서는 삭제 직전 상태(3de052a)를 기준으로 복원하고, 그 위에 main 코드와
대조해 어긋난 부분을 고쳤다.

- ADR-0007을 Superseded로 바꾸고 ADR-0013을 새로 쓴다. route당 Tool
  Service N개가 최종안이며, PortalToolRegistryClient가 이미 route별로
  N개를 유지하고 있는데 ADR-0007은 "bundles는 항상 한 항목"을 Accepted
  상태로 주장하고 있었다. ADR-0009 결정 4도 부분 대체한다.
- ADR-0008 파일 헤더가 Accepted였으나 ADR-0009가 이미 대체한 상태였다.
- 6078852의 endpoint 소유권 반전이 반영되지 않은 서술을 계약 v0.2,
  bundle 설정 예제, Tool 적재 안내에서 고친다.
- Portal registry 계약 v0.1과 route key 규약을 새로 문서화한다. 둘 다
  구현은 있는데 계약 문서가 없었다.
- MCP SDK 2.0.0 SBOM을 추가한다.

번호 주석: ADR-0011과 0012는 feature/mcp-integration이 Tool inputSchema
정책에 쓰고 있어 비워 둔다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-22 23:27:56 +09:00

1.4 KiB

Raw Blame History

ADR-0005 표준 MCP Tool name을 실행 식별자로 사용

상태: Accepted
결정일: 2026-07-30
대체 대상: ADR-0003

배경

Tool의 원천 정보는 각 Tool Service가 소유하고 MCP Server가 매니페스트를 pull한다. Agent Builder의 UID는 Agent Builder 내부 관리 개념이므로 MCP와 Tool Service 사이의 계약으로 전파하면 표준 tools/list와 tools/call 외에 별도 식별자 동기화가 필요해진다.

결정

tools/list가 노출하고 tools/call.params.name이 전달하는 표준 MCP Tool name을 실행 식별자로 사용한다.
Tool Service가 전체 MCP 범위에서 고유한 namespaced name을 직접 선언한다.
허용 형식은 MCP 표준에 맞춘 1~64자의 영문·숫자와 _, -, ., /다.
MCP Server는 이름을 재작성하지 않고 형식, bundle의 namePrefix, 전체 중복을 검증한다.
Agent Builder 내부 UID는 Agent Builder가 자체 관리하며 MCP metadata와 실행 요청에 요구하지 않는다.

결과

표준 MCP 계약만으로 목록과 실행 대상을 연결한다.
Tool 이름 변경은 식별자 변경이므로 Tool Service와 Agent Builder의 rolling 호환 기간이 필요하다.
이름 충돌이나 전체 Tool 수 상한 초과 시 일부 목록을 노출하지 않고 기존 정상 snapshot을 유지한다.

1.4 KiB Raw Blame History

ADR-0005 표준 MCP Tool name을 실행 식별자로 사용

배경

결정

결과

1.4 KiB

Raw Blame History