diff --git a/.gitignore b/.gitignore
index bc61e16..8a215d5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -63,7 +63,7 @@ cmake-build-debug/
 __pycache__/
 *.pyc
 
-# Python build artifacts
+# Python package metadata
 *.egg-info/
 dist/
 *.egg
diff --git a/python/stdface/plugin.py b/python/stdface/plugin.py
index 6800117..67d7551 100644
--- a/python/stdface/plugin.py
+++ b/python/stdface/plugin.py
@@ -262,4 +262,7 @@ def _discover_plugins() -> None:
     try:
         import stdface.solvers  # noqa: F401 — triggers auto-registration
     except ImportError:
+        # Solvers package not available (e.g., minimal install, missing
+        # dependencies, or corrupted package). Plugin lookup will fail
+        # with a helpful KeyError listing available plugins.
         pass