{"slug":"internal/domains/README","title":"Domain Documentation","section":"internal","sectionLabel":"Internal","status":"unclassified","type":"document","path":"internal/domains/README.mdx","bytes":10299,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n## Overview\n\nThe **Domain Documentation** layer provides comprehensive, domain-specific documentation for how Spine Workspace operates within each business domain. Unlike internal documentation (which explains how Spine is built) or public documentation (which explains the product), domain documentation explains **how a business domain is worked** by humans, assisted by Twin and its workers, contextualized by Spine, processed by the system, and executed across connected source systems.\n\n## The Three Documentation Layers\n\n```\n                         Spine Workspace Docs\n                                  │\n             ┌────────────────────┼────────────────────┐\n             │                    │                    │\n        PUBLIC DOCS         INTERNAL DOCS       DOMAIN DOCS\n             │                    │                    │\n       Product / Dev       Architecture / Ops    Business Work\n                                  │                    │\n                                  │             ┌──────┴──────┐\n                                  │             │             │\n                                  │          Human        AI/System\n                                  │         Workbench      Working\n                                  │             │             │\n                                  └──────────── Spine ────────┘\n```\n\n## Domain Documentation Structure\n\nEach domain follows the **Canonical Domain Sidebar** template:\n\n```\nDOMAIN\n│\n├── Home\n├── Domain\n│   ├── Overview\n│   ├── Business Needs\n│   ├── Operating Model\n│   ├── Responsibilities\n│   ├── Roles\n│   ├── Entities\n│   ├── Processes\n│   └── Domain Vocabulary\n│\n├── Human Workbench\n│   ├── Overview\n│   ├── Home\n│   ├── My Work\n│   ├── Inbox\n│   ├── Tasks\n│   ├── My Queue\n│   ├── Approvals\n│   ├── Notifications\n│   ├── Recent Work\n│   ├── Favorites\n│   ├── Communications\n│   └── Personal\n│\n├── Domain Views\n│   ├── View 1\n│   ├── View 2\n│   ├── View N\n│   ├── Grid Views\n│   ├── Board Views\n│   ├── Canvas Views\n│   ├── Timeline Views\n│   └── Entity 360 Views\n│\n├── User Flow\n│   ├── Enter\n│   ├── Discover\n│   ├── Understand\n│   ├── Contextualize\n│   ├── Decide\n│   ├── Act\n│   ├── Review\n│   └── Continue\n│\n├── Business Context\n│   ├── Context Model\n│   ├── Entities\n│   ├── Relationships\n│   ├── Events\n│   ├── Transactions\n│   ├── KPIs\n│   ├── Communications\n│   ├── Documents\n│   ├── Decisions\n│   ├── Evidence\n│   └── History\n│\n├── Spine Fabric\n│   ├── Domain Projection\n│   ├── Context Sources\n│   ├── Context Scopes\n│   ├── Entity Context\n│   ├── Event Sequence\n│   ├── Organizational Memory\n│   ├── Knowledge\n│   ├── Multimodal Data\n│   ├── Memory\n│   └── Continuity\n│\n├── AI Workbench\n│   ├── Twin\n│   ├── AI Working\n│   ├── Context Assembly\n│   ├── Agent Runs\n│   ├── Suggestions\n│   ├── Recommendations\n│   ├── Proposals\n│   ├── Delegation\n│   └── Handoffs\n│\n├── AI Flow\n│   ├── Observe\n│   ├── Orient\n│   ├── Context Assembly\n│   ├── Reason\n│   ├── Discover\n│   ├── Delegate\n│   ├── Collaborate\n│   ├── Decide\n│   ├── Act\n│   └── Continue\n│\n├── Agents\n│   ├── Twin\n│   ├── Coworker\n│   ├── Discovery Agent\n│   ├── Triage Agent\n│   ├── Schema Agent\n│   ├── Domain Agents\n│   └── Sub-Agents\n│\n├── Communication & Handoff\n│   ├── Human ↔ Human\n│   ├── Human ↔ Twin\n│   ├── Twin ↔ Agent\n│   ├── Agent ↔ Agent\n│   ├── Agent ↔ Tool\n│   ├── Tool ↔ Spine\n│   ├── Context Handoff\n│   ├── Work Handoff\n│   └── Continuity\n│\n├── Skills\n│   ├── Domain Skills\n│   ├── User Skills\n│   ├── Twin Skills\n│   ├── Agent Skills\n│   ├── Workflow Skills\n│   └── Skill Configuration\n│\n├── Capabilities\n│   ├── Domain Capabilities\n│   ├── Tool Capabilities\n│   ├── Read Capabilities\n│   ├── Write Capabilities\n│   ├── Communication\n│   ├── Search\n│   └── Governed Actions\n│\n├── Workflows\n│   ├── Domain Workflows\n│   ├── Human Workflows\n│   ├── AI Workflows\n│   ├── Handoff Workflows\n│   ├── Approval Workflows\n│   ├── Automation\n│   └── Workflow Templates\n│\n├── Integrations\n│   ├── Connected Systems\n│   ├── Integrations Hub\n│   ├── Connectors\n│   ├── Connector Mappings\n│   ├── MCP Tools\n│   ├── Source Systems\n│   └── Write-back\n│\n├── System Flow\n│   ├── Interaction Intake\n│   ├── Event Intake\n│   ├── Flow A — Structured\n│   ├── Flow B — Unstructured\n│   ├── Flow C — AI\n│   ├── Flow D — Identity\n│   ├── Loader\n│   ├── Normalizer\n│   ├── Schema Mapping\n│   ├── Event Processing\n│   ├── Context Extraction\n│   ├── Context Assembly\n│   ├── Projection\n│   ├── OODA\n│   ├── Agent Routing\n│   ├── Governance\n│   └── State Update\n│\n├── Execution Flow\n│   ├── Intent\n│   ├── Context\n│   ├── Decision\n│   ├── Proposal\n│   ├── Capability Resolution\n│   ├── Agent Handoff\n│   ├── Tool Selection\n│   ├── MCP / Connector\n│   ├── Authorization\n│   ├── Human Approval\n│   ├── Workflow Execution\n│   ├── Source-System Write\n│   ├── Receipt\n│   ├── Event\n│   └── Spine Continuation\n│\n└── Architecture\n    ├── Domain Architecture\n    ├── Projection Architecture\n    ├── Context Architecture\n    ├── Spine Architecture\n    ├── Agent Architecture\n    ├── Capability Architecture\n    ├── Workflow Architecture\n    ├── Integration Architecture\n    └── Event Architecture\n```\n\n## The Four Flows\n\n### 1. Human Workbench\n**What the human sees and does.** Views, work, context, actions.\n\n### 2. AI Workbench  \n**What Twin/AI operators do.** Twin, skills, agents, handoffs, proposals.\n\n### 3. System Flow\n**How the system processes context.** Ingestion, OODA, pipelines, context extraction.\n\n### 4. Execution Flow\n**How work is actually executed.** Capabilities, MCP/Connectors, workflows, write-back, receipts.\n\n## Available Domains\n\n| Domain | Description | Status |\n|--------|-------------|--------|\n| [Account Success](./account-success) | Customer lifecycle management | ✅ Active |\n| [Technical Account Success](./technical-account-success) | Technical customer management | ✅ Active |\n| [Business Ops](./business-ops) | Business operations management | ✅ Active |\n| [Finance / RevOps](./finance-revops) | Financial and revenue operations | ✅ Active |\n| [Sales](./sales) | Sales pipeline and customer acquisition | ✅ Active |\n| [Marketing](./marketing) | Marketing campaigns and lead generation | ✅ Active |\n| [Content](./content) | Content creation and management | ✅ Active |\n| [Service](./service) | Customer service and support | ✅ Active |\n| [Product Engineering](./product-engineering) | Product development and engineering | ✅ Active |\n| [Personal](./personal) | Personal productivity and work management | ✅ Active |\n| [Human Resources](./human-resources) | HR and people operations | ✅ Active |\n| [Legal](./legal) | Legal and compliance | ✅ Active |\n| [Support](./support) | Technical and customer support | ✅ Active |\n| [Founder Ops](./founder-ops) | Founder and executive operations | ✅ Active |\n| [Operations](./operations) | General operations and administration | ✅ Active |\n\n## Architecture Relationship\n\n```\n                         DOMAIN\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n              ▼            ▼            ▼\n           HUMAN          AI         SYSTEM\n         WORKBENCH     WORKBENCH      FLOW\n              │            │            │\n              │            │            │\n              └────────────┼────────────┘\n                           │\n                     SPINE FABRIC\n                           │\n                    Context + Memory\n                    Events + Evidence\n                    Communication\n                    Handoffs\n                    Continuity\n                           │\n                           ▼\n                     EXECUTION FLOW\n                           │\n                    Capabilities\n                    MCP / Connectors\n                    Workflows\n                    Governance\n                           │\n                           ▼\n                    SOURCE SYSTEMS\n                           │\n                           ▼\n                      RECEIPTS\n                           │\n                           ▼\n                         SPINE\n```\n\n## Key Principle\n\n> **Domain documentation does not document a collection of screens. It documents how a business domain is worked by humans, assisted by Twin and its workers, contextualized by Spine, processed by the system, and executed across connected source systems.**\n\nThis directly mirrors the product architecture rather than creating a separate documentation abstraction.\n"}