skills.rest
assafYavnai
assafYavnaiCOMMUNITY
Explore all skills by this author →
GitHub

brain-ops

Perform deterministic Brain-backed memory read, search, capture, and trust-state operations.

Updated Mar 26, 2026
Search Tags:#mcp#repository#memory#deterministic#command-line#fallback#brain
One-click install
npx skills add https://github.com/assafYavnai/ADF-V1 --skill brain-ops-assafyavnai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brain-ops
Source: https://github.com/assafYavnai/ADF-V1/tree/main/skills/brain-ops
Command: npx skills add https://github.com/assafYavnai/ADF-V1 --skill brain-ops-assafyavnai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires governed-feature-runtime.mjs, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Brain Ops enables deterministic Brain-backed operations for memory management, including read, search, capture, and trust-state changes, with a preferred MCP route and a reproducible repo fallback.

Core Features & Use Cases

  • Deterministic memory search, read, and capture using the Brain client.
  • Trust-state management for memory entries (promote / cleanup) with guardrails.
  • Fallback to a repo-based COO Brain client when MCP is unavailable, ensuring reproducible shell-based proofs.

Quick Start

Run a deterministic Brain operation from the repo using the helper, e.g., node skills/brain-ops/scripts/brain-ops-helper.mjs search --project-root <repo> --scope <scope> --query <query>.

Frequently Asked Questions about brain-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform deterministic memory operations when the assistant MCP is unavailable?▼

Deterministic memory operations use a repository-backed Brain client with guardrails to prevent direct database access. The system enforces trust-state management and requires a valid runtime client to produce reproducible results.

How do I search repository memory from the command line?▼

Search repository memory from the command line by executing the helper script with project-root, scope, and query arguments. This triggers a deterministic Brain-backed search using the repo fallback client.

Can I manage the trust state of memory entries using a repo-based Brain client?▼

Yes, trust-state management for memory entries is supported via the repo-based Brain client. You can execute promote and cleanup actions while the system enforces guardrails to ensure safe, deterministic trust-state transitions.

What guardrails exist for memory capture and read operations?▼

Memory capture and read operations are protected by guardrails that prevent direct database access and mandate a valid runtime Brain client. This architecture ensures all memory interactions remain deterministic and reproducible.

Do I need a specific runtime environment to execute reproducible Brain memory searches?▼

Yes, executing reproducible Brain memory searches requires a valid runtime Brain client and the governed-feature-runtime dependency. This setup enforces the guardrails necessary to guarantee deterministic outcomes during fallback operations.

Related Skills

Explore More Software Engineering Skills→
featbitfeatbit
11

featbit-java-sdk

Integrate FeatBit feature flags into Java server applications with OpenFeature support.

Official
Advanced
verygoodpluginsverygoodplugins
63

memory-management

Store and recall project context, decisions, and coding patterns across sessions.

Official
Intermediate
ballredballred
1.7k

obsidian-vault-ops

Read and write Obsidian vault notes while preserving YAML frontmatter and wiki-links.

Community
Basic
Spectra29115Spectra29115

query-integration-data

Query and modify data across integration platforms and data warehouses via SDKs and APIs.

Community
Advanced