@plumpslabs/kuma 2.4.3 → 2.4.5

package/plugin.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "kuma",
+  "version": "2.4.5",
+  "description": "Safety-first context & orchestration engine for AI coding agents. Shadow memory, gotcha lifecycle, blast radius impact analysis, and test verification.",
+  "author": {
+    "name": "plumpslabs",
+    "url": "https://github.com/plumpslabs"
+  },
+  "license": "MIT",
+  "skills": [
+    {
+      "name": "kuma-mcp",
+      "description": "Kuma MCP — safety toolkit for AI coding agents",
+      "file": "skills/kuma/SKILL.md"
+    }
+  ],
+  "commands": [
+    {
+      "name": "kuma:init",
+      "description": "Initialize Kuma session context, lean brief (<500 tokens), and branch tracking",
+      "file": "commands/kuma:init.md"
+    },
+    {
+      "name": "kuma:research",
+      "description": "Run 5-step research pipeline before editing unfamiliar code",
+      "file": "commands/kuma:research.md"
+    },
+    {
+      "name": "kuma:impact",
+      "description": "Calculate blast radius, affected consumers, and safety risk score",
+      "file": "commands/kuma:impact.md"
+    },
+    {
+      "name": "kuma:guard",
+      "description": "Pre-flight safety check against anti-patterns, drift, and circular deps",
+      "file": "commands/kuma:guard.md"
+    },
+    {
+      "name": "kuma:verify",
+      "description": "Post-edit scoped test verification and validation",
+      "file": "commands/kuma:verify.md"
+    },
+    {
+      "name": "kuma:checkpoint",
+      "description": "Create an atomic named snapshot before risky work",
+      "file": "commands/kuma:checkpoint.md"
+    },
+    {
+      "name": "kuma:rollback",
+      "description": "Restore codebase from a labeled checkpoint snapshot",
+      "file": "commands/kuma:rollback.md"
+    },
+    {
+      "name": "kuma:studio",
+      "description": "Launch or view Kuma Studio web dashboard",
+      "file": "commands/kuma:studio.md"
+    }
+  ]
+}

package/skills/kuma/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: kuma-mcp
+description: Kuma MCP — safety toolkit for AI coding agents
+---
+
+Kuma MCP tools: kuma_context, kuma_memory, kuma_safety.
+Record what matters, skip what doesn't.
+
+<kuma_obedience>
+## 🔒 Obedience (non-negotiable)
+- MUST call `kuma_context({ action: "init" })` at session start.
+- MUST check blast radius `kuma_context({ action: "impact", target: "<file>" })` before touching core/shared modules.
+- MUST record gotchas IMMEDIATELY when a bug/quirk is found.
+- MUST call `kuma_safety({ action: "verify" })` after edits.
+- MUST NOT call actions outside the 15 core actions.
+</kuma_obedience>
+
+<kuma_workflow>
+🧠 **Before coding:** `kuma_context({ action: "init" })`
+🗺️ **Monorepo map:** `kuma_context({ action: "map" })`
+🔬 **Unfamiliar code / blast radius:** `kuma_context({ action: "research", scope: "<area>" })` or `kuma_context({ action: "impact", target: "<file>" })`
+🐛 **Found a bug/quirk:** `kuma_memory({ action: "gotcha" })` (IMMEDIATELY)
+🧭 **Chose between options:** `kuma_memory({ action: "decision" })`
+🔀 **Traced a flow:** `kuma_memory({ action: "arch_flow" })` (max 5 files)
+🛡️ **Before risky work / after edits:** `kuma_safety({ action: "guard" | "verify" })`
+</kuma_workflow>
+
+📖 Full rules: `.kuma/init.md`