docs: overhaul README, upgrade issue/PR templates, add metadata suggestions

- Rewrite README with clean UTF-8 encoding (fix garbled Unicode)
- Improve structure with navigation links and terminal preview
- Add comparison table vs promptfoo, deepeval
- Add roadmap section with completed and planned features
- Upgrade issue templates with detailed sections and categories
- Upgrade PR template with checklists and assertion/adapter categories
- Add github-metadata-suggestions.md with SEO tags and description

Author: 螃蟹 🦀

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,17 +1,60 @@
 ---
-name: Bug Report
-about: Report a bug in AgentProbe
+name: 🐛 Bug Report
+about: Report a bug or unexpected behavior in AgentProbe
+title: "[Bug] "
 labels: bug
+assignees: ''
 ---
 
-## Describe the bug
+## Description
 
-## To Reproduce
-1. ...
+A clear and concise description of the bug.
 
-## Expected behavior
+## Steps to Reproduce
+
+1. Install: `npm install @neuzhou/agentprobe`
+2. Create test file: `tests/example.test.yaml`
+3. Run: `npx agentprobe run tests/example.test.yaml`
+4. See error
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened. Include full error output.
+
+## Test File
+
+<details>
+<summary>Test YAML (if applicable)</summary>
+
+```yaml
+Paste your test file here
+```
+
+</details>
 
 ## Environment
-- OS:
-- Node:
-- AgentProbe version:
+
+- **OS:** (e.g., macOS 14.2, Ubuntu 22.04, Windows 11)
+- **Node.js version:** (`node --version`)
+- **AgentProbe version:** (from `package.json`)
+- **Adapter:** (e.g., openai, anthropic, ollama)
+- **Model:** (e.g., gpt-4o, claude-sonnet-4-20250514)
+
+## Error Output
+
+<details>
+<summary>Full error output</summary>
+
+```
+Paste error output here
+```
+
+</details>
+
+## Additional Context
+
+Any other context about the problem.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,11 +1,46 @@
 ---
-name: Feature Request
-about: Suggest a feature
+name: ✨ Feature Request
+about: Suggest a new feature or enhancement for AgentProbe
+title: "[Feature] "
 labels: enhancement
+assignees: ''
 ---
 
-## Feature description
+## Problem Statement
 
-## Use case
+What problem does this feature solve? Is it related to an existing frustration?
 
-## Proposed solution
+## Proposed Solution
+
+A clear description of what you want to happen. Include YAML or code examples if applicable:
+
+```yaml
+# Example test definition
+tests:
+  - input: "..."
+    expect:
+      your_new_assertion: true
+```
+
+## Use Case
+
+Describe a concrete scenario where this feature would be useful.
+
+## Category
+
+- [ ] 🧪 New assertion type
+- [ ] 🔌 New adapter (LLM provider)
+- [ ] 🔒 Security testing
+- [ ] 📊 Reporting / output format
+- [ ] 🤖 Multi-agent testing
+- [ ] 🔧 CLI improvement
+- [ ] 📝 Documentation
+- [ ] Other
+
+## Alternatives Considered
+
+What other approaches have you thought about?
+
+## Additional Context
+
+Any relevant examples, links, or references (e.g., testing frameworks, agent patterns).

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,7 +1,46 @@
-## Description
+## Summary
+
+Brief description of changes and motivation.
 
 ## Changes
 
+- 
+
+## Type of Change
+
+- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
+- [ ] ✨ New feature (non-breaking change that adds functionality)
+- [ ] 🧪 New assertion type
+- [ ] 🔌 New adapter
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] 📝 Documentation update
+- [ ] ♻️ Refactor (no functional change)
+
+## Testing
+
+- [ ] All existing tests pass (`npm test`)
+- [ ] New tests added for new functionality
+- [ ] Linting passes
+- [ ] Manually tested with sample test suites
+
 ## Checklist
-- [ ] Tests pass
-- [ ] Docs updated
+
+- [ ] Code follows the project's TypeScript style guidelines
+- [ ] Self-review of own code completed
+- [ ] Documentation updated (if applicable)
+- [ ] Examples updated (if adding new features)
+
+## Related Issues
+
+Closes #
+
+## Screenshots / Demo
+
+<details>
+<summary>Test output or screenshots (if applicable)</summary>
+
+```
+Paste here
+```
+
+</details>