Three tools with basic descriptions but significant schema and parameter documentation gaps. search_docs and sync_sources have minimal parameter descriptions (e.g., 'source' lacks detail on valid values). docs_status has no parameters but acceptable description. No output schemas documented. No error handling guidance. Tool names follow verb_noun pattern (search_, sync_, docs_) but descriptions are brief (10-30 chars) and lack context on when/why to use each tool. No parameter type constraints (enums, ranges) visible. No indication of idempotency, destructiveness, or recovery paths.
현재 문서 캐시의 커버리지와 최신화 상태를 반환합니다.
업비트 개발자 문서를 검색합니다.
문서를 수동으로 동기화합니다.
Parameter descriptions are minimal or missing. 'source' parameter in search_docs lacks explanation of valid values ('upbit' is shown as example but not documented as enum). 'force' in sync_sources lacks context on when to use it.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields. search_docs likely returns chunks/documents but structure is not specified. sync_sources and docs_status return status objects but fields are not formally declared.
No error handling guidance. Tools do not indicate what errors are retryable, what user actions are needed, or how to recover. E.g., if sync_sources fails due to network issues, should the agent retry? If search_docs finds no results, should it suggest alternative queries?
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | <=2025-11-25 | v2 |
Tool descriptions are too brief (10-30 chars) to guide LLM selection. '업비트 개발자 문서를 검색합니다' (Korean; ~20 chars) lacks context on when to use search_docs vs docs_status, what query format is expected, or what results look like.
No parameter constraints (enums, ranges, patterns) visible. 'query' in search_docs accepts free-form strings with no guidance on format ('공백으로 구분된 키워드' = space-separated keywords, but not enforced). 'source' should be an enum but is not declared as such.