Follow-up from PR #1104 (merged). The tightened AGENTS.md CLI flag checklist and "Finding Source Owners" section direct agents to search src/commands and src/cli/parser for supportedFlags / allowedFlags. That misses schema-only CLI commands whose flags live elsewhere.
Problem
Commands such as cdp, auth, connect, proxy, react-devtools, and web declare flags in src/utils/cli-command-overrides.ts (SCHEMA_ONLY_CLI_COMMAND_SCHEMAS), not in command family metadata. Agents following the new guide will miss flag owners when adding or reviewing CLI surface for these commands.
AGENTS.md also states command schema metadata is "derived from command metadata and command family declarations" — incomplete without the schema-only merge in cli-command-overrides.ts.
Suggested fix
- In the "Adding a New CLI Flag" checklist (step 1) and "Finding Source Owners", add an explicit exception: for schema-only CLI commands, also check
src/utils/cli-command-overrides.ts (SCHEMA_ONLY_CLI_COMMAND_SCHEMAS).
- Amend the schema-metadata sentence to mention the schema-only merge path.
Acceptance
- AGENTS.md accurately routes agents to schema-only flag owners.
- No behavior change — docs only.
Context
Follow-up from PR #1104 (merged). The tightened AGENTS.md CLI flag checklist and "Finding Source Owners" section direct agents to search
src/commandsandsrc/cli/parserforsupportedFlags/allowedFlags. That misses schema-only CLI commands whose flags live elsewhere.Problem
Commands such as
cdp,auth,connect,proxy,react-devtools, andwebdeclare flags insrc/utils/cli-command-overrides.ts(SCHEMA_ONLY_CLI_COMMAND_SCHEMAS), not in command family metadata. Agents following the new guide will miss flag owners when adding or reviewing CLI surface for these commands.AGENTS.md also states command schema metadata is "derived from command metadata and command family declarations" — incomplete without the schema-only merge in
cli-command-overrides.ts.Suggested fix
src/utils/cli-command-overrides.ts(SCHEMA_ONLY_CLI_COMMAND_SCHEMAS).Acceptance
Context