diff --git a/README.md b/README.md
index 275ed31cd..4c5eaf9de 100644
--- a/README.md
+++ b/README.md
@@ -157,6 +157,19 @@ Learn more about the SDK [here](https://www.npmjs.com/package/@codebuff/sdk).
 
 **SDK**: Build Codebuff into your applications. Create custom tools, integrate with CI/CD, or embed coding assistance into your products.
 
+## Advanced Usage
+
+### Custom Agent Workflows
+
+Create your own agents with specialized workflows using the `/init` command:
+
+```bash
+codebuff
+/init
+```
+
+This creates a custom agent structure in `.agents/` that you can customize.
+
 ## Contributing to Codebuff
 
 We ❤️ contributions from the community - whether you're fixing bugs, tweaking our agents, or improving documentation.
diff --git a/common/src/env.ts b/common/src/env.ts
index f9328f91c..0e30987b7 100644
--- a/common/src/env.ts
+++ b/common/src/env.ts
@@ -2,7 +2,8 @@ import { clientEnvSchema, clientProcessEnv } from './env-schema'
 
 const parsedEnv = clientEnvSchema.safeParse(clientProcessEnv)
 if (!parsedEnv.success) {
-  throw parsedEnv.error
+  console.error('Environment validation failed:', parsedEnv.error.errors)
+  throw new Error(`Invalid environment configuration: ${parsedEnv.error.message}`)
 }
 
 export const env = parsedEnv.data