gw-config-management
Installation
SKILL.md
gw Configuration Management
Config lives at .gw/config.json (committable) and .gw/config.local.json
(gitignored, personal overrides). All worktrees in a repo share the same config.
MANDATORY: Config-Change Rules
Non-negotiable in any gw-tools repo.
| Situation | Required action |
|---|---|
Adding or renaming a Config field in types.ts |
Add a migration in config-migrations.ts, increment CURRENT_CONFIG_VERSION, update gw-config.schema.json, and update types.ts |
Removing a field from Config |
Same as above — use a migration to delete it; never just remove from code |
| Old field in existing configs must keep working | Write a migration that renames/transforms it. NEVER add backcompat shims in command code |
configVersion in a committed config |
Never edit it manually; gw manages it automatically |
gw-config.schema.json diverges from Config |
Fix immediately — the schema is additionalProperties: false and IDE errors surface in every committed config |