UB Governance
Benchmarked against: Anthropic β Data handling & compliance Source: EGS v1.2, Chapter 9 Authority: Captain-approved (2026-02-28)
UB Governance defines the rules for how knowledge enters, is classified, and is maintained in Universal Brain. It is the policy layer β the "law" that MTAAA (the classification pipeline) enforces automatically.
Relationship to MTAAAβ
| UB Governance (this page) | MTAAA | |
|---|---|---|
| Role | The rules (what to enforce) | The machine (how to enforce) |
| Defines | Language policy, tag format, quality checklist, freshness rules | Pipeline architecture, 5-node classification, Entry Dock, Promote flow |
| Scope | All UB content, all agents | Text content specifically (1 of 5 handlers) |
| Changes by | Captain decision | Engineering implementation |
UB Governance says "all entries must be in English." MTAAA's Text Subgraph enforces this during classification. Without Governance, MTAAA wouldn't know the rules. Without MTAAA, Governance could only be enforced manually.
Ingestion languageβ
All UB entries must be in English (Captain decision, 2026-02-28).
| Element | Language | Example |
|---|---|---|
| Title | English | "LangGraph Checkpoint Architecture" |
| Content body | English | Full text in English |
| Tags | English, lowercase | langgraph, checkpoint, architecture |
| Chinese quotes | Allowed inline | ε€ε₯ said: "δΈθ¦ check local" |
Why English? Cross-agent consistency. All agents (SS1, SS2, SS3) query UB with English. The embedding model (Gemini embedding-001) performs best with English queries matched to English content.
3D Classification dimensionsβ
Every entry is classified along three orthogonal dimensions. The dimensions are defined here (Governance) and enforced by the MTAAA Text Subgraph:
| Dimension | Question | Values | Enforced by |
|---|---|---|---|
| Topic | What is it about? | 5,389 CV paths (Amazon Books + SP.*) | MTAAA Node 2 (LLM) |
| Type | What kind of content? | 36 types (Dublin Core + Schema.org) | MTAAA Node 3 (LLM) |
| Lifecycle | How long to keep? | 4 values | MTAAA Node 4 (rule engine) |
LLM selects from Controlled Vocabulary only β no freeform classification. See 3D Classification detail.
Tag rulesβ
Format: lowercase, hyphenated. No spaces, CamelCase, or underscores. Maximum 8 tags per entry.
Mandatory tags by content typeβ
| Content Type | Required Tags |
|---|---|
| Research / Intel | research, [domain], [YYYY-MM] |
| Decision Record | decision, [project], captain-approved |
| Incident / RCA | incident, rca, P0-P3 |
| Spec / Design | spec, [project], [version] |
| Session Record | session, [ship] |
Examplesβ
# Good
tags: decision, superportia, captain-approved, ub-governance
# Bad
tags: Decision, SuperPortia, captain_approved, UB Governance
Ingestion quality checklistβ
Before calling ingest_fragment():
| # | Check | Why |
|---|---|---|
| 1 | Title is descriptive and searchable | Enables search_brain() to find it |
| 2 | Content is self-contained | Reader needs no other context |
| 3 | Tags follow controlled vocabulary | Consistent filtering and grouping |
| 4 | No duplicates β search_brain() first | Prevents knowledge fragmentation |
| 5 | Content is in English | Cross-agent, cross-ship consistency |
| 6 | Timestamp included (Taipei time) | Audit trail, freshness tracking |
Freshness managementβ
| Category | Rule | Tag |
|---|---|---|
| Timeless (frameworks, methods) | Use directly, no verification needed | β |
| Perishable (tool versions, APIs) | Verify before using, tag when verified | verified-YYYY-MM |
| Intel (market research, news) | Re-verify every 30 days | YYYY-MM date tag |
Perishable knowledge that fails verification must be updated or marked stale. See Tech Freshness for the enforcement protocol.
Ingestion flow (Governance perspective)β
From the Governance perspective, every piece of knowledge follows this path:
Agent discovers knowledge
β
Quality checklist (this page) β Is it English? Self-contained? Tagged?
β
ingest_fragment() β Content enters Entry Dock
β
MTAAA classifies β 3D dimensions assigned from Controlled Vocabulary
β
Promote β Entry moves to production (classified_entries)
β
search_brain() β Other agents can now find and use it
For the technical implementation of this flow, see File Ingestion (MTAAA).
Rules β enforcement mechanismsβ
Every governance rule has a corresponding enforcement mechanism. This is the "law β execution" map:
| Governance rule | Enforcement mechanism | Link |
|---|---|---|
| All entries in English | MTAAA Text Subgraph (language check during classification) | MTAAA |
| 3D classification (Topic Γ Type Γ Lifecycle) | MTAAA Nodes 2/3/4 (LLM + rule engine) | 3D Classification |
| Tag format (lowercase, hyphenated, max 8) | Agent behavior rule (pre-ingestion checklist) | AIP Β§4 |
| Quality checklist (title, self-contained, no duplicates) | search_brain() before ingest_fragment() β agent discipline | Ingest Fragment |
| No duplicates | search_brain() pre-check (future: automated dedup hook) | Search Brain |
| Knowledge freshness | Tech Freshness rule + Pre-Flight Check | PK defense |
| Timestamp (Taipei time) | Watch Rule β Constitution Β§4 | Company Constitution |
| Knowledge goes to UB only | Constitution Β§1 β supreme rule | Company Constitution |
| CV-constrained classification (no freeform) | Controlled Vocabulary CSV + LLM prompt design | CV sources |
Related pagesβ
| Page | Relationship |
|---|---|
| File Ingestion (MTAAA) | The pipeline that enforces classification rules automatically |
| EGS Spec | UB Governance is Chapter 9 of the EGS |
| Company Constitution | Β§1 "Knowledge goes to UB only" β the supreme rule |
| Tech Freshness | Freshness verification protocol for perishable knowledge |
| Ingest Fragment | The MCP tool that triggers ingestion |
| Search Brain | The MCP tool that retrieves classified knowledge |