idea

Idea Brief: Brain Knowledge Base (BKB)

Initiative: TP-2141-Work-Management Created: 2025-11-29 Status: Draft Depends On: MDE (Markdown Documentation Editor)

---

Problem Statement

The existing Brain section (.claude/BRAIN/) contains hierarchical documentation organized in nested folders, but there’s no UI to navigate or edit this content. Users need a Docus-style interface with:

• Left sidebar: collapsible folder tree
• Center: document content (using MDE editor)
• Right sidebar: “On this page” table of contents

Proposed Solution

Create a Brain Knowledge Base feature that:

1. Reuses MDE editor components for content editing
2. Adds tree navigation for hierarchical folder browsing
3. Adds TOC sidebar for in-page navigation
4. Supports folder operations (create, rename, delete folders)

Target Users

• Internal staff documenting processes, strategies, and knowledge
• Teams organizing information hierarchically

Key Differentiator from MDE

Aspect	MDE	Brain (BKB)
Structure	Flat document lists	Hierarchical folders
Navigation	Index pages per type	Tree sidebar
Document types	Agents, Commands, Skills, MCP Servers	Knowledge articles
TOC	None	Right sidebar “On this page”

Existing Structure

.claude/BRAIN/
├── 1. OVERVIEW/
├── 2. Strategy/
├── 3. FEATURES/
├── 4. INDUSTRY/
├── 5. OTHER/
├── Jira/
└── MEETINGS/

UI Pattern (Docus-style)

┌──────────────────────────────────────────────────────────────────────────┐
│  TC Portal    [🔍 Search...]                                      👤     │
├────────────┬─────────────────────────────────────────┬───────────────────┤
│ BRAIN      │  Document Title                         │ On this page      │
│            │  ═══════════════                        │ ─────────────     │
│ ▼ 1. OVE.. │                                         │ • Overview        │
│   └─ intro │  Content here...                        │ • Getting Started │
│   └─ setup │                                         │ • Configuration   │
│ ▶ 2. Str.. │  ## Overview                            │ • Advanced        │
│ ▼ 3. FEA.. │  Lorem ipsum dolor sit amet...          │                   │
│   └─ doc1  │                                         │                   │
│ ▶ 4. IND.. │  ## Getting Started                     │                   │
│            │  ...                                    │                   │
│ [+ Folder] │                                         │                   │
│ [+ Doc]    │                              [Edit]     │                   │
└────────────┴─────────────────────────────────────────┴───────────────────┘

Next Steps

1. Complete MDE implementation first (editor components)
2. Spec out BKB as separate feature using MDE components
3. Implement tree navigation and TOC