roadmap

CONTRIBUTING.md

@@ -6,6 +6,9 @@ We chose a lean and minimal approach to make development on this project as simp
 - Infra is handled by a single Ansible playbook
 - The CLI and API are implemented respectively with Typer and FastAPI in Python, for simplicity. They both wrap over the same `core` module. 
 
+## Project Direction
+
+Check out the [ROADMAP.md](ROADMAP.md) to see planned features, current priorities, and long-term goals. It's a great starting point if you're looking for areas to contribute!
 
 ## Repo Layout
 - `src/k7/` CLI, core logic, API server

README.md

@@ -85,6 +85,8 @@ Coming Soon
 - 🔍 Cilium FQDN-based DNS resolution to safely whitelist domains, not just IP blocks
 - ⚙️ Support other VMM such as Qemu for GPU workloads
 
+📋 **See [ROADMAP.md](ROADMAP.md) for the complete feature roadmap and project priorities.**
+
 
 <p align="left" style="margin-top: 40px;  font-size: 14px;">
    <strong>Note:</strong> Katakate is currently in <em>beta</em> and under security review. Use with caution for highly sensitive workloads.

ROADMAP.md

@@ -0,0 +1,62 @@
+# 🗺️ Project Roadmap
+
+This document outlines the upcoming milestones, goals, and long-term vision for **K7**.  
+It helps contributors and users understand where the project is heading.
+
+---
+
+## 🚀 Current Focus
+
+Core stability and foundational runtime improvements.
+
+- [ ] Add `--disk` argument to `k7 install` to specify external disk path explicitly for thin pool provisioning, and test it  
+- [ ] Test if removing DNS resolution completely doesn't break functionality (to protect against DNS exfiltration)
+- [ ] Add pause/resume support for sandboxes 
+- [ ] Fix jailer functionality (known issue)
+- [ ] Add multi-node support (currently single K3s node supported) 
+
+
+
+---
+
+## 🧩 Next Goals
+
+Broader compatibility and container integration.
+
+- [ ] Add ARM support for Linux Debian  
+- [ ] Add Docker build / run / compose capabilities in VM sandboxes (major feature!)
+- [ ] Integrate Cilium networking  
+- [ ] Implement Docker pull deny/whitelist  
+
+---
+
+## ⚙️ Future Work
+
+Cross-platform support and continuous delivery.
+
+- [ ] Add QEMU support (macOS ARM, GPU support)  
+- [ ] Add AppArmor integration  
+- [ ] Add CI/CD and deployment tests  
+
+---
+
+## 🔐 Advanced Features
+
+Security, customization, and extended runtime capabilities.
+
+- [ ] Add TEE (Trusted Execution Environment) support  
+- [ ] Add custom rootfs support (lighter, alternative images)  
+
+---
+
+## 💬 How to Contribute
+
+We welcome ideas and feedback!  
+If you'd like to suggest a feature or help with one listed above:
+1. Open a [Discussion](https://github.com/katakate/k7/discussions) or [Issue](https://github.com/katakate/k7/issues)
+2. Reference the relevant roadmap item
+3. Let's collaborate on the design or implementation
+
+---
+
+📅 *Last updated: October 2025*