docs: improve agentdocsspec compliance #1024

Job	Run time
plan	26s
build-global-artifacts	0s
host	0s
build-local-artifacts (${{ join(matrix.targets, ', ') }})	0s
announce	-1s
	25s

Provide feedback