{"slug":"architecture/07_TWIN_WORKBENCH","title":"07 · Twin Workbench","section":"architecture","sectionLabel":"Architecture","status":"unclassified","type":"document","path":"architecture/07_TWIN_WORKBENCH.mdx","bytes":4128,"description":"The agentic workspace — reasoning, planning, work allocation, agent delegation, and execution for one user","updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n\n**The agentic workspace.**\n\nThe Twin Workbench answers one question:\n\n> **What can I do for this user, what should the user do, and what should be delegated?**\n\nIt is the AI counterpart to the Human Workbench. One Twin per user, scoped to their role domain. The Twin reasons, plans, allocates work, delegates to agents, executes under governance, and reconciles outcomes.\n\n---\n\n## Twin Anatomy\n\n```text\nUSER\n │\n └── ONE TWIN\n      │\n      ├── Understand context\n      ├── Observe work\n      ├── Analyze\n      ├── Plan\n      ├── Allocate work\n      ├── Delegate\n      ├── Execute\n      ├── Communicate\n      ├── Verify\n      ├── Reconcile\n      └── Report\n```\n\n---\n\n## Core Capabilities\n\n| Capability | Description |\n|-----------|-------------|\n| **Understand context** | Assemble context from the Spine via Projections |\n| **Observe work** | Monitor the Work Graph for relevant changes |\n| **Analyze** | Reason about situations and options |\n| **Plan** | Propose step-by-step execution plans |\n| **Allocate work** | Assign work to humans, agents, or self |\n| **Delegate** | Hand off work to domain or specialist agents |\n| **Execute** | Perform approved actions |\n| **Communicate** | Send messages, draft communications |\n| **Verify** | Check that actions produced intended outcomes |\n| **Reconcile** | Compare intended vs. actual, feed to memory |\n| **Report** | Surface findings to the user |\n\n---\n\n## OODA Grammar\n\nThe Twin follows the OODA loop for every work item:\n\n1. **Observe** — Gather signals from the Spine\n2. **Orient** — Understand context and implications\n3. **Decide** — Propose a course of action\n4. **Act** — Execute under governance\n\nThe Four Buttons map to OODA:\n\n| Button | OODA Phase | Action |\n|--------|-----------|--------|\n| **Store in Spine** | Observe | Capture truth |\n| **Ask your Twin** | Orient | Understand the work |\n| **Assign your Twin** | Decide | Delegate intent |\n| **Approve Twin's Action** | Act | Authorize execution |\n\n---\n\n## Suggested Actions Flow\n\n```text\nUnderstand Context → Collect Evidence → Analyze → Recommend → Plan → Awaiting Approval → Execute → Reconcile → Complete\n```\n\nAt \"Awaiting Approval,\" the Twin pauses. The human must explicitly approve. The Twin never skips this gate.\n\n---\n\n## Memory\n\nThe Twin maintains persistent memory:\n\n| Type | Description |\n|------|-------------|\n| **Episodic** | What happened in specific situations |\n| **Semantic** | Facts, relationships, patterns |\n| **Procedural** | How to do things, workflows |\n| **User Preferences** | How this user likes to work |\n\nMemory is scoped to the user's role domain and governed by the same policies as the Spine.\n\n---\n\n## Twin Rules\n\n| Rule | Description |\n|------|-------------|\n| **One Twin per user** | Each person has their own Twin |\n| **Role-scoped** | Twin's knowledge matches the user's role |\n| **Silent by default** | Prefers silence over low-value commentary |\n| **Never acts without approval** | Proposes, human decides |\n| **Operates on projections** | Never sees unrestricted canonical Spine |\n\n---\n\n## Twin Workbench Connects to\n\n| Layer | Relationship |\n|-------|-------------|\n| [Spine Fabric](/architecture/02_SPINE_FABRIC) | Reads via Projections, writes decisions |\n| [Projections](/architecture/05_PROJECTIONS) | Receives sandbox context |\n| [Human Workbench](/architecture/06_HUMAN_WORKBENCH) | Shares work through Shared Task Layer |\n| [Coworker](/architecture/08_COWORKER) | Receives context from ambient companion |\n| [Work Allocation](/architecture/09_WORK_ALLOCATION) | Allocates and delegates work |\n| [Governance](/architecture/10_GOVERNANCE) | Submits actions for approval |\n| [Agents](/architecture/12_AGENTS) | Delegates to specialist agents |\n| [Execution](/architecture/13_EXECUTION) | Executes approved actions |\n| [Reconciliation](/architecture/15_RECONCILIATION) | Verifies outcomes |\n"}