neuron-fs-brain

NeuronFS Brain Governance

This skill implements NeuronFS-style brain governance for {{AGENT_NAME}}, treating the filesystem as a constraint engine where folder structure and special tokens force AI behavior.

Overview

NeuronFS (Neuron Filesystem) is a governance pattern where:

• Folders = Constraints — Directory structure defines rules
• Files = Rules — .neuron files contain rule definitions
• Naming = Enforcement — Special prefixes trigger behavior

Key Concepts

The vorq Harness

vorq = "value-or-lookup" — When the AI encounters an unknown governance token, it MUST look up the definition before proceeding.

Example:

禁console_log 必vorq

This means: "The token 禁console_log requires lookup before any action involving console.log"

The 禁 Micro-Opcode

禁 (Chinese character for "forbid") = NEVER_DO directive

• Single Chinese character carries 8 characters of meaning
• Forces AI to recognize forbidden patterns instantly
• Example: 禁secrets → "NEVER do this: hardcoded secrets"

7-Layer Subsumption

The brain is organized in 7 layers with strict priority:

Priority	Layer	Purpose
1 (HIGHEST)	P0-brainstem	Survival, safety, NEVER-DO rules
2	P1-limbic	Values, tone, emotional constraints
3	P2-hippocampus	Memory patterns, context
4	P3-sensors	Tool routing, platform hints
5	P4-cortex	Skills, workflows, learning
6	P5-ego	Identity, personality
7 (LOWEST)	P6-prefrontal	Strategy, planning

Critical: P0 rules OVERRIDE all other layers. The brainstem doesn't negotiate.

Brain Structure

~/.{{AGENT_NAME_LOWER}}/brain/<name>/
├── P0-brainstem/           # CRITICAL: never-do rules
│   ├── 禁/                # Forbidden pattern subdirectories
│   │   ├── secrets_in_code/
│   │   │   └── rule.neuron
│   │   └── rm_rf_root/
│   │       └── rule.neuron
│   ├── bomb.neuron        # Kill switches for entire layers
│   └── imperatives.neuron # Must-do rules
├── P1-limbic/            # Values and style
│   └── values.neuron
├── P2-hippocampus/       # Memory constraints
│   └── memory.neuron
├── P3-sensors/           # Tool routing
│   └── routing.neuron
├── P4-cortex/            # Patterns and skills
│   ├── patterns.neuron
│   └── workflows.neuron
├── P5-ego/               # Identity
│   └── identity.neuron
└── P6-prefrontal/         # Strategy
    └── strategy.neuron