/gaia-config-stack

user-facing
Category:
Configuration
Lifecycle phase:
4 -- Implementation

What it does

/gaia-config-stack edits the stacks section of .gaia/config/project-config.yaml. The stacks section defines the technology stacks in your project with their languages and file path patterns. Review skills use this to determine which stack applies to the changed 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 stacks configuration section.
  • You set up a new project and need to configure the stacks section.

Prerequisites

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

How to invoke

/gaia-config-stack

What it does step by step

  1. Locate project-config.yaml Resolves the configuration file path.
  2. Extract the stacks section Reads the current stacks block. If the section is missing, offers to scaffold a default.
  3. Present edit menu Shows the current stacks configuration and an operation menu (add, remove, edit, view, exit).
  4. Apply operation Collects the new values and validates them. Each stack entry requires a name, language, and paths (glob patterns).
  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

InputSourceDescription
Project configuration.gaia/config/project-config.yamlThe file containing the stacks section.

Outputs

OutputLocationDescription
Updated stacks section.gaia/config/project-config.yamlThe modified stacks configuration.

Example session

> /gaia-config-stack

Current stacks configuration:
  api:
    language: typescript
    path: packages/api
    framework: express

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

Key: web.language
Value: typescript

Diff preview:
  stacks:
    api:
      language: typescript
      path: packages/api
      framework: express
  + web:
  +   language: typescript

Apply this edit? [y/n]
> y

Stacks section updated. Run /gaia-config-validate to verify.

What to run next

Troubleshooting

stacks section not found

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

stacks:
  - name: app
    language: typescript
    paths: ["src/**"]

Edit cancelled

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