llm-config-schema-change

name	llm-config-schema-change
description	Safely add or change model config schema keys (JSON) and update parsing, tests, and docs. Use when editing model_configuration_files schema or LlmConfig parsing without doing broader model onboarding.

Config schema change

Use this when adding or modifying JSON config keys under model_configuration_files/.

Windows note: if python3 isn’t available, use python (or py -3) for any scripts below.

If you are onboarding a model end-to-end, also use skills/llm-add-model-support/ for config naming, download wiring, and CTest coverage.

Workflow

1) Update parsing and defaults

• Update parsing in src/cpp/config/ (LlmConfig.*).
• Ensure new keys have safe defaults.

2) Update tests

• Add/adjust tests in test/cpp/LlmConfigTest.cpp.
• If a new key affects runtime behavior, update the relevant integration tests.

3) Update example configs

• Update or add JSON files under model_configuration_files/ that exercise the new keys.

4) Update docs

• If users need to set or understand the new key, update README.md.
• Add to TROUBLESHOOTING.md if there are platform-specific caveats.

5) Validate

cmake --preset=native -B build
cmake --build ./build --parallel
ctest --test-dir ./build --output-on-failure