akshay-na/brain-memory-kb
ai/cursor-content-team/skills/brain-memory-kb/SKILL.md
Unified ai-brain skill combining memory operations and KB query operations with promotion flow.
$ install --global
skillsauthnpx skillsauth add akshay-na/dotfiles brain-memory-kbInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 11, 2026, 3:33 AM202.4s1 file scanned
SKILL.md
- name:
- brain-memory-kb
- description:
- Unified ai-brain skill combining memory operations and KB query operations with promotion flow.
- version:
- 1
Brain Memory KB
Unified interface for integrated ~/ai-brain/ operations.
Modes
memorymode:- read/write/update/supersede memory entities
- maintain compact orchestration context
kb-querymode:- index-first KB lookup
- escalate depth only when needed
promotemode:- promote high-value memory entries into durable KB nodes
- set memory source pointer/superseded state
Default Policy
- Memory behaves like RAM (short-lived, operational, compact).
- KB behaves like HDD (durable, canonical, reusable).
- Query ladder: L0/L1 default, L2/L3 on explicit escalation.
Operator profile
~/ai-brain/org/global/operator-profile/— see_templates/operator-profile.md; PII vs secrets perbrain-conventions.mdc.
Promotion Triggers
Promote when item is:
- reused across runs
- used by multiple entrypoint agents
- repeatedly queried during orchestration
- stable decision/constraint/risk/principle
Compatibility
- Canonical interface is
brain-memory-kb.
Entrypoint rhythm (orchestrators)
When brain-conventions.mdc → Entrypoint + decision agents — KB duty applies: lookup first, then one bounded write per checkpoint; git pull --rebase on the brain clone before first write; commit/push per signing rules after. See kb-identity / project-identity for per-repo projects/<slug>/.
~/ai-brain git commits: subject from <short-hostname> + agent one Co-authored-by: trailer per brain-conventions.mdc items 6–7; hostname -s (or fallbacks). No DotMate commit-msg hook on brain clone.
Git-backed vault sync (~/ai-brain optional git repo)
Layouts: (a) ~/ai-brain is a git clone; (b) no .git — local-only vault. Do not git init on machines meant to stay local-only. If the git root is ~/.cursor/ai-brain, use that path in -C instead of $HOME/ai-brain per brain-conventions.mdc.
-
Detect:
git -C "$HOME/ai-brain" rev-parse --git-dir(or~/.cursor/ai-brain) succeeds and work tree matches that root. Else skip sync. -
If repo + changes under allowed paths (not skeleton):
pull --rebase→ path-scopedadd→git commit --no-gpg-sign(message perbrain-conventions.mdc) →push(no--forceto default branch unless break-glass). -
Clean after pull → skip commit/push.
Related Skills
akshay-na/team-discovery
development
VerifiedTrustedCommunity
Discovery + naming convention reference for typed dev/SME/QA/devops team members in any workspace folder. Primary consumer: `tech-lead` (org-tier).
4SKILL.mdUpdated May 28, 2026
akshay-na/task-orchestration
devops
VerifiedTrustedCommunity
Automated task classification, agent selection, and state tracking. Use when routing tasks to agents, selecting pipelines, or managing task state.
4SKILL.mdUpdated May 28, 2026
akshay-na/systems-design-depth
testing
VerifiedTrustedCommunity
Use when designing scalable systems, evaluating consistency models, planning state management, making architectural decisions, or when trade-offs around coupling, failure isolation, and reversibility need explicit reasoning before implementation.
4SKILL.mdUpdated May 28, 2026
akshay-na/swarm-task-decomposition
tools
VerifiedTrustedCommunity
CTO/tech-lead helper — split work into disjoint shard briefs with caps (instance_cap, partition_basis, determinism keys).
4SKILL.mdUpdated May 28, 2026