Builds

Practice OS

build·working· investor· academic

What It Is

Practice OS is the central MCP server powering Claude Code with 38+ tools across 7 groups. It operates as a fractal operating system for consulting practice intelligence, using SQLite as a graph database for 253 entities with 248 typed links across 13 entity types and 13 link types. Dual transport: stdio for Claude Code and Desktop, HTTP+SSE for claude.ai. The nervous system of the entire practice -- every other product connects through it for context, intelligence, and coordination.

Why It Matters

Knowledge either compounds or evaporates between sessions. The difference is whether you use AI tools or operate an AI-native practice. Most consulting practices store knowledge in documents, spreadsheets, and slide decks. Knowledge degrades through staleness, resists search, and cannot be composed.

Practice OS encodes knowledge as a queryable entity graph with typed relationships, intelligence queries, and automated briefings. Ask which capabilities are under-realized, which content is stuck in the pipeline, which clients share patterns -- and get computed answers from graph traversal, not document search results. The 38+ tools span seven groups: entity CRUD, link management, practice analytics, filesystem scanning, briefings, dashboard generation, and research pipeline tracking. The Library System provides 15 search commands with a Planet/Moon architecture -- Planet commands cast wide across the graph, Moon commands drill deep into specific entities. This is not a CRM or a project management tool. It is an intelligence system for an entire consulting practice.

Proof Points

  • 38+ MCP tools across 7 groups, each with Zod schema validation
  • 112 tests passing via Vitest
  • Entity graph: 253 entities, 248 links, 13 entity types, 13 link types, FTS5 full-text search
  • Dual transport: stdio (Claude Code/Desktop) + HTTP+SSE (claude.ai via ngrok)
  • 15 search commands using Planet/Moon architecture for multi-lens discovery
  • Gap analysis, capability velocity tracking, orphan detection, stale entity scanning, dependency mapping
  • Drift scanner and backup sync with 5 scheduled tasks for practice health monitoring
  • SQLite via better-sqlite3 with MCP SDK, TypeScript, Vitest

Market Position and IP

Practice OS is the only MCP server purpose-built for consulting practice intelligence. The entity graph with 13 typed relationships provides structural intelligence that document management systems, CRMs, and project tools cannot replicate. The dual-transport architecture runs across every Claude surface -- Desktop, CLI, and web -- without per-surface integration work. The Library System's 15 search commands with Planet/Moon architecture provide a novel pattern for multi-lens knowledge discovery. No competing tool provides practice-level intelligence with entity graph navigation, automated briefings, research pipeline tracking, and drift detection through a single MCP server.

Novel Research Contribution

Practice OS demonstrates that a single MCP server with internal scope multiplexing can serve as a complete practice operating system -- replacing dozens of disconnected tools with a unified entity graph. Existing knowledge management research treats knowledge as documents to be stored and retrieved. Practice OS treats knowledge as entities with typed relationships that can be traversed, analyzed, and composed. The intelligence tools (gap analysis, velocity tracking, orphan detection) apply graph algorithms to practice management, producing computed insights rather than search results.

Implementation and Impact

Practice OS is the operational backbone of the entire consulting practice. Every product, framework, paper, client, and skill is registered as an entity with typed links. Intelligence queries surface gaps, recommendations, and risks. Automated briefings synthesize practice state across all domains. The drift scanner monitors for configuration divergence. For potential acquirers or research lab founders, Practice OS demonstrates that the entire practice can be operated through a single, composable tool infrastructure -- and that the 253-entity graph with 248 links represents a compounding knowledge asset, not a static inventory.

Links

  • GitHub: brigittecoles/practice-os (private)
  • Stack: TypeScript, MCP SDK, SQLite (better-sqlite3), Vitest

Connections

  • Imperatives: All 9 -- Practice OS operationalizes every imperative for the practice itself
  • Builds: All other products connect through Practice OS for context and intelligence
  • Frameworks: Content Engine Pipeline, Library System (Planet/Moon)
  • Capabilities: All 4 -- realized through the tool infrastructure