Clarify why cortex/snow CLIs and Snowflake connection are optional warnings in test coverage table

Author: iamontheinet

AGENTS.md

@@ -58,13 +58,13 @@ bash tests/run-tests.sh           # Mac/Linux
 
 | Section | Checks | What it validates |
 |---------|--------|-------------------|
-| CLIs | 5 | python3, git required; cortex, snow optional (warn) |
+| CLIs | 5 | python3, git required; cortex, snow optional (warn — unit tests are pure Python and never invoke these CLIs, so contributors and CI can run the full suite without them installed) |
 | Plugin structure | 7 | plugin.json, 3 skill dirs, 9 router scripts, test files |
 | Content sanity | 8 | Valid JSON, `decide()` defined, `--permission-prompt-tool` usage, session_state functions |
 | Unit tests | 75 | `test_envelope_policy.py` (33): RO/RW/RESEARCH/DEPLOY envelope allow/deny decisions. `test_plugin_units.py` (42): session state CRUD, credential path blocking, envelope prompt building |
-| Snowflake connection | 1 | connections.toml or env vars exist (warn) |
+| Snowflake connection | 1 | connections.toml or env vars exist (warn — only needed for live integration, not for unit tests) |
 
-Tests exit non-zero on any FAIL. Missing CLIs and missing Snowflake config are non-blocking warnings.
+Tests exit non-zero on any FAIL. Warnings (marked "warn") are informational only — they flag missing tools that aren't needed for the core test suite.
 
 ## Installers