docs: fix /init command references (was init-agents)

- Update README.md, overview.mdx, creating-your-first-agent.mdx to use /init
- Add comprehensive /init documentation to quick-start.mdx
- Document what files /init creates and when to use it

Author: brandonkachen

README.md

@@ -76,23 +76,26 @@ Run `codebuff --help` for full details and examples.
 
 ## Create custom agents
 
-To get started building your own agents, run:
+To get started building your own agents, start Codebuff and run the `/init` command:
 
 ```bash
-codebuff init-agents
+codebuff
 ```
 
-> 💡 **Tip**: This creates an agent development guide at `.agents/README.md` with examples and TypeScript types.
+Then inside the CLI:
+
+```
+/init
+```
 
 This creates:
 ```
+knowledge.md               # Project context for Codebuff
 .agents/
-├── README.md              # Agent development guide
-├── my-custom-agent.ts     # Working agent template
-├── package.json           # NPM package config
-├── LICENSE                # Apache-2.0 license
-├── examples/              # 3 example agents
-└── types/                 # TypeScript definitions
+└── types/                 # TypeScript type definitions
+    ├── agent-definition.ts
+    ├── tools.ts
+    └── util-types.ts
 ```
 
 You can write agent definition files that give you maximum control over agent behavior.

web/src/content/agents/overview.mdx

@@ -79,8 +79,16 @@ Agents coordinate through the `spawnerPrompt` field, which tells others when to
 
 ## Quick Start
 
+Start Codebuff and run the `/init` command to set up your project:
+
 ```bash
-codebuff init-agents
+codebuff
+```
+
+Then inside the CLI:
+
+```
+/init
 ```
 
 1. **[Customize existing agents](/docs/agents#customizing-agents)** - Modify prompts and tools

web/src/content/help/quick-start.mdx

@@ -29,6 +29,29 @@ codebuff
 
 Codebuff has multiple [modes](/docs/tips#modes): `lite` for quick tasks, `max` for complex work, and `plan` for planning without file changes. You can invoke them in the slash menu with `/mode:`.
 
+## 4. Initialize Your Project (Optional)
+
+Run the `/init` command inside Codebuff to set up project-specific files:
+
+```
+/init
+```
+
+### What `/init` Creates
+
+| File/Directory | Purpose |
+|---------------|----------|
+| `knowledge.md` | A starter file for documenting your project's setup commands, architecture, and coding conventions. Codebuff reads this to understand your project better. |
+| `.agents/types/` | TypeScript type definitions for creating custom agents. |
+
+### When to Use `/init`
+
+- **New projects** — Run `/init` once to create a `knowledge.md` file and get Codebuff familiar with your project.
+- **Building custom agents** — The `.agents/types/` directory provides TypeScript types for full IntelliSense when creating agents.
+- **Team onboarding** — Commit `knowledge.md` to your repo so Codebuff works consistently for all team members.
+
+> **Note:** `/init` is safe to run multiple times. It skips files that already exist and only creates missing ones.
+
 ## Troubleshooting
 
 If you run into issues during installation:

web/src/content/walkthroughs/creating-your-first-agent.mdx

@@ -40,17 +40,22 @@ order: 1
 npm install -g codebuff
 ```
 
-In your project:
+In your project, start Codebuff and run the `/init` command:
 
 ```bash
-codebuff init-agents
+codebuff
+```
+
+Then inside the CLI:
+
+```
+/init
 ```
 
 This creates:
 
-- `.agents/types/` - type definitions
-- `.agents/examples/` - example agents
-- `.agents/my-custom-agent.ts` - starter template
+- `knowledge.md` - project context for Codebuff
+- `.agents/types/` - TypeScript type definitions for creating agents
 
 ## Create an Agent