Redesign README for Agent-first onboarding

MAC-README.md

@@ -8,31 +8,24 @@ permissions for the application driving automation.
 
 ## Install from a business project
 
-Obtain the built runtime and Agent Contract wheels from the Integration Lead.
-No AutoGenesis checkout is needed. In an activated virtual environment:
+No AutoGenesis checkout is needed. Create an isolated environment and use the
+machine's configured package index; do not bypass its mirror or trust policy.
+The pinned Runtime installs its exact Agent Contract dependency:
 
 ```bash
-python -m pip install /absolute/wheels/autogenesis_agent_contract-2.0.0-py3-none-any.whl /absolute/wheels/autogenesis_appium_mcp-0.4.0-py3-none-any.whl
-python -c "from importlib.resources import files; from pathlib import Path; Path('appium.json').write_bytes(files('autogenesis_appium_mcp').joinpath('conf/appium_conf.template.json').read_bytes())"
-autogenesis-appium-mcp --platform mac --config /absolute/business/appium.json --project-root /absolute/business
+python -m venv .venv
+.venv/bin/python -m pip install autogenesis-appium-mcp==0.4.0
+.venv/bin/python -c "from importlib.resources import files; from pathlib import Path; Path('appium.json').write_bytes(files('autogenesis_appium_mcp').joinpath('conf/appium_conf.template.json').read_bytes())"
+.venv/bin/autogenesis-appium-mcp --platform mac --config /absolute/business/appium.json --project-root /absolute/business
 ```
 
 The default transport is **stdio**. The default platform is iOS, so pass
 `--platform mac` for Mac2. Initialize and discover tools/prompts/identity without
 Appium or a live application; automation calls create sessions when requested.
 stdout is reserved for MCP; diagnostics use stderr.
 
-With uvx and local artifacts:
-
-```bash
-uvx --from /absolute/wheels/autogenesis_appium_mcp-0.4.0-py3-none-any.whl --with /absolute/wheels/autogenesis_agent_contract-2.0.0-py3-none-any.whl autogenesis-appium-mcp --platform mac --config /absolute/business/appium.json --project-root /absolute/business
-```
-
-Once both packages are published to the configured index:
-
-```bash
-uvx --from autogenesis-appium-mcp==0.4.0 autogenesis-appium-mcp --platform mac --config /absolute/business/appium.json --project-root /absolute/business
-```
+Maintainers testing unpublished builds may substitute reviewed local Runtime and
+Contract wheels instead of package-index coordinates.
 
 Agent Contract is pinned to **2.0.0**, manifest SHA-256
 `4367a2e388d0d5cb41a415b25b6a58e25025f1da6749bfdffe87a37c60a0c9d3`.

MOBILE-README.md

@@ -7,11 +7,12 @@ visual verification, and BDD generation. Python 3.10 or later is required.
 
 ## Install in a business project
 
-No AutoGenesis checkout is needed. Until packages are published, obtain both
-built wheels from the Integration Lead. In an activated Python virtual environment:
+No AutoGenesis checkout is needed. In an isolated Python environment, use the
+machine's configured package index; do not bypass its mirror or trust policy.
+The pinned Runtime installs its exact Agent Contract dependency:
 
 ```bash
-python -m pip install /absolute/wheels/autogenesis_agent_contract-2.0.0-py3-none-any.whl /absolute/wheels/autogenesis_appium_mcp-0.4.0-py3-none-any.whl
+python -m pip install autogenesis-appium-mcp==0.4.0
 python -c "from importlib.resources import files; from pathlib import Path; Path('appium.json').write_bytes(files('autogenesis_appium_mcp').joinpath('conf/appium_conf.template.json').read_bytes())"
 autogenesis-appium-mcp --platform android --config /absolute/business/appium.json --project-root /absolute/business
 ```
@@ -21,17 +22,8 @@ Use `--platform ios` for iOS. The default platform is iOS and transport is
 device; automation tools create sessions when requested. stdout belongs to the
 MCP client; diagnostics use stderr.
 
-With uv/uvx, launch directly from the same local artifacts:
-
-```bash
-uvx --from /absolute/wheels/autogenesis_appium_mcp-0.4.0-py3-none-any.whl --with /absolute/wheels/autogenesis_agent_contract-2.0.0-py3-none-any.whl autogenesis-appium-mcp --platform android --config /absolute/business/appium.json --project-root /absolute/business
-```
-
-After both distributions are published to the configured index:
-
-```bash
-uvx --from autogenesis-appium-mcp==0.4.0 autogenesis-appium-mcp --platform ios --config /absolute/business/appium.json --project-root /absolute/business
-```
+Maintainers testing unpublished builds may substitute reviewed local Runtime and
+Contract wheels instead of package-index coordinates.
 
 The runtime pins Agent Contract **2.0.0**, manifest SHA-256
 `4367a2e388d0d5cb41a415b25b6a58e25025f1da6749bfdffe87a37c60a0c9d3`.