diff --git a/test-ruflo-smoke.mjs.md b/test-ruflo-smoke.mjs.md
new file mode 100644
index 00000000..b0eb3019
--- /dev/null
+++ b/test-ruflo-smoke.mjs.md
@@ -0,0 +1,41 @@
+# Ruflo-inspired Systems Smoke Test
+
+This test validates all Ruflo-inspired features ported to zCode:
+
+## Plugin System
+- PluginManager lifecycle (load, unload, invoke extension points)
+- PluginLoader dependency resolution
+- BasePlugin with initialization hooks
+
+## Hook System
+- Pre/post tool hooks
+- Pre/post AI hooks
+- Session lifecycle hooks
+
+## Agent System
+- Agent creation with capabilities
+- Task creation with priorities and dependencies
+- Agent status tracking
+- Task execution lifecycle
+
+## Swarm Coordinator
+- Agent spawning and termination
+- Task distribution across agents
+- Multi-agent execution
+- Swarm state tracking
+
+## Agent Orchestrator
+- Agent type-based execution
+- Multi-agent workflow execution
+
+## Memory Backend
+- JSONBackend with LRU eviction
+- InMemoryBackend with TTL
+- Typed memory storage (fact, pattern, lesson)
+
+## Run
+```bash
+node test-ruflo-smoke.mjs
+```
+
+Expected: All 53 assertions pass.