@plumpslabs/kuma 2.3.27 → 2.3.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +2 -2
  2. package/dist/index.js +838 -409
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -173,12 +173,12 @@ Not all recordings are equal. Kuma categorizes actions by their long-term impact
173
173
 
174
174
  | Tier | Actions | Impact | Why |
175
175
  |------|---------|--------|-----|
176
- | 🔥 **Exponential** | `arch_flow` + `gotcha` | **Each record saves 5-10 files next session** | Architecture flows multiply: 10 flow hops = agent skips 50-100 files. Gotchas prevent re-discovery of bugs. |
176
+ | 🔥 **Exponential** | `arch_flow` + `gotcha` | **High signal architecture & bug shield** | Complete architecture flows (max 5 core files) save massive file-reading next session. Gotchas prevent bug re-discovery. |
177
177
  | 🟡 **Linear** | `decision` + `research_save` | **Useful but not multiplicative** | Decisions preserve rationale context. Research saves create searchable cache. |
178
178
  | 🟢 **SKIP** | Function/class/component nodes | **Not worth MCP call — grep is faster** | Use `grep funcName(`, `grep class ClassName`, `glob **/*Component*` instead |
179
179
 
180
180
  **Rule of thumb:**
181
- - **ALWAYS record** `arch_flow` + `gotcha` inline — they're the highest-value actions
181
+ - **Record `arch_flow`** after tracing a complete flow (max 5 core files) & **`gotcha`** inline when bugs are found
182
182
  - **Record** `decision` + `research_save` when relevant
183
183
  - **NEVER record** function/class/component nodes via MCP — native grep is faster
184
184
  - Let the auto-scanner handle structural nodes during research step 3