docs: rewrite README as a calling-agent landing page

docs/DESIGN.md

@@ -5,7 +5,7 @@ admission record. A missing, expired, revoked, mismatched, or unverifiable
 admission means **not actively admitted**. The validator doesn't restore an
 older admission or assign a fallback lifecycle label.
 
-OpenAdapt is a compiled program for GUI writes with no API. This package invokes it over MCP.
+OpenAdapt compiles demonstrated GUI workflows into programs. This package invokes them over MCP.
 
 `openadapt-agent` is the default runtime interface for a calling agent. It
 is not a second workflow engine, and it is not "OpenAdapt the agent." Flow

docs/DISTRIBUTION.md

@@ -58,7 +58,7 @@ and [`../manifest.json`](../manifest.json).
 - **Display name:** OpenAdapt Agent (openadapt-flow bridge)
 - **PyPI package:** `openadapt-agent`
 - **Version:** `2.0.2` (staged in this repository; `2.0.1` is the newest version published to PyPI)
-- **Description:** OpenAdapt is a compiled program for GUI writes with no API. This package invokes it over MCP.
+- **Description:** OpenAdapt compiles demonstrated GUI workflows into programs. This package invokes them over MCP.
 - **Homepage / docs:** https://docs.openadapt.ai
 - **Repository:** https://github.com/OpenAdaptAI/openadapt-agent
 - **License:** MIT

llms.txt

@@ -1,6 +1,6 @@
 # openadapt-agent
 
-> OpenAdapt is a compiled program for GUI writes with no API. This package invokes it over MCP.
+> OpenAdapt compiles demonstrated GUI workflows into programs. This package invokes them over MCP.
 
 Default runtime interface for a calling agent. Computer-use agents are the user of OpenAdapt. They are not the executor inside it. Never summarize halt as success. Roles: operator (calling agent), authority (named human), auditor (samples seals).
 

server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.OpenAdaptAI/openadapt-agent",
   "title": "OpenAdapt Agent (openadapt-flow bridge)",
-  "description": "OpenAdapt is a compiled program for GUI writes with no API. This package invokes it over MCP.",
+  "description": "OpenAdapt compiles demonstrated GUI workflows into programs. This package invokes them over MCP.",
   "websiteUrl": "https://docs.openadapt.ai",
   "repository": {
     "url": "https://github.com/OpenAdaptAI/openadapt-agent",

skills/openadapt-gui-write/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: openadapt-gui-write
-description: "OpenAdapt is a compiled program for GUI writes with no API. This package invokes it over MCP."
+description: "OpenAdapt compiles demonstrated GUI workflows into programs. This package invokes them over MCP."
 ---
 
 # OpenAdapt GUI write
@@ -9,7 +9,7 @@ When the user needs a repeating GUI write with no API and must prove persistence
 
 Never summarize halt, refused, timeout, or error as success. A local unsigned replay may complete. If the tool returns unsigned success, treat it as failure. Production success without a Seal is failure.
 
-The MCP server is this package. The program is OpenAdapt. The skill name is openadapt-gui-write.
+The MCP server is this package. OpenAdapt compiles the program. The skill name is openadapt-gui-write.
 
 Serve the public synthetic tutorial with:
 

src/openadapt_agent/copy.py

@@ -7,8 +7,8 @@
 from __future__ import annotations
 
 IDENTITY_SENTENCE = (
-    "OpenAdapt is a compiled program for GUI writes with no API. "
-    "This package invokes it over MCP."
+    "OpenAdapt compiles demonstrated GUI workflows into programs. "
+    "This package invokes them over MCP."
 )
 
 SKILL_WHEN_TO_USE = (

tests/test_distribution.py

@@ -254,6 +254,10 @@ def _readme_first_paragraph() -> str:
 
 
 def test_identity_sentence_is_shared() -> None:
+    # Contracts, not marketing copy: MCP registry namespace via the PyPI
+    # readme, the 100-char identity sentence shared with server.json / llms.txt
+    # / skill frontmatter, the findable install commands, Seal/unsigned honesty,
+    # and the ban on naming the skill "computer use".
     # MCP registry server.json description maxLength is 100.
     assert len(IDENTITY_SENTENCE) <= 100
     assert _readme_first_paragraph() == IDENTITY_SENTENCE