monomind 2.7.4 → 2.7.6

package/packages/@monomind/cli/.claude/skills/github-toolkit/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: github-toolkit
+description: >
+  GitHub workflow guidance for monomind projects — issues, PRs, releases,
+  repo structure, and multi-package sync. Trigger on "open a PR", "manage
+  issues", "cut a release", "sync packages", or any GitHub Actions/repo
+  automation request. All GitHub operations use the `gh` CLI plus monomind's
+  MCP GitHub tools — there is no `monomind github` CLI command group.
+---
+
+# GitHub Toolkit
+
+Guidance for GitHub-integrated workflows in monomind projects. All GitHub
+operations go through the `gh` CLI directly (for PRs, issues, releases) or
+through monomind's MCP GitHub tools when running inside a swarm.
+
+## Core operations
+
+- **Issues** — triage, label, and track via `gh issue` or `mcp__monomind__github_issue_track`.
+  See `.claude/commands/github/issue-tracker.md`.
+- **Pull requests** — create, review, and merge via `gh pr` or `mcp__monomind__github_pr_manage`.
+  See `.claude/commands/github/pr-manager.md`.
+- **Releases** — version bump, changelog, tag, and publish coordination.
+  See `.claude/commands/github/release-manager.md`.
+- **Repo structure** — multi-repo layout and package boundary decisions.
+  See `.claude/commands/github/repo-architect.md`.
+- **Multi-package sync** — version alignment and dependency sync across a monorepo.
+  See `.claude/commands/github/sync-coordinator.md`.
+- **Integration modes overview** — which mode to use for which workflow.
+  See `.claude/commands/github/github-modes.md`.
+
+## Quick reference
+
+```bash
+# Issues
+gh issue list --state open
+gh issue create --title "..." --body "..."
+
+# Pull requests
+gh pr create --title "..." --body "..."
+gh pr view <number> --json reviews,statusCheckRollup
+
+# Releases
+gh release create v1.2.3 --generate-notes
+```
+
+## MCP tools (when running inside a swarm)
+
+```javascript
+mcp__monomind__github_pr_manage({ action: "review", pr: 123 })
+mcp__monomind__github_issue_track({ action: "list", state: "open" })
+mcp__monomind__github_metrics({ repo: "owner/repo" })
+```
+
+## When to reach for the full docs
+
+Each linked command file under `.claude/commands/github/` has the complete
+option/flag reference and swarm-coordination patterns for its area — read
+the relevant one before doing multi-step GitHub automation (e.g. spawning
+a `pr-manager` or `release-manager` agent).

package/packages/@monomind/cli/.claude/skills/memory-toolkit/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: memory-toolkit
+description: >
+  Use monomind's persistent memory store (LanceDB + pure-JS HNSW) to save,
+  search, list, and retrieve cross-session knowledge — patterns, solutions,
+  decisions. Trigger on "remember this", "store in memory", "search memory",
+  "have we solved this before", "recall past decisions", or before starting
+  work that benefits from prior context (debugging, refactors, repeated tasks).
+---
+
+# Memory Toolkit
+
+Monomind ships a persistent, namespaced memory store backed by LanceDB with
+a pure-JS HNSW index for approximate nearest-neighbor vector search. Use it
+to avoid re-solving the same problem twice across sessions.
+
+## Before starting non-trivial work
+
+Search for prior art first:
+
+```bash
+npx monomind memory search --query "[task keywords]" --namespace patterns
+npx monomind memory search --query "[task keywords]" --namespace solutions
+```
+
+## Store data
+
+```bash
+# REQUIRED: --key and --value. OPTIONAL: --namespace (default: "default"), --ttl, --tags
+npx monomind memory store --key "pattern-auth" --value "JWT with refresh tokens" --namespace patterns
+npx monomind memory store --key "bug-fix-123" --value "Fixed null check in parser" --namespace solutions --tags "bugfix,auth"
+```
+
+## Search data (semantic / keyword / hybrid)
+
+```bash
+# REQUIRED: --query. OPTIONAL: --namespace, --limit, --threshold, --type
+npx monomind memory search --query "authentication patterns"
+npx monomind memory search --query "JWT" --type keyword
+npx monomind memory search --query "error handling" --namespace patterns --limit 5
+```
+
+| Search type | Description                  | Best for                  |
+| ----------- | ----------------------------- | -------------------------- |
+| `semantic`  | Vector similarity search       | Concept / meaning matching |
+| `keyword`   | BM25 full-text search          | Exact term matching        |
+| `hybrid`    | Combined semantic + keyword    | General purpose (default)  |
+
+Use `--build-hnsw` before searching large memory stores (1,000+ entries) —
+it builds a pure-JS HNSW index for O(log n) queries instead of O(n) linear
+scan (one-time build cost).
+
+## List and retrieve
+
+```bash
+npx monomind memory list --namespace patterns --limit 10
+npx monomind memory retrieve --key "pattern-auth" --namespace patterns
+```
+
+## MCP equivalents
+
+```javascript
+mcp__monomind__memory_store({ key: "pattern-auth", value: "...", namespace: "patterns" })
+mcp__monomind__memory_search({ query: "authentication patterns", namespace: "default", limit: 10, threshold: 0.7, type: "hybrid" })
+```
+
+## After completing non-trivial work
+
+Store what worked so the next session (or agent) doesn't start from zero:
+
+```bash
+npx monomind memory store --key "[short-name]" --value "[what worked and why]" --namespace patterns
+```
+
+See also: `.claude/commands/memory/memory-search.md` for the full flag reference.