Fulcrum Documentation Manifest
Document inventory organized by Diátaxis quadrant Source of Truth: infra/TRUTH_MAP.md for infrastructure state
Last Updated: February 1, 2026
📖 Tutorials (Learning-Oriented)
Step-by-step guides that teach through doing.
| Document | Purpose |
|---|---|
| getting-started/quickstart.md | 5-minute integration guide |
| getting-started/installation.md | Comprehensive setup |
| getting-started/first-policy.md | Create your first policy |
| getting-started/mcp-integration.md | Connect Claude Desktop via MCP |
🔨 How-to Guides (Task-Oriented)
Practical guides for solving specific problems.
| Document | Purpose |
|---|---|
| guides/policy-authoring.md | Writing and testing policies |
| guides/dashboard.md | Dashboard navigation |
| guides/troubleshooting.md | Common issues and solutions |
| guides/migration.md | Version upgrade guide |
| guides/sdk-examples.md | Code patterns and recipes |
| guides/mcp.md | MCP integration patterns |
| guides/github-actions.md | CI/CD governance |
| guides/gitops.md | Infrastructure-as-Code governance |
💡 Explanations (Understanding-Oriented)
Conceptual content that builds understanding.
Core Concepts
| Document | Purpose |
|---|---|
| concepts/overview.md | High-level product overview |
| concepts/envelopes.md | Execution envelope mechanics |
| concepts/policies.md | Policy engine design |
| concepts/cognitive-layer.md | Semantic Judge, Oracle, Immune System |
| concepts/sdk.md | SDK capabilities and patterns |
Architecture
| Document | Purpose |
|---|---|
| architecture/SYSTEM_OVERVIEW.md | System design overview |
| architecture/CONTAINER_MAP.md | C4 Level 2 container diagram |
| architecture/COGNITIVE_LAYER.md | Cognitive layer architecture |
| architecture/DASHBOARD_ARCHITECTURE.md | Dashboard API and auth |
| architecture/DATA_ARCHITECTURE.md | Database and data flow |
| architecture/DEPLOYMENT_ARCHITECTURE.md | Infrastructure layout |
| architecture/EVENT_SOURCING.md | NATS JetStream patterns |
| architecture/MULTI_TENANCY.md | Tenant isolation design |
| architecture/ADR_INDEX.md | Architecture Decision Records |
Security
| Document | Purpose |
|---|---|
| security/SECURITY_OVERVIEW.md | Security architecture |
| security/ACCESS_CONTROL.md | RLS and auth mechanics |
| security/THREAT_MODEL.md | Threats and mitigations |
📚 Reference (Information-Oriented)
Technical specifications and API documentation.
API Reference
| Document | Purpose |
|---|---|
| api/API_OVERVIEW.md | gRPC and REST overview |
| api/GRPC_REFERENCE.md | Protobuf contracts |
| api/mcp-tools-reference.md | MCP tool schemas |
SDK Reference
| Document | Purpose |
|---|---|
| reference/python-sdk.md | Python SDK reference |
| reference/typescript-sdk.md | TypeScript SDK reference |
Other Reference
| Document | Purpose |
|---|---|
| reference/PLATFORM_MATRIX.md | Services/hosting matrix |
| reference/SPEC_VERSIONS.md | Protocol version history |
| reference/CHANGELOG.md | Change log |
🔧 Operations (Runbooks)
Production deployment, monitoring, and maintenance.
Infrastructure
| Document | Purpose |
|---|---|
| infra/TRUTH_MAP.md | Authoritative infrastructure state ⭐ |
| infra/DOC_GOVERNANCE.md | Documentation rules |
| infra/DOC_STYLE.md | Canonical terminology |
| infra/DRIFT_GUARDRAILS.md | Acceptable drift limits |
Runbooks
| Document | Purpose |
|---|---|
| runbooks/DEPLOYMENT_GUIDE.md | Production deployment |
| runbooks/RUNBOOKS.md | Incident response |
| runbooks/MONITORING.md | Metrics and alerting |
| runbooks/HEALTH_CHECKS.md | Service verification |
| runbooks/CREDENTIALS.md | Secret locations |
| runbooks/disaster-recovery.md | DR procedures |
| runbooks/COGNITIVE_SETUP.md | Ollama/LLM setup |
| runbooks/DOPPLER_SETUP.md | Secret management |
| runbooks/cost-optimization.md | Cost management |
Service Runbooks
| Document | Purpose |
|---|---|
| runbooks/services/postgres.md | PostgreSQL operations |
| runbooks/services/redis.md | Redis operations |
| runbooks/services/nats.md | NATS JetStream operations |
| runbooks/services/ollama.md | Ollama LLM operations |
| runbooks/services/clerk.md | Clerk authentication |
🎨 Design
| Document | Purpose |
|---|---|
| design/DESIGN_SYSTEM.md | UI component library |
| design/STYLE_FULCRUM_FOUNDRY.md | Brand guidelines |
| design/IA_NAV.md | Information architecture |
| design/WOW_MOMENT.md | First-run experience |
📋 Plans & Decisions
Internal planning documents (not published to docs site)
| Document | Purpose |
|---|---|
plans/ |
Implementation plans |
plans/business-case.md |
Value proposition |
plans/business-model.md |
Pricing, GTM |
| decisions/ | Architecture Decision Records |
🤝 Contributing
| Document | Purpose |
|---|---|
| contributing/handoff.md | Session handoff guide |
| contributing/development-workflow.md | Development workflow |
Code Style Guides
| Document | Purpose |
|---|---|
| contributing/code-style-guides/index.md | Style guide overview |
| contributing/code-style-guides/go.md | Go style guide |
| contributing/code-style-guides/typescript.md | TypeScript style guide |
| contributing/code-style-guides/javascript.md | JavaScript style guide |
📁 Archive
Historical documents that have been superseded. See .archive/INDEX.md in repo root for the complete manifest.
Back to index.md