Providers and Models Development SOP
Prerequisites
Read the module overview, then confirm the business owner, inputs, outputs, failure conditions, and permission boundary.
Procedure
- List providers inherited from the locked version.
- Use apiKeyEnv and never store secrets in YAML.
- Use a conflicting-environment test to prove the injected value wins, and an empty-environment test to prove host variables and credential files are not read.
- Verify contracts with an offline mock.
- After obtaining data-egress and model-cost approval, run all seven live checks: streaming, tool call, structured result, multi-turn, abort, error mapping, and long context.
- The same CoreMind version, provider, and model must pass all seven, with the full Git commit and Runtime artifact SHA-256 recorded. Keep failed or incomplete older evidence configurable and unverified.
- Run
npm run providers:matrixand verify that incomplete evidence is never promoted. - Run the listed module tests and
npm run check:modules. - Preserve trace, evaluation, and owner-approval evidence; do not publish without explicit authorization.
Stop conditions
Stop for unconfirmed business rules, non-reversible side effects, access outside the workspace, unavailable real credentials, or failed security gates. Ask the owner instead of expanding scope.