docs: revise documentation to emphasize dual value proposition for agentic IDE users

CHANGES
- Restructure README to lead with 50% official docs + 50% auto-update value proposition
- Target agentic IDE users (VSCode/Cursor with AI assistants) explicitly
- Add AI prompts section to CONTRIBUTING.md for high-quality uniform contributions
- Include GitHub templates directory structure (.github/ISSUE_TEMPLATE, PULL_REQUEST_TEMPLATE)
- Move roadmap from CONTRIBUTING.md to README.md with checkbox format
- Add mermaid diagram showing auto-update architecture flow
- Enhance git workflow with branching patterns and commit types

IMPACT
- Developers immediately understand zero-maintenance value and official docs access
- Contributors have clear guidance on AI-assisted development workflow
- Consistent contribution quality through prompts and templates

TECHNICAL NOTES
- Preserves all existing content while improving information architecture
- Positions project value clearly for target developer audience

Author: KemingHe

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to Python Dependency Manager MCP Server
 
-> Updated on 2025-07-21 by @KemingHe
+> Updated on 2025-07-23 by @KemingHe
 
 Thank you for your interest in contributing! This document provides development setup instructions and guidelines.
 
@@ -27,6 +27,9 @@ docker build -t py-dep-man-companion .
 
 For testing the server locally during development, add this configuration to your VSCode/Cursor `mcp.json`:
 
+>[!IMPORTANT]
+> Replace `/path/to/your/python-dependency-manager-companion-mcp-server` with the absolute path to your local repository.
+
 ```json
 {
   "mcp": {
@@ -51,26 +54,44 @@ For testing the server locally during development, add this configuration to you
 }
 ```
 
->[!IMPORTANT]
-> Replace `/path/to/your/python-dependency-manager-companion-mcp-server` with the absolute path to your local repository.
-
-## 🗺️ Roadmap
-
-Adding support for pipenv, pdm, pixi, and additional Python package managers.
-
 ## 📝 Development Guidelines
 
 - Follow existing code style and structure
 - Test your changes locally using the native configuration above
 - Update documentation when adding new features
 - Submit pull requests with clear descriptions of changes
 
+### Git Workflow & Branching
+
+- **Branching pattern**: `type/feature-or-bug-scope/GitHubUsername`
+- **Types**: `feat`, `fix`, `docs`, `test`, `refactor`, `chore`
+
+### Prompts for AI-Assisted Development
+
+> [!TIP]
+> This project includes AI prompts and GitHub templates for consistent, high-quality contributions:
+
+```plaintext
+.github/
+├── ISSUE_TEMPLATE/
+│   ├── bug-report.md             # Bug report template
+│   └── feature-request.md        # Feature request template
+└── PULL_REQUEST_TEMPLATE/
+    └── pull_request_template.md  # PR template with checklist
+
+prompts/
+├── prompt-commit-msg-gen.md      # Generate uniform commit messages
+├── prompt-issue-gen.md           # Create well-structured issues
+├── prompt-pull-request-gen.md    # Write comprehensive PR descriptions
+└── prompt-readme-gen.md          # Maintain documentation standards
+```
+
 ## 🔄 Automated Updates
 
 This repository includes automated workflows that:
 
-- Update documentation weekly from official sources
-- Rebuild search indexes automatically
-- Publish multi-architecture Docker images
+1. Update documentation weekly from official sources
+2. Rebuild search indexes automatically
+3. Publish multi-architecture Docker images
 
 See [.github/workflows/README.md](.github/workflows/README.md) for workflow details.

README.md

@@ -1,30 +1,18 @@
 # Python Dependency Manager Companion MCP Server
 
-> Updated on 2025-07-21 by [@KemingHe](https://github.com/KemingHe)
+> README updated on 2025-07-23 by [@KemingHe](https://github.com/KemingHe)
 
-Local stdio MCP server providing unified search across Python dependency managers' latest and official documentation. [[Demo]](https://www.loom.com/share/a80f6041dc374c07b95b2397ee4e8ca1?sid=1209cdce-7239-447e-8b20-49eae454cc9a)
+Official docs from pip, poetry, uv, and conda + automated weekly updates = zero maintenance overhead for developers using VSCode/Cursor with AI assistants. [[Demo]](https://www.loom.com/share/a80f6041dc374c07b95b2397ee4e8ca1?sid=1209cdce-7239-447e-8b20-49eae454cc9a)
 
-## 📋 Overview
+## 🚀 Quick Start for Agentic IDEs
 
-Unified search for pip, poetry, uv, and conda docs via Docker with automated weekly updates. Built with FastMCP and Tantivy for simple, accurate, embedding-free, full-text search.
-
-## 🎯 Use as Template
-
-**General use**: [[Use this repository as a template]](https://github.com/new?template_name=python-dependency-manager-companion-mcp-server&template_owner=KemingHe) for your own MCP server projects.
-
-**Contributing**: Fork to contribute back. See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup.
-
-## 🚀 Getting Started
-
-### Step 1: Pull Docker Image
+**1. Pull latest Docker image**:
 
 ```shell
 docker pull keminghe/py-dep-man-companion:latest
 ```
 
-### Step 2: Configure Your IDE
-
-Add to VSCode/Cursor `mcp.json`:
+**2. Add to your IDE's `mcp.json`**:
 
 ```json
 {
@@ -39,9 +27,35 @@ Add to VSCode/Cursor `mcp.json`:
 }
 ```
 
-### Step 3: Start Searching
+**3. Query official docs directly in your AI chat** - guaranteed fresh from weekly automated updates.
+
+## 🤝 Contributing
+
+**Use as template**: [[Create from template]](https://github.com/new?template_name=python-dependency-manager-companion-mcp-server&template_owner=KemingHe) for your own MCP server projects.
+
+**Contribute back**: Fork and see [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup.
+
+## 🔄 Auto-Update Architecture
+
+```mermaid
+graph LR
+    WEEKLY["⏰ Every Tuesday 06:00pm ET"]
+    DOCS["📚 Sync Official Docs"]
+    INDEX["🔍 Rebuild Search Index"]
+    DOCKER["🐳 Publish Latest Image"]
+    
+    WEEKLY --> DOCS
+    DOCS --> INDEX
+    INDEX --> DOCKER
+```
+
+**Zero maintenance**: Documentation automatically synced weekly from official sources. Docker `:latest` tag guarantees you always get current docs without manual updates.
+
+## 🗺️ Roadmap
 
-Query latest and unified documentation across all supported Python dependency managers directly within your agentic chat.
+- [ ] Add support for pipenv, pdm, pixi
+- [ ] Add comprehensive tests with 100% coverage  
+- [ ] Add indexing support for PDF and CSV files
 
 ## 📁 Project Structure
 
@@ -73,4 +87,4 @@ This project is licensed under the [MIT License](./LICENSE) - a permissive licen
 
 ## 📞 Support
 
-Open GitHub issues for bug reports and feature requests. Documentation is automatically updated weekly via workflows (see [.github/workflows/README.md](./.github/workflows/README.md)).
+Open a [GitHub issue](https://github.com/KemingHe/python-dependency-manager-companion-mcp-server/issues) for bug reports and feature requests.