Architecture

cmd/minerva
internal/
  cli/            Cobra commands
  mcp/            MCP stdio server
  skill/          SKILL.md discovery + Minerva activation
  profile/        agent.yaml management
  templates/      role prompts (builtin + disk)
  library/        export/import/lint portable bundles
  bridge/         local-agent integration snippets
  monitor/        presence (bins + tiers)
  integration/    deep readiness (sibling CLIs)
  status/         unified doctor/status report
  suggest/        shared suggestion engine
  analytics/      append-safe events
  evidence/       fcheap tag conventions + close receipts
  textdiff/       unified diffs for compare
  version/
docs/             VitePress site (this site)
specs/            Glyphrun CLI contracts
browser-specs/    Cairn docs-site contracts

Design rules

1. Disk is the SSOT for library content shared with harnesses.
2. Sibling tools own domain truth — Minerva shells their --json APIs.
3. Presence ≠ readiness — especially codemap/vecgrep.
4. Suggest proposes; host applies — except allowlisted activate.
5. No secret values in analytics, skills, or stashes.
6. Dogfood with glyph (CLI) and cairn (site).

Related stack

Tool	Relationship
local-agent / sonar	Runtime consumers of ~/.agents (session-native)
MCPHub	Gateway + call intelligence
Cortex	Task kernel (overview/stale signals only)
Bob	Repo contract
Codemap / Vecgrep	Retrieval readiness
fcheap	Evidence vault
glyph / cairn	Contract testing