{
  "manifest_type": "agent_builder_living_manifest",
  "schema_version": "1.0",
  "generated_at": "2026-06-10T00:00:00Z",
  "last_verified": null,
  "ui_identity": {
    "name": "ATLAS Agent Builder",
    "url": "https://claraconnect.de/agent-builder",
    "manifest_url": "https://claraconnect.de/agent-builder/manifest.json",
    "purpose": "Visualisiert den Agent-Factory-Standard. Ermöglicht das Erstellen von Agenten-Entwürfen (Drafts). Keine produktiven Schreibrechte in Sprint 3.",
    "version": "1.0.0-draft",
    "status": "active",
    "sprint": "ATLAS-AGENT-BUILDER-MANIFEST-UI-1",
    "discovery_standard": "atlas-manifest-v1"
  },
  "context_summary": "Der ATLAS Agent Builder ist die erste Oberfläche für standardisierte Agenten-Erstellung im Atlas OS. Er visualisiert die 5-stufige Agent Factory Pipeline (Mission → Framework → Fleet → Governance → Lifecycle), das ManifestRuntime Schema (5 Schichten: Identity, Capabilities, Runtime, Lifecycle, Governance) und den Governance Kernel (Decision Inbox, Tool Risk Registry, Lifecycle Gate, Audit Trail, Human Approval). Sprint 3 ist read-only und draft-first: Keine produktiven Agenten werden erstellt, keine Schreibrechte sind aktiv. Das Manifest ist maschinenlesbar und für KI-Agenten nach Session-Reset optimiert. Agent-Entwürfe bleiben im Draft-Status bis zur manuellen Freigabe. Governance-Defaults: draft_first_read_only. Alle destruktiven Aktionen erfordern Human Approval.",
  "agent_factory_model": {
    "version": "v1.2c",
    "pipeline_stages": [
      {
        "step": 1,
        "name": "Mission",
        "subtitle": "& Domain",
        "description": "Definiert den Zweck und die Domäne des Agenten.",
        "color": "cyan"
      },
      {
        "step": 2,
        "name": "Framework",
        "subtitle": "& Reasoning",
        "description": "Legt den Reasoning-Typ und das Framework fest.",
        "color": "blue"
      },
      {
        "step": 3,
        "name": "Fleet",
        "subtitle": "& Modelle",
        "description": "Wählt Modelle und Node-Konfiguration.",
        "color": "green"
      },
      {
        "step": 4,
        "name": "Governance",
        "subtitle": "& Tool Risk",
        "description": "Definiert Zugriffsrechte, Tool-Risiken und Regeln.",
        "color": "orange"
      },
      {
        "step": 5,
        "name": "Lifecycle",
        "subtitle": "& Validity",
        "description": "Setzt Gültigkeitszeitraum und Post-Deadline-Verhalten.",
        "color": "pink"
      }
    ],
    "agent_types": [
      {
        "type": "radar",
        "name": "Radar Agents",
        "capabilities": ["Früherkennung", "Beobachtung", "Signale früh erkennen"],
        "color": "cyan"
      },
      {
        "type": "campaign",
        "name": "Campaign Agents",
        "capabilities": ["Kampagnen steuern", "Botschaften orchestrieren", "Wirkung maximieren"],
        "color": "pink"
      },
      {
        "type": "decision",
        "name": "Decision Agents",
        "capabilities": ["Entscheidungen treffen", "Optionen bewerten", "Empfehlungen liefern"],
        "color": "orange"
      },
      {
        "type": "document",
        "name": "Document Agents",
        "capabilities": ["Dokumente verstehen", "Strukturieren", "Wissen extrahieren"],
        "color": "blue"
      }
    ]
  },
  "manifest_runtime_schema": {
    "description": "5-Schichten-Architektur für jeden Atlas-Agenten",
    "layers": [
      {
        "layer": "01",
        "name": "ManifestIdentity",
        "label": "IDENTITY",
        "question": "WER ist dieser Agent?",
        "fields": ["agent_id", "name", "role", "agent_type", "lifecycle_trigger_type"],
        "color": "cyan",
        "description": "Eindeutige Identität des Agents und wie er ausgelöst wird."
      },
      {
        "layer": "02",
        "name": "ManifestCapabilities",
        "label": "CAPABILITIES",
        "question": "WAS kann dieser Agent?",
        "fields": ["text_generation", "read_file", "write_file", "atlas_vault_read"],
        "color": "blue",
        "description": "Funktionen, Tools und Zugriffsrechte des Agents."
      },
      {
        "layer": "03",
        "name": "ManifestRuntime",
        "label": "RUNTIME",
        "question": "WIE läuft dieser Agent?",
        "fields": ["framework_type", "agent_domain", "agent_mission", "top_backend", "reasoning_mode"],
        "color": "green",
        "description": "Technischer Rahmen, Domain, Mission und Betriebsmodus."
      },
      {
        "layer": "04",
        "name": "ManifestLifecycle",
        "label": "LIFECYCLE",
        "question": "WIE LANGE läuft dieser Agent?",
        "fields": ["lifecycle_type", "lifecycle_state", "valid_from", "valid_until", "deadline_at", "days_remaining", "post_deadline_behavior"],
        "color": "orange",
        "description": "Zeitfenster, Ablaufverhalten und Lifecycle-Kontrolle."
      },
      {
        "layer": "05",
        "name": "ManifestGovernance",
        "label": "GOVERNANCE",
        "question": "WAS darf dieser Agent?",
        "fields": ["tooling_state", "ai_rules", "models_allowed", "data_rules_state"],
        "color": "purple",
        "description": "Zugriffsregeln, Modelle, Datenrichtlinien und Limits."
      }
    ]
  },
  "lifecycle_gate": {
    "description": "Execution Control Flow für jeden Agent-Aufruf",
    "flow": [
      {
        "step": 1,
        "name": "EXECUTE REQUEST",
        "detail": "POST /api/agent/{id}/execute",
        "fields": ["query", "session_id", "context"]
      },
      {
        "step": 2,
        "name": "AGENT LOAD",
        "detail": "DB: SELECT agents WHERE id",
        "fields": ["manifest", "capabilities", "config"]
      },
      {
        "step": 3,
        "name": "LIFECYCLE GATE",
        "checks": ["valid_from > now?", "valid_until < now?", "lifecycle_type check"],
        "outcomes": {
          "pass": "STREAM AGENT",
          "blocked_not_yet": "403 lifecycle_blocked (not_yet_active)",
          "blocked_expired": "403 + auto-disable (expired)"
        }
      },
      {
        "step": 4,
        "name": "STREAM AGENT",
        "detail": "stream_agent() generator",
        "sse_events": ["domain_info", "lifecycle_info", "framework_info", "dispatch_info", "tool_call", "tool_result", "final_answer"]
      }
    ],
    "auto_disable_on_expiry": {
      "is_active": false,
      "lifecycle_status": "retired",
      "lifecycle_state": "expired",
      "sse_event": "lifecycle_blocked"
    }
  },
  "governance_kernel": {
    "description": "5 Governance-Komponenten die jeden Agenten-Aufruf absichern",
    "components": [
      {
        "id": "IN",
        "name": "Decision Inbox",
        "description": "Freigabe-Anfragen vor kritischen Aktionen",
        "color": "purple"
      },
      {
        "id": "RK",
        "name": "Tool Risk Registry",
        "description": "Risikobewertung pro Tool-Call",
        "color": "orange"
      },
      {
        "id": "LC",
        "name": "Lifecycle Gate",
        "description": "Zeitbegrenzung — Auto-Disable bei Ablauf",
        "color": "red"
      },
      {
        "id": "AU",
        "name": "Audit Trail",
        "description": "Vollständige Nachverfolgung aller Agenten-Aktionen",
        "color": "green"
      },
      {
        "id": "HA",
        "name": "Human Approval",
        "description": "Mensch-in-der-Schleife bei Hochrisiko-Aktionen",
        "color": "blue"
      }
    ]
  },
  "component_map": [
    {
      "component": "AgentBuilderPage",
      "file": "/root/claraconnect-frontend/src/pages/AgentBuilderPage.tsx",
      "purpose": "Hauptseite des Agent Builders — zeigt Pipeline, Schema, Lifecycle Gate, Governance Kernel",
      "route": "/agent-builder"
    },
    {
      "component": "AgentPipeline",
      "file": "/root/claraconnect-frontend/src/components/agent-builder/AgentPipeline.tsx",
      "purpose": "5-stufige Agent Factory Pipeline Visualisierung"
    },
    {
      "component": "ManifestRuntimeSchema",
      "file": "/root/claraconnect-frontend/src/components/agent-builder/ManifestRuntimeSchema.tsx",
      "purpose": "5-Schichten ManifestRuntime Schema Darstellung"
    },
    {
      "component": "LifecycleGateFlow",
      "file": "/root/claraconnect-frontend/src/components/agent-builder/LifecycleGateFlow.tsx",
      "purpose": "Lifecycle Gate Execution Control Flow Diagramm"
    },
    {
      "component": "GovernanceKernelCards",
      "file": "/root/claraconnect-frontend/src/components/agent-builder/GovernanceKernelCards.tsx",
      "purpose": "5 Governance Kernel Komponenten als Cards"
    }
  ],
  "backend_topology": {
    "relevant_services": [
      {
        "service": "Governor API",
        "port": 9012,
        "path": "/root/claraops_complete/backend/atlas_governor_api.py",
        "role": "Tool-Schemas liefern, Agent-Execution für Clara-Router-Pfad",
        "status": "running"
      },
      {
        "service": "AI-PC Relay",
        "port": 7071,
        "path": "/root/atlas-relay/relay.mjs",
        "role": "Qwen native Execution mit vollem Tool-Raum",
        "status": "running"
      },
      {
        "service": "Decision Inbox API",
        "port": 9012,
        "path": "/api/decision-inbox",
        "role": "Human-Approval-Anfragen für Governance Kernel",
        "status": "running"
      }
    ]
  },
  "agent_reentry": {
    "instructions": [
      "1. curl https://claraconnect.de/agent-builder/manifest.json | python3 -m json.tool | head -60",
      "2. Prüfe agent_factory_model.pipeline_stages für die 5-stufige Pipeline",
      "3. Prüfe manifest_runtime_schema.layers für das ManifestRuntime Schema",
      "4. Prüfe governance_kernel.components für die 5 Governance-Komponenten",
      "5. Prüfe lifecycle_gate.flow für den Execution Control Flow"
    ],
    "quick_health_checks": [
      "curl -s https://claraconnect.de/agent-builder | grep atlas-manifest",
      "curl -s -o /dev/null -w '%{http_code}' https://claraconnect.de/agent-builder/manifest.json"
    ],
    "do_not": [
      "Keine produktiven Agenten erstellen ohne Human Approval",
      "Keine write_file, edit_file, deploy_web_project ohne Freigabe",
      "Keine Secrets aus dem Manifest lesen oder ausgeben",
      "Nicht davon ausgehen dass Agenten-Entwürfe automatisch deployed werden"
    ]
  },
  "known_states": [
    {
      "id": "S-001",
      "title": "Sprint 3 — Draft-First Modus",
      "status": "active",
      "description": "Agent Builder ist read-only. Keine produktiven Schreibrechte. Agenten-Entwürfe bleiben im Draft-Status.",
      "verified": "2026-06-10"
    },
    {
      "id": "S-002",
      "title": "Governance Defaults aktiv",
      "status": "active",
      "description": "default_behavior=draft_first_read_only, write_access=false, deployment_access=false, human_approval_required=true",
      "verified": "2026-06-10"
    },
    {
      "id": "S-003",
      "title": "Produktive Agenten-Erstellung",
      "status": "planned",
      "description": "Schreibrechte und Deployment erst nach Sprint 4 Freigabe.",
      "verified": null
    }
  ],
  "governance_defaults": {
    "default_behavior": "draft_first_read_only",
    "write_access": false,
    "deployment_access": false,
    "human_approval_required": true,
    "blocked_actions_without_approval": [
      "create_production_agent",
      "write_file",
      "edit_file",
      "deploy_web_project",
      "restart_service",
      "modify_manifest",
      "secret_access",
      "activate_scheduler",
      "send_external_message"
    ]
  }
}