coral-review-source-spec

To review a YAML manifest for quality, run an automated source spec review that evaluates product fit, YAML correctness, and query ergonomics. This process inspects auth and input modeling, pagination, and HTTP semantics to ensure your manifest meets consistency standards.

A Coral source spec is a YAML manifest defining how data sources connect and behave. You need to review it when a pull request adds or modifies source directories under sources/core or sources/community to prevent poorly documented sources from reaching users.

To check auth and input correctness in your source manifest, review the secret versus variable handling directly in the YAML configuration. A source spec review validates this modeling against established conventions to ensure safe and consistent authentication.

Yes, you can use a source spec review for pull requests that modify community source directories. It evaluates the updated manifest.yaml against product standards, naming patterns, and table design to produce prioritized findings with specific file and line references.

The best way to validate query ergonomics and pagination is to run a source spec review that compares your proposed source patterns against existing sources. It enforces HTTP semantics and query design guidance to ensure the data source is useful to agents.

Your source spec may pass CI but fail quality standards because CI only checks syntax, while source spec review evaluates whether the source is understandable, safe, and useful to users. It enforces documentation quality, naming consistency, and query ergonomics beyond basic validation.