fix: use scalar Claude agent tools (#2583)

Normalize scalar Claude agent tool metadata across validators, adapters, dashboards, and generated surfaces with regression coverage.
This commit is contained in:
Affaan Mustafa 2026-07-26 03:20:15 -07:00 committed by GitHub
parent f3afd59045
commit 6a9f075cd9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
79 changed files with 515 additions and 87 deletions

View file

@ -55,6 +55,21 @@ This applies consistently across all component path fields.
---
## Agent `tools` Frontmatter: USE A SCALAR
The array rule above applies to `plugin.json`, not agent Markdown frontmatter.
Claude Code agent files use a comma-separated scalar for their tool allowlist:
```yaml
tools: Read, Glob, Grep
```
Do not use a YAML sequence such as `tools: [Read, Glob, Grep]`. Omitting the
`tools` field grants the agent access to all tools, but ECC agents declare
explicit allowlists and the repository validator requires the field.
---
## The `agents` Field: DO NOT ADD
> WARNING: **CRITICAL:** Do NOT add an `"agents"` field to `plugin.json`. The Claude Code plugin validator rejects it entirely.