diff --git a/CLAUDE.md b/CLAUDE.md
index cc061d70..d880330d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -7,7 +7,7 @@ Assess repositories against evidence-based attributes for AI-assisted developmen
 | Item | Value |
 |------|-------|
 | **Python** | >=3.12 |
-| **Entry Point** | `agentready.cli.main:cli` |
+| **Entry Point** | `agentready.cli.main:cli` (or `python -m agentready`) |
 | **Self-Score** | 80.0/100 (Gold) |
 | **Test Coverage** | 37% (target: >80%) |
 
@@ -24,6 +24,9 @@ pytest                             # Run tests
 pytest --cov=src/agentready        # With coverage
 black . && isort . && ruff check . # Lint
 
+# Local development (uses this checkout, not the installed package)
+PYTHONPATH=src python -m agentready assess <repo>
+
 # Benchmarks (requires: uv tool install harbor)
 agentready harbor compare -t task1 -t task2
 ```
diff --git a/src/agentready/__main__.py b/src/agentready/__main__.py
new file mode 100644
index 00000000..d827b255
--- /dev/null
+++ b/src/agentready/__main__.py
@@ -0,0 +1,3 @@
+from agentready.cli.main import cli
+
+cli()