From c234738499b3f9ebf11837eda3e9e1751c316879 Mon Sep 17 00:00:00 2001 From: abrichr Date: Wed, 2 Sep 2026 15:23:06 -0400 Subject: [PATCH] copy: two authoring modes, person-click and watch-and-admit A person or a local agent they watch may demonstrate. A named human admits. Hosted chat still does not click on their machine. --- docs/get-started/first-workflow.md | 5 +++-- docs/get-started/index.md | 12 +++++++----- docs/index.md | 12 +++++++----- docs/llms.txt | 2 +- 4 files changed, 18 insertions(+), 13 deletions(-) diff --git a/docs/get-started/first-workflow.md b/docs/get-started/first-workflow.md index b702a25..48c6ead 100644 --- a/docs/get-started/first-workflow.md +++ b/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 diff --git a/docs/get-started/index.md b/docs/get-started/index.md index 98c061c..5d9dee0 100644 --- a/docs/get-started/index.md +++ b/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. diff --git a/docs/index.md b/docs/index.md index 73f99f9..2991fe8 100644 --- a/docs/index.md +++ b/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) diff --git a/docs/llms.txt b/docs/llms.txt index cfb08a4..dff27e9 100644 --- a/docs/llms.txt +++ b/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)