Merge pull request #122 from patvice/issue-readme-update

Docs refresh: README/index rewrite, examples, and issue template

Author: patvice

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,48 @@
+---
+name: Bug report
+about: Report a bug or regression in RubyLLM::MCP
+title: "[Bug]: "
+labels: bug, needs-triage
+---
+
+> If you have a MCP example where you had an issue, please include it.
+> A small reproducible MCP example makes debugging much faster. 
+> Include a quick ruby script with your MCP and failure to be able to reproduce helpful as well.
+
+## Summary
+
+What happened?
+
+## Expected behavior
+
+What did you expect to happen?
+
+## Actual behavior
+
+What actually happened? Include error messages and stack traces if possible.
+
+## Minimal reproducible example (include MCP example)
+
+```ruby
+require "ruby_llm/mcp"
+
+# Paste a small runnable example here
+```
+
+## Environment (optional - delete any lines not relevant)
+
+- `ruby_llm-mcp` version:
+- Ruby version:
+- Adapter (`:ruby_llm` / `:mcp_sdk`):
+- Transport (`stdio` / `streamable` / `sse`):
+- MCP server + version:
+
+## Logs / output (optional)
+
+```text
+Paste logs here
+```
+
+## Additional context (optional)
+
+Anything else that may help debug this.

.gitignore

@@ -19,3 +19,8 @@ Gemfile.lock
 
 node_modules/
 .vcr_debug.log
+
+# AI specific files
+CLAUDE.md
+.claude
+AGENTS.md