diff --git a/CAPABILITIES.md b/CAPABILITIES.md
index 1674ed4..acdf056 100644
--- a/CAPABILITIES.md
+++ b/CAPABILITIES.md
@@ -3,6 +3,8 @@
 Cross-platform VM lifecycle management.
 macOS via Apple Virtualization.framework, Linux via Cloud Hypervisor.
 
+Status: experimental and under active development. This matrix reflects current implementation work, not a maturity or production-readiness guarantee.
+
 ## Platform Support
 
 | Capability | macOS (Apple VZ) | Linux (Cloud Hypervisor) | Notes |
diff --git a/README.md b/README.md
index 7d6f611..92ecbda 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,8 @@
 Cross-platform VM lifecycle management for Rust.
 Boot, stop, and orchestrate lightweight virtual machines on macOS, Linux, and Windows from a single API.
 
+> Status: `vm-rs` is experimental and under active development. Interfaces, capabilities, and platform support may change, and parts of the project are not yet production-ready.
+
 - **macOS**: Apple Virtualization.framework (in-process, via Objective-C FFI)
 - **Linux**: Cloud Hypervisor (separate VMM process, CLI mode)
 - **Windows**: Windows Hypervisor Platform (in-process, same technology as WSL2)