Tweaks for readme, delete local-development.md, since we have CONTRIBUTING.md now

Author: jahooma

CONTRIBUTING.md

@@ -22,43 +22,49 @@ Before you begin, you'll need to install a few tools:
 ### Setting Up Your Development Environment
 
 1. **Hook direnv into your shell** (one-time setup):
+
    - For zsh: `echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc && source ~/.zshrc`
    - For bash: `echo 'eval "$(direnv hook bash)"' >> ~/.bashrc && source ~/.bashrc`
    - For fish: `echo 'direnv hook fish | source' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish`
 
 2. **Restart your shell**: Run `exec $SHELL` or restart your terminal
 
 3. **Clone the repository**:
+
    ```bash
    git clone https://github.com/CodebuffAI/codebuff.git
    cd codebuff
    ```
 
 4. **Set up secrets management**:
+
    ```bash
    infisical login
    # Select "US" region when prompted
    infisical secrets  # Verify setup works
    ```
 
 5. **Configure environment**:
+
    ```bash
    direnv allow
    ```
 
 6. **Install dependencies**:
+
    ```bash
    bun install
    ```
 
 7. **Start development services** (requires 3 terminals):
+
    ```bash
    # Terminal 1 - Backend server
    bun run start-server
-   
+
    # Terminal 2 - Web server
    bun run start-web
-   
+
    # Terminal 3 - CLI client
    bun run start-bin
    ```
@@ -98,7 +104,7 @@ Here's how we like to work together:
 4. **Type check** - Run `bun run typecheck` to catch any TypeScript issues
 5. **Submit a PR** - Open a pull request with a clear description of what you built and why
 
-*Pro tip: Small, focused PRs are easier to review and merge quickly!*
+_Pro tip: Small, focused PRs are easier to review and merge quickly!_
 
 ### Code Style Guidelines
 
@@ -139,23 +145,29 @@ test: add unit tests for file operations
 There are tons of ways to make Codebuff better! Here are some areas where your skills could really shine:
 
 ### 🤖 **Agent Development**
+
 Build specialized agents in `.agents/` for different languages, frameworks, or workflows. Think React experts, Python debuggers, or Git wizards!
 
-### 🔧 **Tool System** 
+### 🔧 **Tool System**
+
 Add new capabilities in `backend/src/tools.ts` - file operations, API integrations, development environment helpers. The sky's the limit!
 
 ### 📦 **SDK Improvements**
+
 Make the SDK in `sdk/` even more powerful with new methods, better TypeScript support, or killer integration examples.
 
 ### 💻 **CLI Magic**
+
 Enhance the user experience in `npm-app/` with smoother commands, better error messages, or interactive features that make developers smile.
 
 ### 🌐 **Web Dashboard**
+
 Level up the web interface in `web/` with better agent management, project templates, analytics, or any UX improvements you can dream up.
 
 ## Getting Help
 
 **Setup issues?**
+
 - **direnv problems?** Make sure it's hooked into your shell, run `direnv allow`, and restart your terminal
 - **Script errors?** Double-check you're using bun for all commands
 - **Can't find files?** See our [local development guide](./local-development.md) for more detailed setup
@@ -164,7 +176,6 @@ Level up the web interface in `web/` with better agent management, project templ
 
 ## Resources
 
-- **Detailed setup guide**: [local-development.md](./local-development.md)
 - **Documentation**: [codebuff.com/docs](https://codebuff.com/docs)
 - **Community Discord**: [codebuff.com/discord](https://codebuff.com/discord)
-- **Report issues**: [GitHub Issues](https://github.com/CodebuffAI/codebuff/issues)
+- **Report issues**: [GitHub Issues](https://github.com/CodebuffAI/codebuff/issues)

README.md

@@ -1,25 +1,23 @@
 # Codebuff
 
-**Open-source AI coding assistant** that edits your codebase through natural language instructions. Instead of using one model for everything, it coordinates specialized agents that work together to understand your project and make precise changes.
+Codebuff is an **open-source AI coding assistant** that edits your codebase through natural language instructions. Instead of using one model for everything, it coordinates specialized agents that work together to understand your project and make precise changes.
 
 <div align="center">
   <img src="./assets/codebuff-vs-claude-code.png" alt="Codebuff vs Claude Code" width="400">
 </div>
 
 Codebuff beats Claude Code at 61% vs 53% on [our evals](evals/README.md) across 175+ coding tasks over multiple open-source repos that simulate real-world tasks.
 
-> **🎆 Built by the community, for the community** - Join us in making AI coding assistance better for everyone!
-
 ![Codebuff Demo](./assets/demo.gif)
 
 ## How it works
 
 When you ask Codebuff to "add authentication to my API," it might invoke:
 
-1. A **File Explorer Agent** scans your codebase to understand the architecture and find relevant files
-2. An **Planner Agent** plans which files need changes and in what order
-3. An **Implementation Agents** make precise edits
-4. A **Review Agents** validate changes
+1. A **File Explorer Agent** to scan your codebase to understand the architecture and find relevant files
+2. A **Planner Agent** to plan which files need changes and in what order
+3. An **Editor Agent** to make precise edits
+4. A **Reviewer Agent** to validate changes
 
 <div align="center">
   <img src="./assets/multi-agents.png" alt="Codebuff Multi-Agents" width="250">
@@ -88,6 +86,7 @@ export default {
 ## SDK: Run agents in production
 
 Install the [SDK package](https://www.npmjs.com/package/@codebuff/sdk) -- note this is different than the CLI codebuff package.
+
 ```bash
 npm install @codebuff/sdk
 ```
@@ -145,13 +144,14 @@ Learn more about the SDK [here](https://www.npmjs.com/package/@codebuff/sdk).
 
 ## Contributing to Codebuff
 
-🚀 **Codebuff is open source!** We love contributions from the community - whether you're fixing bugs, building new agents, or improving documentation.
+We ❤️ contributions from the community - whether you're fixing bugs, tweaking our agents, or improving documentation.
 
 **Want to contribute?** Check out our [Contributing Guide](./CONTRIBUTING.md) to get started.
 
 Some ways you can help:
+
 - 🐛 **Fix bugs** or add features
-- 🤖 **Create specialized agents** for different languages/frameworks  
+- 🤖 **Create specialized agents** and publish them to the Agent Store
 - 📚 **Improve documentation** or write tutorials
 - 💡 **Share ideas** in our [GitHub Issues](https://github.com/CodebuffAI/codebuff/issues)
 
@@ -165,14 +165,12 @@ Some ways you can help:
 
 ### Resources
 
-**Contributing**: [CONTRIBUTING.md](./CONTRIBUTING.md) - Start here to contribute!
-
-**Local Development**: [local-development.md](./local-development.md) - Detailed setup guide
-
 **Documentation**: [codebuff.com/docs](https://codebuff.com/docs)
 
 **Community**: [Discord](https://codebuff.com/discord) - Join our friendly community
 
 **Issues & Ideas**: [GitHub Issues](https://github.com/CodebuffAI/codebuff/issues)
 
+**Contributing**: [CONTRIBUTING.md](./CONTRIBUTING.md) - Start here to contribute!
+
 **Support**: [support@codebuff.com](mailto:support@codebuff.com)