Title93/100
Search Atlas Nodes, Decisions, and Terms
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Find Atlas entries by topic when you hold no id; an id you already hold can be read directly. Searches Nodes (patterns, concepts, examples) and Roadmap entries (announced, unpublished); kind narrows it to one Node kind, Decisions, or glossary terms. Ids, titles, Hooks (one-line summaries), and claims decide candidacy, Section text only when no subject matches those; order is identity score, then Section score, then how many words matched, then the publisher's order. Returns ranked ids with Hooks (a term's is its whole definition), paged with a cursor. A miss is an empty page; invalid arguments are refused as invalid_argument.
The description explains the capability, when to use it, and what to expect.
Inputs92/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
A topic or question in ordinary design vocabulary. Words match whole words (four or more characters also match longer words they begin; stopwords drop) in canonical ids, titles, Hooks, and claims, then Section headings and bodies; rarer words weigh more. Section text makes a candidate only when no subject matches elsewhere, so total counts the candidates. kind='decision' searches Decision ids, titles, and bodies; kind='term', keys and definitions. Empty lists every subject of the kind.
Clear enough to supply this argument.
kind
Narrows the search to one Node kind, to Decision records, or to glossary terms. Omit it to search every Node kind plus Roadmap entries (announced, unpublished); setting it leaves Roadmap entries out.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
status
Maturity filter. Published Nodes are 'fleshed' or 'stable'; Roadmap entries may be any rung. Refused with kind 'decision' or 'term'.
Clear enough to supply this argument.
bound
How many ranked candidates this call returns; raise it to compare more matches at once, and continue past it with cursor.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
scope.next_cursor from a prior atlas_orient page; repeat the same other arguments.
Clear enough to supply this argument.
expected_revision
Pins this call to the Release (published edition) a prior payload named in 'coherence'; refused as 'revision_changed' if the active Release has changed. Omit for the active Release.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search Atlas Nodes, Decisions, and Terms",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema66/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"required": [
"projection",
"coherence",
"payload_class",
"scope",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "candidates, ranked. A Node candidate has id, status, hook, and disclosure ('full', or 'roadmap' with its title); a Decision or term candidate has id, which is its atlas_read address, and hook."
},
"scope": {
"type": "object"
},
"coherence": {
"type": "string"
},
"projection": {
"const": "agent-projection/v6"
},
"payload_class": {
"enum": [
"orient"
],
"type": "string"
}
}
}