docs: update README & ISSUE_TEMPLATE/general.md for v2 multi-agent system

Author: coderooz

.github/ISSUES_TEMPLATE/ISSUES_TEMPLATE.md

@@ -0,0 +1,185 @@
+---
+name: 🧠 General Issue
+about: Use this for complex, cross-system, or unclear issues
+title: "[GENERAL] "
+labels: discussion
+---
+
+> ⚠️ Use this template only if none of the other templates (bug, feature, MCP) fit your issue.
+
+# 🧠 General Issue — Local MCP Memory Server
+
+Thanks for taking the time to report an issue or suggest an improvement 🚀
+
+This template is designed for:
+- complex problems
+- cross-system issues (memory + tasks + agents)
+- unclear or exploratory discussions
+
+---
+
+## 📌 Issue Type
+
+Select one:
+
+- [ ] 🐛 Bug (complex / unclear)
+- [ ] ✨ Feature (multi-system)
+- [ ] ⚡ Performance
+- [ ] 🧠 MCP / Agent Behavior
+- [ ] 🏗 Architecture / Design
+- [ ] ❓ Question / Discussion
+
+---
+
+## 📝 Description
+
+Provide a clear explanation of the situation:
+
+```txt
+What is happening?
+What are you trying to achieve?
+Why is this important?
+````
+
+---
+
+## 🎯 Expected Outcome
+
+What should ideally happen?
+
+```txt
+Describe the desired system behavior
+```
+
+---
+
+## ❗ Current Behavior (if applicable)
+
+```txt
+What is actually happening?
+Include errors, inconsistencies, or unexpected results
+```
+
+---
+
+## 🧩 System Scope (IMPORTANT)
+
+Which parts of the system are involved?
+
+* [ ] Memory system
+* [ ] Task system
+* [ ] Agent system
+* [ ] Messaging system
+* [ ] Project Map
+* [ ] MCP protocol
+* [ ] Other:
+
+---
+
+## 🧠 MCP Context
+
+* Agent:
+* MCP tools involved:
+* Was `get_agent_instructions` used? (Yes/No)
+* Memory server running? (Yes/No)
+* Any MCP errors:
+
+---
+
+## 🔄 Workflow Context (v2+)
+
+If applicable:
+
+* Were tasks involved? (Yes/No)
+* Were messages involved? (Yes/No)
+* Was there coordination between agents?
+* Any duplication or conflict observed?
+
+---
+
+## 🔁 Steps / Scenario (if reproducible)
+
+```txt
+Describe the sequence of actions or scenario
+```
+
+---
+
+## 📦 Environment
+
+* OS: (Windows / Linux / macOS)
+* Node.js:
+* MongoDB:
+* Project (MCP_PROJECT / folder name):
+* Running via:
+
+  * [ ] Codex
+  * [ ] Roo
+  * [ ] CLI
+  * [ ] Other
+
+---
+
+## 📄 Logs / Error Output
+
+```bash
+(paste logs here)
+```
+
+---
+
+## 📂 Affected Areas / Files
+
+```txt
+List modules, files, or systems involved
+```
+
+---
+
+## 💡 Thoughts / Hypothesis (Optional)
+
+```txt
+What do you think might be causing this?
+Any ideas for improvement?
+```
+
+---
+
+## 🧠 Additional Context
+
+* screenshots
+* architecture notes
+* related issues
+* prior attempts
+
+---
+
+## 🔍 Checklist
+
+* [ ] I checked existing issues
+* [ ] I provided enough context
+* [ ] I included logs (if applicable)
+* [ ] I understand MCP requires clean stdout
+* [ ] This does not fit other templates
+
+---
+
+## 🤝 Contribution (Optional)
+
+* [ ] I can work on this
+* [ ] I need guidance
+* [ ] Just reporting
+
+---
+
+## 🧠 Final Note
+
+This project is evolving into a **multi-agent system platform**.
+
+Issues like this help improve:
+
+* coordination between agents
+* system reliability
+* shared intelligence
+
+Thanks for contributing 💙