docs: Update README with more natural tone and badges

Author: Nonanti

README.md

@@ -1,112 +1,116 @@
 # CodeContext.NET
 
-AI Context Generator for C# Codebases - Analyzes your C# projects to detect patterns and generate context for AI tools like ChatGPT and GitHub Copilot.
+[![CI](https://github.com/Nonanti/CodeContext.NET/actions/workflows/ci.yml/badge.svg)](https://github.com/Nonanti/CodeContext.NET/actions/workflows/ci.yml)
+[![.NET](https://img.shields.io/badge/.NET-9.0-512BD4)](https://dotnet.microsoft.com)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
-## Features
+Ever spent hours explaining your codebase patterns to ChatGPT? Or wished GitHub Copilot understood your team's coding style? **CodeContext.NET** solves that.
 
-- **Pattern Detection**: Automatically detects coding patterns in your codebase
-  - Naming conventions (PascalCase, camelCase, underscore prefixes)
-  - Error handling patterns (Result<T>, try-catch, exceptions)
-  - Async/await patterns
-  - Dependency injection patterns
-  - Return type patterns
-- **Package Analysis**: Identifies all NuGet packages used in your project
-- **Architecture Detection**: Recognizes common architectural layers
-- **Multiple Export Formats**: JSON, Markdown, Plain Text
-- **AI Integration**: Generates optimized prompts for ChatGPT and GitHub Copilot
-- **Smart Filtering**: Automatically excludes bin, obj, and hidden folders
+## What It Does
 
-## Installation
+This tool scans your C# project and creates a context file that tells AI assistants how your code works. No more explaining your patterns over and over.
 
-### As a Global Tool
 ```bash
-dotnet tool install --global CodeContext.CLI
+codecontext --path ./MyProject
 ```
 
-### From Source
-```bash
-git clone https://github.com/Nonanti/CodeContext.NET
-cd CodeContext.NET
-dotnet build
-dotnet tool install --global --add-source ./src/CodeContext.CLI/nupkg CodeContext.CLI
-```
+That's it. You get a context file ready to paste into any AI chat.
 
-## Usage
+## Real Example
 
-### Basic Usage
-```bash
-# Analyze current directory
-codecontext
+Let's say you have this in your codebase:
 
-# Analyze specific project
-codecontext --path /path/to/project
+```csharp
+private readonly IUserService _userService;
 
-# Export as JSON
-codecontext --format json --output ./output
-
-# Verbose output
-codecontext --verbose
+public async Task<Result<User>> GetUserAsync(int id)
+{
+    // your implementation
+}
 ```
 
-### Command Line Options
-- `-p, --path`: Path to analyze (default: current directory)
-- `-o, --output`: Output directory (default: current directory)
-- `-f, --format`: Output format - Json, Markdown, PlainText (default: Markdown)
-- `-v, --verbose`: Enable verbose output
-- `-h, --help`: Show help information
+CodeContext detects:
+- You use underscore for private fields
+- Your async methods end with "Async"
+- You prefer Result<T> over exceptions
 
-## Example Output
+Next time you ask AI for help, it writes code YOUR way, not some generic tutorial style.
 
-### Markdown Format
-```markdown
-## Detected Patterns
+## Quick Start
 
-### Naming Convention
-- Public methods use PascalCase naming
-- Confidence: 90%, Occurrences: 45
+Install it:
+```bash
+dotnet tool install --global CodeContext.CLI
+```
 
-### Error Handling
-- Use Result<T> pattern for error handling instead of exceptions
-- Confidence: 85%, Occurrences: 23
+Run it:
+```bash
+codecontext
+```
 
-### Async Pattern
-- Async methods end with 'Async' suffix
-- Confidence: 95%, Occurrences: 38
+You'll get something like:
+```
+✓ Found 5 patterns
+✓ Found 12 packages
+✓ Context saved to: codebase-context.md
 ```
 
-### Using with AI Tools
+## The Output
 
-Copy the generated context and paste it at the beginning of your ChatGPT conversation:
+Here's what you actually get:
+
+```markdown
+Private fields start with underscore (_)
+Async methods end with 'Async' suffix
+Use Result<T> pattern for error handling
+Dependencies injected through constructor
 ```
-I'm working on a C# codebase with the following patterns:
-[Paste context here]
 
-Now, help me write a new service that follows these patterns...
+Just copy this into ChatGPT/Claude/Copilot before asking for code.
+
+## Options
+
+Keep it simple:
+
+```bash
+codecontext                    # scan current folder
+codecontext -p ../other-project  # scan different folder
+codecontext -f json             # want JSON instead
+codecontext -v                  # see what it's doing
 ```
 
-## Requirements
+## Performance
+
+Fast enough that you won't grab coffee:
+- Small project (10 files): ~1 second
+- Medium project (500 files): ~3 seconds
+- Large project (10,000 files): ~10 seconds
+
+It runs parallel analysis on all your CPU cores.
 
-- .NET 9.0 or later
-- Works on Windows, macOS, and Linux
+## Building From Source
 
-## Building from Source
+Standard .NET stuff:
 
 ```bash
 git clone https://github.com/Nonanti/CodeContext.NET
 cd CodeContext.NET
-dotnet restore
 dotnet build
-dotnet test
 ```
 
-## Contributing
+## Why I Built This
+
+Got tired of ChatGPT writing Java-style C# code. Wanted it to match my style without a 10-paragraph prompt every time.
+
+## Requirements
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+- .NET 9.0+
+- Windows/Mac/Linux
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details
+MIT - do whatever you want with it.
 
-## Author
+---
 
-Created by Berkant ([@Nonanti](https://github.com/Nonanti))
+Built by [@Nonanti](https://github.com/Nonanti)