/gaia-config-platform

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

What it does

/gaia-config-platform edits the platforms section of .gaia/config/project-config.yaml. The platforms section is a flat list of platform identifiers (ios, android, web). Mobile gates, rubric layer selection, and device-target requirements trigger based on this list. 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 platforms configuration section.
  • You set up a new project and need to configure the platforms section.

Prerequisites

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

How to invoke

/gaia-config-platform

What it does step by step

  1. Locate project-config.yaml Resolves the configuration file path.
  2. Extract the platforms section Reads the current platforms block. If the section is missing, offers to scaffold a default.
  3. Present edit menu Shows the current platforms configuration and an operation menu (add, remove, edit, view, exit).
  4. Apply operation Collects the new values and validates them. Platform identifiers must be kebab-case. Unknown identifiers are accepted with a warning.
  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 platforms section.

Outputs

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

Example session

> /gaia-config-platform

Current platforms configuration:
  - web

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

Key: platforms
Value: [web, ios, android]

Diff preview:
  - platforms:
  -   - web
  + platforms:
  +   - web
  +   - ios
  +   - android

Apply this edit? [y/n]
> y

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

What to run next

Troubleshooting

platforms section not found

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

platforms:
  - web

Edit cancelled

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