/gaia-config-rubric

What it does

/gaia-config-rubric edits the rubrics section of .gaia/config/project-config.yaml. The rubrics section configures the layered rubric loader -- typically the path overrides for project-level rubric files. This section does not manage individual rubric files. The editor preserves all YAML comments and formatting outside the edited section. Every edit goes through a diff preview and confirmation gate before writing.

When to use it

• You need to add, remove, or modify entries in the rubrics configuration section.
• You set up a new project and need to configure the rubrics section.

Prerequisites

• project-config.yaml must exist. Run /gaia-init to create one if missing.

How to invoke

/gaia-config-rubric

What it does step by step

1. Locate project-config.yaml Resolves the configuration file path.
2. Extract the rubrics section Reads the current rubrics block. If the section is missing, offers to scaffold a default.
3. Present edit menu Shows the current rubrics configuration and an operation menu (add, remove, edit, view, exit).
4. Apply operation Collects the new values and validates them. Key/value pairs for rubric path overrides.
5. Diff preview and confirmation Shows a unified diff of what will change. You must confirm before anything is written.
6. Write back Writes only the modified section, preserving all other content byte-for-byte.
7. Suggest validation Recommends running /gaia-config-validate to confirm the file still passes schema validation.

Inputs

Outputs

Example session

> /gaia-config-rubric

Current rubrics configuration:
  project_root: rubrics/project

Operations: [s] set key  [r] remove key  [v] view  [x] exit
> s

Key: rubric_paths.code_review
Value: rubrics/base/code-review.json

Diff preview:
  rubrics:
    project_root: rubrics/project
  + rubric_paths:
  +   code_review: rubrics/base/code-review.json

Apply this edit? [y/n]
> y

Rubrics section updated.
Run /gaia-config-validate to verify schema compliance.
Run /gaia-config-validate --rubric to verify the merged rubric output.

Adding a per-skill rubric override

> /gaia-config-rubric

Operations: [s] set key  [r] remove key  [v] view  [x] exit
> s

Key: overrides.security_review
Value: rubrics/project/strict-security.json

Diff preview:
  rubrics:
    project_root: rubrics/project
    rubric_paths:
      code_review: rubrics/base/code-review.json
  + overrides:
  +   security_review: rubrics/project/strict-security.json

Apply this edit? [y/n]
> y

Rubrics section updated.

What to run next

• /gaia-config-validate -- validate the modified configuration file.
• /gaia-config-show rubrics -- view the section after editing.

Troubleshooting

rubrics section not found

The section does not exist in your config file. The command offers to scaffold a default:

rubrics:
  project_root: rubrics/project

Edit cancelled

You chose not to apply the edit. The file remains unchanged.

Related commands