copy: two authoring modes, person-click and watch-and-admit

docs/get-started/first-workflow.md

@@ -8,8 +8,9 @@ first_write_admission: qualification_required
 
 # Author a workflow
 
-This is authority work. A named human demonstrates the task once. An agent
-operates the compiled program later.
+This is authority work. A person or a local agent they watch demonstrates
+the task once. A named human admits the compiled program. An agent
+operates it later.
 
 Choose one small real task that doesn't change business data. A read-only lookup
 against test data works well. Open a known test record, then stop when a field

docs/get-started/index.md

@@ -1,16 +1,18 @@
 ---
 description: >-
-  Install OpenAdapt on this computer with Desktop or pip. Show the task
-  once; it becomes a program your agent can run. Tutorial is optional.
+  Install OpenAdapt on this computer with Desktop or pip. You can show
+  the task, or a local agent can click while you watch. A person admits.
+  Tutorial is optional.
 ---
 
 # Get started
 
 You want an agent to do a job on this computer. Keep that job here.
 
-You show the clicks once. OpenAdapt turns that into a program on this
-computer, and later an agent runs it and checks the work landed. Healthy
-repeats don't send your data to a model.
+You can show the clicks, or a local agent can click while you watch.
+A person admits the compiled program. OpenAdapt turns that into a
+program on this computer, and later an agent runs it and checks the
+work landed. Healthy repeats don't send your data to a model.
 
 OpenAdapt is a compiler. The chat is the IDE, and credentials stay on this
 computer. The core is free forever under MIT.

docs/index.md

@@ -36,12 +36,13 @@ which runs the clicks on this computer.
 ## Where OpenAdapt fits
 
 OpenAdapt is the governed last mile an agent calls when the next write has no
-API. A named human authors the program once. The calling agent operates it.
-The human returns for identity, effect, and judgment halt, then samples seals.
+API. A person or a local agent they watch demonstrates. A named human
+admits the program. The calling agent operates it. The human returns for
+identity, effect, and judgment halt, then samples seals.
 
 A strong first workflow has these traits:
 
-- A person can demonstrate the task from start to finish.
+- A person or a local agent they watch can demonstrate the task from start to finish.
 - The inputs are mostly structured and the business intent stays stable.
 - The application has no practical write API for the required step.
 - A wrong action has an operational, financial, or compliance cost.
@@ -164,8 +165,9 @@ report determine its outcome.
 
 -   [__Author a workflow__](get-started/first-workflow.md)
 
-    A named human captures one browser workflow, compiles it, runs it, and
-    inspects the report. Authority, not daily operator.
+    A person or a local agent they watch records one browser workflow.
+    A named human admits the compiled program and inspects the report.
+    Authority, not daily operator.
 
 -   [__Prepare a production workflow__](guides/qualify-a-workflow.md)
 

docs/llms.txt

@@ -8,7 +8,7 @@ Canonical status: https://docs.openadapt.ai/production-lifecycle.json. The signe
 - [agents.txt](https://docs.openadapt.ai/agents.txt): MCP, skills, outcome vocabulary (`VERIFIED` / `HALTED` / `RECONCILIATION_REQUIRED`), who may resolve a halt
 - [Get started](https://docs.openadapt.ai/get-started/): Install with Desktop or `python -m pip install --upgrade openadapt`. First command after install: `openadapt flow tutorial`. That writes a VERIFIED receipt. `openadapt quickstart --break-it` is the halt demo. Tutorial is optional. Local coding agents can `claude mcp add openadapt` later. Never summarize halt as success. Older `/getting-started/` URLs and the `/start/` alias redirect here. The current CLI after install is `openadapt flow record`, `compile`, `replay`.
 - [Qualification evidence](https://docs.openadapt.ai/get-started/what-works-today/): Accepted substrate results, exact environments, and deployment boundaries
-- [Author a workflow](https://docs.openadapt.ai/get-started/first-workflow/): A named human records, compiles, lints, replays, and reads the report on your own web app. Authority, not daily operator.
+- [Author a workflow](https://docs.openadapt.ai/get-started/first-workflow/): A person or a local agent they watch records, compiles, lints, and replays. A named human admits and reads the report on your own web app. Authority, not daily operator.
 - [What you get](https://docs.openadapt.ai/get-started/what-you-get/): The workflow bundle, the run report, and what each artifact is for
 - [The Seal](https://docs.openadapt.ai/commercial/seal/): Signed proof of a verified, halted, or reconciling run. `openadapt-flow replay bundle --seal`. Public verify at `https://openadapt.ai/seals/{id}` (synthetic only)