Knowledge Core

1.1 Inputs (Knowledge Base)

Before any work, the system must load the "World State"—the complete knowledge base.

To reach field-level understanding we use a RAG system with vector and graph storage:

Source	Format	Purpose
User documentation	Markdown/HTML	Semantic search (how features work)
Admin documentation	Markdown/HTML	Configuration and setup
Code documentation	AST parsed	Logic understanding
Deep System Analysis	JSON/YAML	Current ERP schema (tables, fields, workflow, states)

---

1.2 Deep System Analysis Structure

{
  "version": "1.0",
  "timestamp": "2025-01-15T10:00:00Z",
  "platform": {
    "name": "EspoCRM",
    "version": "8.x",
    "modules": ["AutoCRM", "Sales", "Product", "Warehouse"]
  },
  "entities": {
    "Account": {
      "table": "account",
      "fields": {
        "id": {"type": "varchar", "length": 24, "primary": true},
        "name": {"type": "varchar", "length": 255, "required": true},
        "type": {"type": "enum", "options": ["Customer", "Partner", "Supplier"]},
        "billingAddress": {"type": "address"},
        "assignedUserId": {"type": "link", "entity": "User"}
      },
      "links": {
        "contacts": {"type": "hasMany", "entity": "Contact", "foreign": "accountId"},
        "opportunities": {"type": "hasMany", "entity": "Opportunity"}
      },
      "indexes": ["name", "assignedUserId"]
    }
  },
  "workflows": {
    "OpportunityStageChange": {
      "trigger": "afterSave",
      "entity": "Opportunity",
      "conditions": [{"field": "stage", "changed": true}],
      "actions": ["notification", "updateRelated"]
    }
  }
}

---

➡️ Continue to Agent Roles.