update readme

Author: marcusschiesser

README.md

@@ -14,7 +14,7 @@
   <a href="https://www.npmjs.com/package/agentpond"><img src="https://img.shields.io/node/v/agentpond.svg" alt="Node.js version"></a>
 </p>
 
-AgentPond is a lightweight trace backend and CLI for AI applications. It keeps raw traces in object storage you control and syncs them into a local DuckDB cache for fast analysis by developers and coding agents. Use it with Firebase Storage, Supabase Storage, Amazon S3, Google Cloud Storage, Vercel Blob, or custom infrastructure. Firebase, Supabase, and Vercel include automated setup; other deployments use the manual setup path.
+AgentPond is a lightweight trace backend and CLI for AI applications. It keeps raw traces in object storage you control and syncs them into a local DuckDB cache for fast analysis by your coding agent. Use it with Firebase Storage, Supabase Storage, Amazon S3, Google Cloud Storage, Vercel Blob, or custom infrastructure. Firebase, Supabase, and Vercel projects include automated setup; other deployments use a manual setup path.
 
 ## How it works
 
@@ -24,21 +24,21 @@ Object storage is the durable source of truth. The local DuckDB database is a re
 
 ## Getting started
 
-Start with the [Manual deployment setup](./docs/getting-started/manual-setup.md) to choose a write path, configure object storage, instrument the application, and sync its traces into AgentPond.
+Start with the [Manual deployment setup](./docs/getting-started/manual-setup.md) to configure object storage, instrument the application, and sync its traces into AgentPond.
 
-For Firebase, Supabase, and Vercel, AgentPond also provides automated quick starts:
+For Firebase, Supabase, and Vercel projects, AgentPond provides automated quick starts:
 
 - [Firebase quick start](./docs/getting-started/firebase.md)
 - [Supabase quick start](./docs/getting-started/supabase.md)
 - [Vercel quick start](./docs/getting-started/vercel.md)
 
-All require Node.js 22 or newer for the CLI. From the provider project, run:
+All require Node.js 22 or newer for the CLI. From your project folder, run:
 
 ```sh
 npx agentpond init
 ```
 
-The command detects the platform, installs AgentPond's instrumentation and analytics skills, and prints a prompt for your coding agent. The agent inspects the trusted Node.js application, proposes the provider-specific setup, implements it after confirmation, and verifies a real trace.
+The command detects the platform, installs AgentPond's instrumentation and analytics skills, and prints a install prompt for your coding agent. Your agent inspects then the application, proposes a setup, implements it after confirmation, and verifies a real trace end to end.
 
 Once the application has emitted a trace: