/gaia-config-validate

user-facing
Category:
Configuration
Lifecycle phase:
4 -- Implementation
Arguments:
[config-file] [--rubric] [--skill name]

What it does

/gaia-config-validate validates your .gaia/config/project-config.yaml against the configuration schema and reports any violations with their JSONPath locations. Pass --rubric to instead validate the merged rubric output for your project. This is a read-only command -- it reports issues but does not modify any files.

When to use it

  • You edited the configuration and want to confirm it is still valid.
  • A command reported unexpected behavior and you suspect a configuration issue.
  • You want to validate the merged rubric output to ensure all review criteria are correctly layered.

Prerequisites

  • project-config.yaml must exist (or provide a path to the file to validate).

How to invoke

/gaia-config-validate
/gaia-config-validate --rubric
/gaia-config-validate --rubric --skill code

What it does step by step

  1. Detect mode Routes to project-config validation (default) or rubric validation (--rubric).
  2. Run validation For project-config: validates against the JSON Schema. For rubrics: validates the merged rubric output for each review skill.
  3. Report results On PASS: a single confirmation line. On FAIL: lists each violation with its JSONPath location.

Inputs

InputSourceDescription
config-fileCommand argument (optional)Path to the config file. Defaults to .gaia/config/project-config.yaml.
--rubricFlag (optional)Validate merged rubric output instead of project-config.
--skillFlag (optional)With --rubric, validate only a specific skill's merged rubric.

Outputs

OutputLocationDescription
Validation verdictConsole outputPASS or FAIL with violation details.

Example session

> /gaia-config-validate

PASS: .gaia/config/project-config.yaml

> /gaia-config-validate --rubric

Validating merged rubrics...
  code: PASS
  qa: PASS
  test: PASS
  security: FAIL (1 violation)
  perf: PASS
  a11y: PASS

FAIL: 1 skill(s) failed rubric validation.

What to run next

  • Fix any violations and re-run the validation.

Troubleshooting

Credential detected in config

The schema rejects literal credentials (patterns like sk-, ghp_, AKIA). Replace them with environment variable name references.

File not found

No configuration file exists at the expected path. Run /gaia-init to create one.