universal-agent-memory 0.6.1 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-agent-memory",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Universal AI agent memory system - CLAUDE.md templates, memory, worktrees for Claude Code, Factory.AI, VSCode, OpenCode",
   "type": "module",
   "main": "dist/index.js",

package/templates/CLAUDE.template.md

@@ -188,6 +188,56 @@ multi_tool_use.parallel([
 
 ---
 
+## 🧩 MULTI-AGENT EXECUTION (DEPENDENCY-AWARE)
+
+**Goal**: Finish faster by parallelizing independent work while preserving correctness and avoiding conflicts.
+
+**Aggressive parallelization mandate**: Default to multi-agent execution whenever tasks can be safely decomposed; only stay single-threaded when dependencies or overlap risk make parallel work unsafe.
+
+**Process**:
+1. **Decompose** the request into discrete work items with clear inputs/outputs.
+2. **Map dependencies** (A blocks B). Only run B after A is complete.
+3. **Parallelize** dependency-free items with separate agents and explicit file boundaries.
+4. **Gate edits** with `uam agent overlaps --resource "<files>"` before touching any file.
+5. **Merge in dependency order** (upstream first). Rebase or re-run dependent steps if needed.
+
+**When to expand the agent pool**:
+- Multiple files/modules with low coupling
+- Parallel research or analysis tasks
+- Independent test or verification tasks
+
+**Example**:
+```bash
+# Parallel research tasks (dependency-free)
+Task(subagent_type: "security-auditor", prompt: "Threat model: auth flow in src/auth/*")
+Task(subagent_type: "performance-optimizer", prompt: "Find hotspots in src/cache/*")
+
+# Dependent work (sequential)
+# 1) Agent A updates schema → 2) Agent B updates queries → 3) Agent C updates tests
+```
+
+**Conflict avoidance**:
+- One agent per file at a time
+- Declare file ownership in prompts
+- If overlap risk is high, wait or split by section
+
+---
+
+## 🛠️ SKILLFORGE MODE (OPTIONAL)
+
+**Use when**: The request is to create, improve, or compose skills (not regular feature work).
+
+**Phases**:
+0. **Triage** → USE_EXISTING / IMPROVE_EXISTING / CREATE_NEW / COMPOSE
+1. **Deep Analysis** (multi‑lens, edge cases, constraints)
+2. **Specification** (structured skill spec)
+3. **Generation** (implement skill)
+4. **Multi‑Agent Synthesis** (quality + security + evolution approval)
+
+**Fallback**: If SkillForge scripts/requirements are unavailable, use the existing skill routing matrix and create skills manually in `{{SKILLS_PATH}}`.
+
+---
+
 ## 🧾 TOKEN EFFICIENCY RULES
 
 - Prefer concise, high-signal responses; avoid repeating instructions or large logs.
@@ -216,7 +266,7 @@ multi_tool_use.parallel([
 │                                                                  │
 │  4. WORKTREE │ {{WORKTREE_CREATE_CMD}} <slug>                   │
 │              │ cd {{WORKTREE_DIR}}/NNN-<slug>/                  │
-│              │ NEVER commit to {{DEFAULT_BRANCH}}               │
+│              │ NEVER commit directly to {{DEFAULT_BRANCH}}      │
 │                                                                  │
 │  5. WORK     │ Implement → Test → {{WORKTREE_PR_CMD}}           │
 │                                                                  │