Company Brain Architecture
A reference architecture for shared company intelligence. Signals become knowledge, knowledge becomes capability, and capability compounds across the organization.
Learn once. Improve everyone.
Architecture Overview
Every box is persistent, every connection is logged, and every improvement returns value to everyone.
Company Map
The living model of how we create value.
Persistent facts, context, artifacts, and history.
Reviewed insights, decisions, preferences, and trade-offs.
Skills, playbooks, automations, templates, and tools.
Experiments, results, feedback, and improvement loops.
Retrieve
Find the right context, knowledge, and tools.
Use
Apply in work, decisions, projects, and support.
Output
Deliver artifacts, results, messages, and updates.
Review
Approve, correct, improve, or reject.
Update
Save back new facts, knowledge, and skills.
Directory Structure
Kebab-case files and folders. IDs are global. Coordinates place nodes in the knowledge graph.
company-map/
The living model of the company.
- vision.md
- strategy.md
- value-streams/
- org-roles/
- products/
- customers/
- processes/
- policies/
- principles.md
ID: map/* · coord: (0,0)
memory/
Persistent context and ground truth.
- facts/
- context/
- docs/
- reports/
- conversations/
- events/
- metrics/
- history/
ID: mem/* · coord: (10,y)
judgment/
Reviewed insights and decisions.
- insights/
- decisions/
- trade-offs/
- preferences/
- assumptions/
- reviews/
- evidence/
ID: jud/* · coord: (20,y)
capability/
Reusable skills and enabled work.
- skills/
- playbooks/
- automations/
- templates/
- tools/
- connectors/
- libraries/
ID: cap/* · coord: (30,y)
learning/
Learning that compounds capability.
- experiments/
- results/
- feedback/
- post-mortems/
- benchmarks/
- improvements/
ID: learn/* · coord: (40,y)
policies/
Guardrails that protect the system.
- security.md
- privacy.md
- access.md
- retention.md
- compliance.md
- quality.md
ID: pol/* · coord: (x,1)
skills/
Human skills and proficiency.
- skill-cards/
- rubrics/
- levels/
- certifications/
- assessments/
- mentors/
ID: skl/* · coord: (x,2)
workers/
People and team structure.
- people/
- teams/
- roles/
- onboarding/
- performance/
- availability/
ID: wrk/* · coord: (x,3)
decisions/
Decision history and approvals.
- log/
- adr/
- approvals/
- changes/
- impacts/
- links/
ID: dec/* · coord: (x,4)
projects/
Work and outcomes in flight.
- active/
- roadmap/
- backlog/
- plans/
- status/
- closed/
ID: prj/* · coord: (x,5)
Automations
Seven actions convert raw signals into reviewed, reusable company capability.
Review Gates
No gate bypass. Every change is accountable.
Low risk, auto-approve.
Requires approval.
High impact decision.
Policy or legal impact.
Core Guarantees
The minimum promises the architecture must keep.
- ✓One source of truth
- ✓Every change is logged
- ✓Every run is traceable
- ✓Every improvement returns
Knowledge Flow
The system improves with every cycle, moving from source signals into memory, judgment, capability, learning, and updates.
Outcomes
Scales with you. Not with token limits.
Reference Keys
Identifiers, coordinates, and arrows make every node traceable across the graph.
Sample ID Schema
Arrow Keys and Node Symbols
- Primary flow: main path from sources to updates.
- Reference flow: links between persistent stores and processes.
- Optional flow: secondary relationships when available.
- Feedback loop: improvements returning into the system.
- Persistent store, process/function, actor/worker, review gate, identifier, and coordinates.