Operation Matrix #
Use this matrix before releasing changes that affect agent engines, Discord commands, usage accounting, thread agents, or MCP/audit behavior.
Engine Scopes #
| Scope | Kiro | OMP |
|---|---|---|
| New channel | Uses AGENT_ENGINE unless /engine stores an override. | Same; requires AGENT_ENGINE=omp or /engine omp with OMP enabled. |
| Existing channel | Uses stored Session.Engine; empty means runtime default. | Same. Engine switch starts a fresh ACP session and replays recent chat context. |
| New thread | Inherits parent channel engine unless the thread stores an override. | Same. |
| Existing thread | Uses thread override first, then parent channel engine. | Same. |
Command Behavior #
| Command | Channel | Thread | Inactive Kiro | Inactive OMP |
|---|---|---|---|---|
/engine | Shows or switches channel engine. | Shows or switches thread override. | Works if Kiro is enabled. | Works if OMP is enabled. |
/models | Lists channel agent models. | Lists thread agent models. | Falls back to kiro-cli chat --list-models. | Requires an active ACP session because models come from session/new. |
/model <id> | Switches channel model dynamically when possible, otherwise restarts. | Respawns thread agent with the model. | Validates through Kiro CLI fallback. | Validates through the active ACP session. |
/agent | Lists channel agent modes. | Lists thread agent modes. | Requires active session. | Requires active session. |
/agent <id> | Switches channel agent mode. | Switches thread agent mode. | Uses ACP session/set_mode. | Uses ACP session/set_mode. |
/status | Shows engine, agent version, model, queue, context usage. | Same for thread agent. | Shows active Kiro version/model. | Shows active OMP version/model. |
/usage | Aggregates by Discord user and includes credits/USD when present. | Thread turns roll up to parent channel scope. | Credits come from Kiro metering metadata. | USD cost comes from OMP usage_update. |
/audit prompt | Uses a short-lived scoped agent and records usage under the Discord caller. | Same, with thread target metadata. | Uses channel engine. | Uses channel engine. |
Release Checklist #
- Run normal tests, vet, build, docs verification, and
git diff --check. - Run Kiro ACP smoke when Kiro behavior changed.
- Run OMP ACP smoke when OMP behavior changed.
- In Discord, test
/engine,/models,/model,/agent,/status,/usage, and/audit promptin both a parent channel and a thread. - Verify
/doctorreports every enabled engine and does not require disabled engines. - Verify failed
/engineswitches do not leave partial channel or thread sessions.