Skip to content

docs: AGENTS.md should cover schema-only CLI command flag owners #1119

Description

@cursor

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

  1. 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).
  2. 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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions