diff --git a/AGENTS.md b/AGENTS.md
index 8d23c13..9077c44 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -29,7 +29,7 @@ pyproject.toml           (Dependencies & tool config)
 ## Essential Directives
 
 ### Code Standards
-- **Type Hints:** Required on ALL function signatures and class members. Enforce strictly with mypy.
+- **Type Hints:** Required on ALL function signatures and class members. Enforce strictly with mypy. Avoid using `# type: ignore` comments to suppress mypy errors; fix the underlying type issues instead.
 - **Docstrings:** Google-style format for all public APIs.
 - **Logging:** Use `logging` module only; never `print()`.
 - **Relative Paths:** Never use absolute paths in code.
diff --git a/AGENTS_MANUAL_CHECKS.md b/AGENTS_MANUAL_CHECKS.md
index 10fa462..939d460 100644
--- a/AGENTS_MANUAL_CHECKS.md
+++ b/AGENTS_MANUAL_CHECKS.md
@@ -28,7 +28,7 @@ pyproject.toml           (Dependencies & tool config)
 ## Essential Directives
 
 ### Code Standards
-- **Type Hints:** Required on ALL function signatures and class members. Write code that will pass mypy.
+- **Type Hints:** Required on ALL function signatures and class members. Write code that will pass mypy. Avoid using `# type: ignore` comments to suppress mypy errors; fix the underlying type issues instead.
 - **Docstrings:** Google-style format for all public APIs.
 - **Logging:** Use `logging` module only; never `print()`.
 - **Relative Paths:** Never use absolute paths in code.