KRATUS · the assistant at your side

An embedded, context-aware AI assistant available across the product — analyze, rewrite, build a report, draft a proposal, run a briefing. It reads the client’s full context and acts on demand. Distinct from the Agents module (autonomous workers); KRATUS is interactive and ubiquitous.

embedded everywherereads client contextreuses the AI kernel (#8)basic version in MVP

KRATUS vs. Agents

Same kernel, opposite interaction model. Both matter; don’t conflate them.

	Agents (module · Core #8)	KRATUS (this capability)
Trigger	Autonomous — schedule / event	Interactive — user, in-context
UX	Runs in the background	⌘K · side panel · inline actions, streaming
Role	An "employee" doing a job	The assistant at your side
Infra	Model routing · cost · RAG · guardrails	Same kernel, reused

The analogy: today, adjusting HLDHub via Claude Code, you just say “log it in HLDHub” and it already knows the full context. The KRAT ONE client has no Claude Code — so KRATUS embeds that assistant, with the client’s context pre-loaded.

Architecture

Sits on top of the AI kernel (Core #8) and adds three things.

① Context Assembler

Given a surface + entity (client, contact, deal, report), builds a ClientContext — CRM data, history, metrics, brand voice, knowledge base (pgvector). Every assist action loads it (cached).

ClientContext.load(clientId)

② Assist Actions

A catalog of interactive actions — prompt template + required context + output shape. Extensible; each is a capability, not an autonomous agent.

analyzerewritereportproposal

③ Invocation + UI

A consistent way to call AI in-context, streaming the answer back (Core #9 WebSocket).

⌘K paletteAssist panelInline actions

Lineage: the Context Assembler is your HLDHub pattern generalized — the Site Specialist Agent that compiles site-context.json + SiteContext::load(). KRAT ONE’s ClientContext is the same idea, per client, feeding both KRATUS and the Agents.

Assist actions (catalog)

Analyze

Read the current entity/context and surface insights & next actions.

Rewrite / Improve

Inline on any text field — tone, clarity, brand voice.

Generate Report

Compile a client report (SEO/ads/social/CRM) in the client’s language, white-labeled.

Custom Proposal

Draft a tailored proposal from the client context + service catalog (human approves).

Briefing Specialist

Run a structured discovery/briefing and produce a brief.

Funnel Specialist

Design a funnel/journey for the client from goals + context.

Dangerous outputs (send, publish, spend) go through the approval gate; every call meters tokens/cost into usage_event (margin visible).

Where it lives

Ubiquitous by design — exact placements defined later.

⌘K · global

Command palette from anywhere — “Ask KRATUS”.

Context panel

A side panel scoped to the current screen (a client, a deal, a report).

Inline

“Rewrite / Analyze / Improve” buttons on text fields and editors.

MVP scope

MVP ClientContext assembler

Build the context bundle first — both KRATUS and the Agents depend on it.

MVP 2–3 assist actions

Generate Report · Rewrite · Analyze, via ⌘K / panel with streaming.

v2 Proposal · Briefing · Funnel specialists

Richer specialist actions + more surfaces.

v2 Inline everywhere

Assist affordances across all editors and lists.