From ffe1d1fa37534e4eaa46b30111a8e87c136d8b6c Mon Sep 17 00:00:00 2001
From: Alexandre Ramos <78726166+Alexsantossp71@users.noreply.github.com>
Date: Sat, 8 Aug 2026 11:48:11 -0300
Subject: [PATCH] docs: add public roadmap with feature voting (#4)

---
 ROADMAP.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 ROADMAP.md

diff --git a/ROADMAP.md b/ROADMAP.md
new file mode 100644
index 0000000..9c321cf
--- /dev/null
+++ b/ROADMAP.md
@@ -0,0 +1,54 @@
+# 🗺️ PythonClaw — Public Roadmap
+
+> This is the public roadmap for PythonClaw. **👍 the items you want most**, or comment with ideas — feedback directly shapes priority.
+> 
+> Related: [#4 — Roadmap & Feature Voting](https://github.com/ericwang915/PythonClaw/issues/4)
+
+---
+
+## 🎯 Near-term (v0.8)
+
+| # | Feature | Description | Status |
+|---|---------|-------------|--------|
+| 1 | **MCP client support** | Connect any [Model Context Protocol](https://modelcontextprotocol.io/) server and instantly gain thousands of tools | 📋 Planned |
+| 2 | **Local Whisper STT** | Offline voice input as an alternative to Deepgram | 📋 Planned |
+| 3 | **Published Docker image on GHCR** | `docker run ghcr.io/ericwang915/pythonclaw` | 📋 Planned |
+| 4 | **Proactive agent** | Wire up the heartbeat loop so the agent can reach out on a schedule / on triggers | 📋 Planned |
+| 5 | **One-click deploy templates** | Railway / Fly.io / Render templates | 📋 Planned |
+| 6 | **Slack channel** | Add Slack as a messaging channel | 📋 Planned |
+| 7 | **Streaming responses on Discord & WhatsApp** | Telegram/Web already stream — extend to all channels | 📋 Planned |
+| 8 | **Sub-agent spawning** | Parallel task decomposition via sub-agents | 📋 Planned |
+| 9 | **Vision model routing** | Auto-pick a multimodal model when an image is attached | 📋 Planned |
+| 10 | **Structured tool-result caching** | Cache tool results across turns for efficiency | 📋 Planned |
+
+---
+
+## 🛠️ Skills
+
+| # | Feature | Description | Status |
+|---|---------|-------------|--------|
+| 1 | **Local skill scaffolding CLI** | `pythonclaw skill new` — generate skill boilerplate locally | 📋 Planned |
+| 2 | **Skill sandboxing hardening** | Improve isolation and security for installed skills | 📋 Planned |
+
+---
+
+## 📚 Docs & Developer Experience
+
+| # | Feature | Description | Status |
+|---|---------|-------------|--------|
+| 1 | **Demo GIF + short video walkthrough** | Visual walkthrough of core features | 📋 Planned |
+| 2 | **Architecture deep-dive doc** | Detailed technical documentation of the architecture | 📋 Planned |
+
+---
+
+## 🗳️ How to Vote
+
+- **React with 👍** on the comment for each feature you want most
+- **Comment** with new ideas or use cases
+- Feedback directly shapes development priority
+
+---
+
+## 🤝 Want to Contribute?
+
+Check out issues tagged [`good first issue`](https://github.com/ericwang915/PythonClaw/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.