From fc283406debd2912587b22140d56e19c220f2578 Mon Sep 17 00:00:00 2001
From: Luke The Dev <252071647+iamlukethedev@users.noreply.github.com>
Date: Tue, 17 Mar 2026 23:40:51 -0500
Subject: [PATCH] Create ROADMAP.md

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

diff --git a/ROADMAP.md b/ROADMAP.md
new file mode 100644
index 0000000..4c33d40
--- /dev/null
+++ b/ROADMAP.md
@@ -0,0 +1,33 @@
+# Roadmap
+
+This file captures the near-term direction for Claw3D so outside contributors can find work that aligns with current priorities.
+
+## Now
+
+- Open-source readiness: documentation, support routes, CI, disclosure files, and public-safe defaults.
+- Runtime reliability: making gateway event handling, history reconciliation, and transport-specific recovery more predictable.
+- Office architecture clarity: keeping the office intent layer centralized and reducing ad hoc room-specific behavior.
+
+## Next
+
+- Converge the immersive office and builder stack on a clearer shared model.
+- Replace or fully clear unresolved bundled assets and dependency licensing risks.
+- Improve security posture around Studio access bootstrap and runtime token handling.
+
+## Later
+
+- Broader office authoring workflows and richer world-building tools.
+- Better contributor automation, release process, and publication tooling.
+- More immersive agent/system surfaces that build on the existing office intent and runtime event model.
+
+## Good First Contribution Areas
+
+- Documentation and developer-onboarding fixes.
+- Focused unit-test additions around runtime workflows or office intent behavior.
+- Small UI polish issues that stay inside one feature area.
+- Replacing stale examples, placeholder text, or internal-only assumptions in public docs.
+
+## Before Starting Bigger Work
+
+- Read `README.md`, `CODE_DOCUMENTATION.md`, and `KNOWN_ISSUES.md`.
+- Prefer opening or linking a GitHub issue before large architectural changes.