brain-ops

Name: brain-ops
Availability: InStock
Author: assafyavnai

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

Ready to run

npx skills add https://github.com/assafYavnai/ADF-V1 --skill brain-ops-assafyavnai

💬 Prompt for ChatGPT / Claude Chat▼

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.