Source of Truth (.agents/)
16 nodes
The single canonical store for all shared agent configuration and content stores — rules, skills, command-permission policy, buffer, friction log. Everything is authored here exactly once.
3b system
3B System
A sanitized, public view of 3B (Brandon's Binary Brain) — the agent harness behind this site. It is generated from the architecture model and shows the layers, subsystems, decision history, and blog series. It is not a mirror of the source: private content, paths, and session data are excluded by design.
overview · 12
- Layers
- 6
- Architecture nodes
- 95
- Architecture edges
- 138
- Documented flows
- 8
- Blog series posts
- 10
- ADRs
- 107
- Rule files
- 1
- Skills
- 98
- Knowledge entries
- 1892
- Knowledge categories
- 15
- Agent runtimes
- 3
- Graph validation (dangling / orphan / invalid)
- 0 / 2 / 0
architecture map
Loading interactive graph…
- 1.Source of Truth (.agents/)16 nodesThe single canonical store for all shared agent configuration and content stores — rules, skills, command-permission policy, buffer, friction log. Everything is authored here exactly once.
- 2.Generators + Cross-Agent Sync17 nodesNode generators that read frontmatter-gated SoT inputs and project them into per-agent profiles, permission files, and ignore lists; pre-commit/CI drift gates keep targets consistent.
- 3.Symlink Mounts + Agent Runtimes10 nodesCompatibility back-symlinks/hardlinks that resolve the SoT at each CLI's hardcoded mount, plus the four agent runtimes (Claude Code, Codex CLI, AGY, Grok Build) and the generated docs they load. Grok's surface is ~/.grok/rules/, not AGENTS.md.
- 4.Content + Knowledge Lifecycle16 nodesThe Zettelkasten knowledge base and the six-layer progressive-refinement pipeline that promotes ephemeral session work upward to durable, publishable entries.
- 5.Governance, HITL + Self-Improvement8 nodesThe three-gate HITL/audit ladder, the immutable decision (ADR) registry, and the friction lifecycle that turns one-off mistakes into governed, measured fixes.
- 6.Tooling + MCP10 nodesThe external code-intelligence and doc-conversion stack (graphify, code-review-graph, opt-in Serena, context-mode) plus model-tier routing and the asdf/brew runtime contract.
layers · 6 · 77 nodes
Generators + Cross-Agent Sync
17 nodes
Node generators that read frontmatter-gated SoT inputs and project them into per-agent profiles, permission files, and ignore lists; pre-commit/CI drift gates keep targets consistent.
Symlink Mounts + Agent Runtimes
10 nodes
Compatibility back-symlinks/hardlinks that resolve the SoT at each CLI's hardcoded mount, plus the four agent runtimes (Claude Code, Codex CLI, AGY, Grok Build) and the generated docs they load. Grok's surface is ~/.grok/rules/, not AGENTS.md.
Content + Knowledge Lifecycle
16 nodes
The Zettelkasten knowledge base and the six-layer progressive-refinement pipeline that promotes ephemeral session work upward to durable, publishable entries.
Governance, HITL + Self-Improvement
8 nodes
The three-gate HITL/audit ladder, the immutable decision (ADR) registry, and the friction lifecycle that turns one-off mistakes into governed, measured fixes.
Tooling + MCP
10 nodes
The external code-intelligence and doc-conversion stack (graphify, code-review-graph, opt-in Serena, context-mode) plus model-tier routing and the asdf/brew runtime contract.
subsystems · 11
Rules Engine + Routing
Frontmatter-gated rule files decide what loads — always-on vs lazy — per agent.
Skills System
Markdown-defined skills, signal-routed for Claude and mirrored to the other agents.
Cross-Agent SoT + Sync Engine
One canonical config store; a generator projects every edit into each agent profile.
Zettelkasten Knowledge Base
[reads private 3B data]An atomic, forward-linked Zettelkasten knowledge base — backlinks computed, never stored.
Information Layer + Progressive Refinement
A folder-as-destiny pipeline that refines content through progressive layers.
Journal Rollup + Wrap Workflow
[reads private 3B data]A session engine: buffer to wrap to daily journal to knowledge, with clean-slate rollups.
Projects + Task Lifecycle + Worktrees
[reads private 3B data]Task setup gates work into isolated worktrees with explicit ownership and locks.
Governance, HITL Gates + Audit
A three-gate human-in-the-loop ladder governing every architecture-changing action.
Decision System (ADRs + Rule-6 READMEs)
An immutable ADR registry plus a per-folder decision-doc convention.
Friction Lifecycle
[reads private 3B data]Captured friction accumulates into scored patterns and graduates into governed fixes.
MCP + Graph + Runtime Tooling
A layered code-intelligence and doc-ingestion stack, each layer owning one waste vector.
decision history · 107
- 2026-10-20ADR-105Grok Bot reaches Mac T3 Code over Tailscale Serve
- 2026-10-19ADR-101Grok Bot precedence: skill files grant no approval
- 2026-10-19ADR-102Worktree Root and Lifecycle Ownership
- 2026-10-19ADR-103Worktree Checkpoint Model for 3B Writes
- 2026-10-19ADR-104Session identity resolves through one vendor table and fails closed
- 2026-10-18ADR-098Checkpoint Records and Write Claims
- 2026-10-18ADR-099A2A Message Profile for Step Responses
- 2026-10-18ADR-100The advisor settles only spec-delegated two-way decisions
- 2026-10-16ADR-097Cloud Session Guardrail Hooks
- 2026-10-14ADR-096Linux host support for
- 2026-10-11ADR-092Post-Implementation E2E Verification Only — TDD and Test Prescriptions Retired
- 2026-10-11ADR-093Retain session task ownership through recovery
- 2026-10-11ADR-094Decide in the specification; execute within its bounds
- 2026-10-11ADR-095Replace the Ouroboros planning layer with vendored grill skills
- 2026-10-09ADR-091Deny-Not-Ask Command Permission Policy
- 2026-10-08ADR-090Per-Session Worktree Isolation for Concurrent 3B Writes
- 2026-10-04ADR-089Retire the Authority Gate (Gate B) Completely
- 2026-10-02ADR-088Claudex Settings Retirement
- 2026-09-30ADR-087AGY Permission Gate Enforces Gap Rows as Deny-Not-Prompt
- 2026-09-29ADR-086Musk Algorithm Operating Loop — Reversibility Line, Contract, Gate B Reduction
- 2026-09-26ADR-085Claude Subagent Preset Router — Deny Floor Plus Rewrite Hook
- 2026-09-25ADR-084Multi-Session Concurrency Contract
- 2026-09-14ADR-083One Shell-Command Rewriter per Tool per Vendor
- 2026-09-11ADR-081Retire the Native Mount
- 2026-09-11ADR-082Vendor Namespace Isolation
- 2026-09-07ADR-078PostgreSQL MCP Idle Startup and Explicit Database Targets
- 2026-09-07ADR-079Coordinated Cross-Vendor Prompt Contract
- 2026-09-07ADR-080Remote MCP Servers in the Per-Repository Capability Manifest
- 2026-09-04ADR-077Per-Repository Cross-Agent Capability Manifest
- 2026-09-02ADR-075Single Claude profile — plain is the launcher; / retired
- 2026-09-01ADR-074Retire the claude-hud version pin; customize by config, not by patching source
- 2026-09-01ADR-075Enforce Read-Only AWS CLI Access with an Allowlist Guard
- 2026-09-01ADR-076Mount the Shared Work Docs Tree at
- 2026-08-25ADR-073Guard Cross-Tree Instruction Loads with a PreToolUse Hook
- 2026-08-21ADR-072Reject the Read-Deny Guard
- 2026-08-19ADR-071Exa-primary web search via a router CLI, not MCP servers
- 2026-08-17ADR-070Vendor Propagation Layer under Separation of Concerns
- 2026-08-15ADR-069Grok Serena client via a mirrored GROK_HOME
- 2026-08-13ADR-068Retire Active-System State While Preserving Private History
- 2026-08-08ADR-067Context-Mode Per-Repo Store Sharding Governs All Three Agents
- 2026-08-02ADR-065Blog Content-Integrity Gates (G1 Generalization, G2 References)
- 2026-08-02ADR-066Dotted Neutral SSoT Root
- 2026-07-26ADR-064Repo-Local Worktree Root
- 2026-07-24ADR-063Track Codex Desired Configuration Separately from Live Runtime State
- 2026-07-20ADR-062Handoff Lock V2 Root-Session Leases
- 2026-07-19ADR-061External Worktree Root
- 2026-07-12ADR-060Model Routing Ladder
- 2026-07-10ADR-059Agent Conductor Dispatch Policy
- 2026-07-09ADR-058Gate B Audit-Trail Durability
- 2026-07-04ADR-057Direct Two-Axis Status Taxonomy
- 2026-06-30ADR-056Evidence-Validation Doctrine + Reviewer-Loop Escalation + →
- 2026-06-29ADR-055LangGraph + LangSmith Three-Plane Agent Architecture
- 2026-06-29ADR-055WorktreeCreate Hook — Native Worktree Path Convergence
- 2026-06-28ADR-054Canonical-Main Release Rail
- 2026-06-27ADR-052SkillOps Subsystem
- 2026-06-27ADR-053Publishing Pipeline — Two-Lane, Campaign-First
- 2026-06-25ADR-051Data-Layer Tooling Selection Rationale
- 2026-06-21ADR-050step-handoff — upstream gate-signal carry (supersedes )
- 2026-06-20ADR-049step-check spell-status vocabulary + interactive convergence
- 2026-06-19ADR-048Codex full-access runtime as the 3B-managed default
- 2026-06-11ADR-047Serena On-Demand Per-Workspace Daemons
- 2026-06-09ADR-044Permissions Governance — Catastrophic-Deny Floor + Deny SoT Migration
- 2026-06-09ADR-046Verifier-Hook Identity — Per-Agent Hook Wrapper
- 2026-06-07ADR-045Custom Output Style
- 2026-06-05ADR-043Three Workflow Models for /3b:handoff + /3b:check
- 2026-06-02ADR-042Frontmatter-Driven AGY Skill Adapter Projection
- 2026-06-01ADR-041Forced-Read RAG Data Layer + QMD Retriever Reinstatement
- 2026-05-30ADR-039Universal-Rule Native-Load Suppression (sentinel )
- 2026-05-30ADR-040F2 Agent-Managed Memory Layer
- 2026-05-29ADR-038Two-Layer Commit Discipline
- 2026-05-27ADR-036Untrack (worktree project-name collision under the shared daemon)
- 2026-05-27ADR-037Cross-Agent SSoT (Codex network + per-repo escalation)
- 2026-05-23ADR-035Flat Worktree Paths (Drop Agent Namespace)
- 2026-05-22ADR-033AGY Migration — Replace Gemini CLI with Antigravity CLI
- 2026-05-22ADR-034Close Emit vs Lint Reformat Drift Loop
- 2026-05-20ADR-032Migrate to + Plus Visual-Header + Strict-GO
- 2026-05-18ADR-031Gates A+B Concurrency + HITL Protocols
- 2026-05-15ADR-0303B Layered Self-Improvement Architecture
- 2026-05-11ADR-029Information-Layer Schema Additive (aliases + privacy + source_type)
- 2026-05-06ADR-027Per-Agent Content Filtering Convention (v0.1.0 → v0.2.0)
- 2026-05-06ADR-028Initiative #51 (3B-redesign) Closure
- 2026-05-03ADR-024D2 Concurrency — carry-forward + advisory lock
- 2026-05-03ADR-025Custom Cache Keepalive (Claude Code)
- 2026-05-03ADR-026Cross-Agent Worktree Directory Strategy
- 2026-05-02ADR-022Gemini Phase 3 Completion — Cross-Agent SoT Propagation
- 2026-05-02ADR-023wrap Cross-Agent Generalization
- 2026-05-01ADR-021Serena MCP — switch from per-session stdio to shared streamable-http daemon
- 2026-04-30ADR-0203B Partial-Tracking Policy — Memories In, Cache Out
- 2026-04-29ADR-019Graph-Tool Integration — + Hook Architecture
- 2026-04-28ADR-016Cross-Agent Command Permission Policy
- 2026-04-28ADR-017claude-mem Definitive Removal (Attempt #3) After Silent Billing Leak
- 2026-04-28ADR-018Codex Skill Discovery Boundary
- 2026-04-27ADR-014Cross-Agent SoT Folder
- 2026-04-27ADR-015Codex Broader Cross-Agent Sharing — Routing + Generator
- 2026-04-21ADR-013Pin claude-hud to v0.0.12 with three-defense pattern
- 2026-04-18ADR-011Retire Storm Brainstorm Engine
- 2026-04-18ADR-012Per-project Claude rules live in 3B subdirectory, symlinked
- 2026-04-17ADR-009Retire Agent Teams + Restore Symlink to SoT
- 2026-04-17ADR-010Retirement of Pattern A (Forge Theme Saturation) in favor of Apply-over-Shelve
- 2026-04-09ADR-008Re-enable RTK Hook with exclude_commands Defense
- 2026-04-08ADR-006Storm Brainstorm Engine
- 2026-04-08ADR-007Merge claude-forge into as 3B Project Workspace
- 2026-03-29ADR-005Remove QMD Global MCP Server
- 2026-03-21ADR-004Remove RTK PreToolUse Hook
- 2026-03-12ADR-003Empty deny list — all dangerous commands in ask
- 2026-02-19ADR-002Regex-Based PermissionRequest Hook Over API Calls
- 2026-02-12ADR-001Friction Feedback Loop for Claude Configuration
blog series
10 of 10 published
- 01. One Folder, Three Agents: The .agents/ Source of Truthpublished
- 02. Rules That Route Themselves: Frontmatter as the Loaderpublished
- 03. Same Skill, Three Transport Physicspublished
- 04. Forward Links Only: A Zettelkasten Where Backlinks Are Computedpublished
- 05. Folder Is Destiny: A Six-Layer Information Lifecyclepublished
- 06. The Session Engine: /wrap, Clean-Slate Rollups, and a Cross-Session Bufferpublished
- 07. Parallel Agents Without Collisions: Tasks, Worktrees, and Lockspublished
- 08. Three Gates and an Audit Log: HITL for an Agent Harnesspublished
- 09. A Harness That Fixes Itself — And Prunes Its Own Fixespublished
- 10. The Token Stack: Four Layers of Code Intelligence Without Re-Scanningpublished
snapshot
- model generated
- 2026-08-18
- snapshot built
- 2026-10-19T19:50:41.713Z
Generated from the 3B architecture model. Sanitized — it contains no private files, paths, or session data.