Remy · AI teammate for financial advisors

Remy prepares the advisor's day, so the advisor can spend it with clients

Remy is an AI teammate for relationship managers and financial advisors in wealth management. It keeps a complete, sourced client memory for every relationship the advisor covers, works through the whole book overnight, and at 07:00 hands over a ready-to-action day: a morning dashboard, a brief for every upcoming meeting and a prepared draft for every open item. The advisor checks, decides and sends. Remy never does.

R
Remy advisor's companion
Remembers every client, prepares the day overnight, and leaves every decision and every message to the advisor.
Availability. Remy is delivered as a contracted package and configured with you in a joint design phase. Installation, configuration and extension apply once Remy is contracted for your organisation. See Before you begin.
07:00
The day is prepared before the advisor logs in. No prompting, no searching.
1 memory per client
Kept current from mail, calendar, Teams, CRM, portfolio data and client documents.
Every fact sourced
Each fact carries its source, date, basis and confidence, one click from the original.
Nothing sent by Remy
Remy drafts. The advisor approves and sends from their own mailbox, in their own voice.
How Remy works

Three things, every day: remember, prepare, hand over

1
Remembers
One living memory per client

Remy reads the advisor's mail, calendar, Teams, CRM, portfolio data and client documents, always under the advisor's own permissions. It files what matters into one memory per relationship: 14 topic pages such as compliance, goals, risk and commitments, plus open actions, meetings and a change log.

→ HOW THE MEMORY WORKS
2
Prepares
Overnight work across the whole book

While nobody is online, Remy works through every client. It spots what needs attention (an expiring document, a portfolio outside its bands, an overdue promise, an upcoming meeting, a market event), writes a brief for each meeting and drafts a letter for each open item.

→ THE OVERNIGHT PIPELINE
3
Hands over
A ready day at 07:00

The morning dashboard is waiting. The advisor approves, adjusts or declines. Letters go out from the advisor's own mailbox, in their name and voice. Whatever the advisor corrects, confirms or sends flows back into the memory on the next run.

→ GUARDRAILS
A day with Remy

From overnight work to the client

Memory is not the product. The product is the work Remy builds from it. Overnight, Remy turns the memory into finished artifacts. In the morning the advisor finds them ready, with no prompting. Their job is to check and approve. Anything that reaches a client goes out in the advisor's name and voice, so the client feels they are working with a person.

1 · Overnight · Remy works
R
Remy
works through the night, no user online
04:45inbox · sort new client mail05:00mine · refresh the memory05:20market radar05:30KYC expiry · screening06:00meeting briefs06:20actions sync06:30dashboard
Remy's default schedule. Every run reads and writes the advisor's memory, under the advisor's rights.
→
2 · Morning · ready to use

Here's what Remy has done for you

real artifacts in the advisor's home folder, ready by 07:00

Meeting brief

4 pages, HTML and PDF, before every client meeting
ready to use

Client letter

Outlook draft, one per client per day
waits for approval

Screening findings

adverse media and PEP, proposed, not decided
waits for approval

Source-of-wealth narrative

evidence and document gaps
waits for approval

Morning dashboard

work list, meetings, market radar
start here
no prompting, no searching: it is already prepared
→
3 · Advisor approves
A

Advisor

checks and approves
Approve
Adjust
Decline
That is the whole job:
check and approve.
Remy never sends on its own
organisation boundary
4 · Outside
C

Client

outside the organisation

Client letter

sent by the advisor, in their own name and voice
Feels like working with a person.
What makes Remy different

Memory, not sourcing

Sourcing

A value taken from one system and shown in one place. You can point to the field it came from. This is what a chat assistant with connectors does.

Memory

A conclusion that exists only because two or more sources were joined. On a call in May the client said they were expanding into Asia; this week the news reports a Singapore office, and the policy on file covers one jurisdiction. Remy flags the gap and drafts the proposal.

→ WHY REMY
For IT and architecture

Architecture in one picture

Read left to right. Sources feed the client memory; Remy turns the memory into the day; the advisor decides and sends, and what they do flows back in on the next run. The guardrails hold across all four.

Sources

Read by ID, never by name

Client document folders

Outlook · Teams · CRM · portfolio · web

What the advisor tells Remy

Any system connected as an MCP server

→ CONNECTORS, IDENTITY AND MINING
→
Client memory

Markdown in the knowledge base

14 topic pages per client

Registers: actions · meetings

Change log · prepared letters

source · date · basis · confidence on every fact
→ CLIENT MEMORY
⇄
R
Remy

Turns the memory into the day

1

Mine

2

Monitor

3

Brief

4

Dashboard

Dashboard · briefs

Drafts · chat with citations

⇄
Advisor

Decides and sends

Reviews and sends from own mailbox

Corrects and confirms

Talks to clients

never overwritten by automation
Built on the platform the bank already runs · no new database

Knowledge base

storage · permissions · versioning · search · citation

Agent runtime

skills · tools · subagents

MCP hub

Outlook · Teams · CRM · web · any further system

Scheduled tasks

the nightly runs
→ ARCHITECTURE AND DATA FLOW
01 · Memory model

How memory works with Remy

→ CLIENT MEMORY, HOW IT WORKS

Every user has a second brain in their personal home folder. It holds one client memory per client, plus a user memory about the user, kept strictly apart from the client memories. Remy mines sources into it, reads from it, and builds that user's dashboard. A desk memory is a separate, shared memory. Remy mines it from the second brains of the desk's members, with its own rules. Every memory is access-controlled, and mining only ever adds. From this memory Remy prepares real work overnight, and the user's role is to check and approve it.

R
Remy advisor's companion
Keeps the second brain in order and prepares the advisor's day. One set of skills for advice, compliance and relationships, all writing into the same memory.
Sources · where information comes from
ChatOutlook · mail, calendarTeams · chats, callsCRMOther systems (MCP)Web

Knowledge base

client files · /remy/clients/<Client>/
each folder keeps its own access rights
mined by Remy, with the skills the user runs
A

User A

client advisor
reads · checks
corrects via chat
R

Remy

advisor + compliance skills
writes
reads

Second brain

where user and Remy meet · client memories + user memory

Client memory

Jane Doe (rec_991)/
index.md
compliance · sow
balance-sheet · goals
risk · tax · mandate
relationship · network
commitments · in-flight
actions · meetings
changes · documents
_meta/ identity · logs

Client memory

Robert Smith (cw-8f3k2p)/
same page set, own factsevery fact carries its source, date, confidencefacts from chat are kept as wiki-only

+ one per client

created by mine or register

User memory

no client data · no CID
about the user: preferences, way of working · kept apart from the client memories

Dashboard

dashboard.html · actions.json
overnight work, ready to approve · briefs, drafts, alerts
R
built by Remy
Personal home folder of User A$UNIQUE_HOMEonly User A
B

User B

compliance officer
reads · checks
corrects via chat
R

Remy

KYC & compliance skills
writes
reads

Second brain

where user and Remy meet · client memories + user memory

Client memory

Jane Doe (rec_991)/
same client as in User A's brain: separate, private copy
index · compliance
screening · sow
risk · relationship
actions · changes
…

Client memory

Tom Keller (rec_412)/
same page set, own factseach of Remy's skills adds facts to the pages it owns

+ one per client

created by mine or register

User memory

no client data · no CID
about the user: preferences, way of working · kept apart from the client memories

Dashboard

dashboard.html · actions.json
overnight work, ready to approve · briefs, drafts, alerts
R
built by Remy
Personal home folder of User B$UNIQUE_HOMEonly User B
selected facts,
mined up
selected facts,
mined up
R

Remy · desk mine

one run per desk, with the desk's own rules
Legend
mine / write · always additive
read
mined up into the desk
source feed
R
Remy, running with that user's rights
access boundary

Desk / company memory

one combined memory for the desk or company · one client memory per client
members only

Client memory

Jane Doe (rec_991)/
one combined copy, built from User A's and User B's second brains
desk page set

Client memory

Tom Keller (rec_412)/
Remy desk-mines every member's brain into the same memory
desk page set

+ one per client

of the desk
How the memory turns into finished work by 07:00 (briefs, letters, findings and the dashboard) is shown on the Overview under A day with Remy.

Types of memory

Sources (not memory)

The systems information comes from: chat, Outlook (mail, calendar), Teams (chats, calls), the CRM, other connected systems, and the web. Remy mines them into memory.

written by the outside world
access the user's own connector rights

Knowledge base

Shared files around Remy. That includes one folder of raw documents per client (KYC, portfolio, correspondence, …), and those folders are mined like any other source.

path /remy/clients/<Client>/
access per folder; client folders created by register are private to that advisor

Second brain

A user's personal memory, in their home folder. It has two parts: one client memory per client, and the user memory. Remy reads it and adds to it. It is where user and Remy talk to each other: the user sees what Remy knows and why.

path $UNIQUE_HOME/clients/
access owner only: no other user, no desk

Client memory

One folder per client inside the second brain: topic pages (compliance, balance sheet, goals, risk, relationship, network, …), open actions, meetings, a change log, and _meta/ with the identity map and mining and chat logs. Every fact carries its source.

path $UNIQUE_HOME/clients/<Name> (<id>)/
access inherits the second brain: owner only

Dashboard

One per user, in the home folder. Each of Remy's skills adds its own cards: the work list, meetings, the market radar, and client lists. The user's ticks go back into actions.json.

written by Remy, for that user
access owner only

Desk / company memory

One combined memory for a desk or the whole company, built like a second brain: one client memory per client. Remy mines the members' second brains into it, with the desk's own rules. Its page set differs from the personal one.

written by Remy's desk mining run
access members of that desk or company only

User memory

Part of the second brain, but about the user, not about clients: their preferences and way of working. It is kept completely apart from the client memories and holds no client identifying data (CID) at all. Client facts always go into the client memory.

written by the platform (Conduct user memory)
access owner only
never contains client names, facts or CID

Rules everyone should know

1
Everything is access-controlled.Only the owner can open a second brain. Only the desk's members can open a desk memory. Knowledge-base folders keep their own rights. Remy acts with the rights of the user who runs it.
2
Mining is additive.Remy adds files and facts, moves facts to the right page, and fills gaps. It never deletes files or pages. A refresh can replace an outdated source line, but facts from chat are never dropped. Only an explicit "forget" removes them.
3
One brain, one agent, several skills.Remy mines the same second brain with every skill it runs: advisory, KYC and compliance, relationship. Which skills run depends on the user's role, but they all write into the same pages.
4
The memory is the conversation.The user opens any page to see what Remy knows and where each fact came from. Corrections go through chat, and Remy writes them back as user-entered facts.
5
Shared memory is mined, never opened up.Nothing in a second brain becomes visible to the desk on its own. Remy's desk mining run picks out the facts that matter to the desk and adds them to the one combined desk memory.
6
One dashboard per user.The dashboard is not owned by one skill. Every skill the user runs adds its cards to the same page.
7
User memory and client memory never mix.The user memory knows the person: preferences and way of working. The client memory knows the clients. No client fact or CID ever lands in the user memory.
8
Remy prepares, users approve.Overnight Remy turns the memory into finished artifacts: briefs, letters, findings, narratives. In the morning the user approves, adjusts or declines them. Nothing needs to be asked for or searched.
9
Clients hear a person.Remy only drafts. Nothing reaches anyone outside the organisation until the user approves it, and it goes out in the user's name and voice.

Why this shape

What it gives
  • One memory per person, read and written by every skill, so nothing works from a stale copy.
  • The user sees exactly what Remy knows, with sources.
  • Desks share knowledge without anyone's personal memory being opened.
  • Users start the day with finished work. Their job is to check and approve.
What to watch
  • A change to one skill changes what the other skills read from the same brain.
  • The same client lives in several second brains, and each can be in a different state.
  • The desk-mining rules decide what leaves a personal brain, so the desk memory is only as good as those rules.
  • Drafts have to sound like the user. A mechanical tone in a client letter breaks the client's trust.
02 · Client memory · how it works

One folder per client, in the knowledge base, in plain markdown

The client memory is the bank's memory of the relationship. It is an existing platform primitive, not a new store: permissions, search, citation, versioning, retention and backup are inherited. The skills rebuild it on every run and the advisor corrects it in chat or on the page. The documents stay where they are, in the client document folder; the memory records facts and links to them.

Every page has an authorship class that says who may write what, and every fact carries its provenance.

clients/Anna Meier (cw-0413)/
master client ID is the folder suffix: namesakes never share a folder
14 topic pages · authorship class on every page
index.md
snapshot · derived
compliance.md
MIRROR
screening.md
AGENT-PROPOSED
balance-sheet.md
mixed
cash-flow.md
MINED
goals.md
MINED
risk.md
mixed
tax.md
mixed · never tax law
mandate.md
mixed · performance is mirror
relationship.md
MINED
commercial.md
mixed · access-sensitive
commitments.md
mixed
network.md
AGENT-PROPOSED
in-flight.md
MINED
sow.md · referrals.md
appear when their skill first runs

Written by mining (from the sources), remember (from chat) and update (curation). The advisor may edit a topic page directly. Prospects start with a single index.md and gain the full set at onboarding. Which pages are in scope at launch, and which fields are system-of-record mirrors, is set per bank in the design phase. The sufficiency test for the schema: a meeting brief must be reproducible from the memory alone.

Registers, logs and meta · who writes
actions.md · meetings.md
Live registers, rebuilt. Only the monitor and meeting-brief skills; humans never edit.
changes.md
Append-only change log. Every skill that writes a page appends here.
documents.md
Which sources fed this memory, with links. Never a copy of a document.
actions/<id>.email.md
One prepared letter per open action. Monitor skills, under the letter policy.
_meta/
identity.md · mining-log.md · chat-log.md · screening-log.md · *-alerts.md · curation.md · written by the skills, read by audit
clients/_meta/
client-memory-description.md · action-email.md · screening-policy.md · doc-expiry-policy.md · drift-policy.md · suitability-policy.md
Authorship class · if the source has nothing
MIRROR
Copied from a system of record, never inferred. Leave blank.
AGENT-PROPOSED
Drafted by a skill, pending until a human confirms. Stays "proposed".
MINED
Extracted with full metadata. "No data on file".

The authorship class is what stops mining from writing a PEP status onto the compliance page and leaving the bank holding two KYC records.

Provenance on every fact
source followable linkdate basis client-stated · firm-confirmed · firm-inferred · estimated · observed confidence confirmed · probable · unconfirmed capture state stated · acknowledged · documented origin source-file · advisor-entered · chat-observed backup source-backed · memory-only

A brief that shows an amount, date or status renders its basis beside it: an estimate never looks like a balance.

Scope levels · separate memories, not copies
/home-<userId>/

Per user

Working memory, notes, drafts. Private by default.
/<team>/clients/

Per team

Jointly covered relationships; deputies during cover. Groups from the IdP.
/<organisation>/clients/

Per organisation

Governed, promoted: compliance, mandate, commitments, in-flight, change log. The record that survives a leaver.

The same client can hold more than one memory at once; these are separate folders, not copies. Promotion between levels and precedence are configured by the administrator. The promotion rule (what, by whom, under which rule) is agreed in the design phase and recorded in the change log.

Which memory survives a leaver? The organisation-level memory, not the private per-user one.
Lifecycle · one marker per memory, one owner per transition

prospect

register
→

onboarding

onboard · start
→

client

advisor confirms
→

offboarding

offboard · start
→

offboarded

archive, nothing deleted

Exactly one marker per memory, each transition with one owner. Mining may stamp a missing marker from evidence but never moves a confirmed state. The advisor's confirmation is the only sign-off that a prospect becomes a client.

Terminology · vocabulary used across the documentation
AdvisorClientSecond brainMemory builderMiningSkillMonitorPolicy fileDescription fileMaster client IDIdentity mapFocus daySide panelSpaceMCP serverDesign phaseBrand pack
03 · Sources · connectors, identity and mining

Identity is resolved once per client and source; afterwards every system is read by stored ID

The memory is fed from the knowledge base plus the systems the bank connects. Identity is resolved once per client and source; afterwards connected systems are queried by the stored client ID, and every web hit is re-corroborated. A name alone is never an identity.

A source record travels left to right

The connectors decide what can be read, the identity gate decides which client it belongs to, and only then does the mining pipeline write the memory.

Connectors · availability checked every run
SourcePermissionWindowIdentity key
Client document folderFolder permissionsFullFolder name + master client ID
ChatUser's sessionAcross runsUser's own folders; ambiguity asked back
OutlookDelegated: mail read, calendar read, draft create30 d back · 7 d aheadMailbox, message and event IDs
TeamsDelegated: chat read; transcripts where licensed30 d back · 7 d aheadParticipant / chat / call IDs
CRM / client recordReadFullRecord ID = master client ID
Portfolio / core bankingReadFullSystem ID
Web searchOutbound, subject to approvalCurrentNone stored; two independent keys per hit
SharePoint · OneDrive · DMSPlatform connectorsn/aVia the document folder
Custom (MCP server)As granted per serverPer integrationThat system's ID, confirmed like any other

A connector that is absent is out of scope for that run; every mining report states which sources were used. Fixed windows keep runs predictable and cheap; the mining log makes them idempotent. What each missing connector limits is listed on Before you begin.

Identity gate · two identities, kept apart

The user

Authenticated by the platform. Every read and write runs under their permissions. Groups from the IdP, never maintained inside Remy.

The client

One master client ID (CRM → core banking → generated) plus one identity-map row per system: identifier, kind, match basis, confidence, verified date.
Rules
A stored ID winsOnce confirmed, queried by ID, never re-matched by name
A name is a hypothesisNeeds a second key (email, phone, account, DOB) or the user
Ambiguity stops the mergeCandidates recorded unconfirmed; nothing mined; run reports it
Only confirmed feeds a memoryProbable and unconfirmed rows are skipped entirely
A real ID arriving laterFolder name stays; identifier added to the map

This is the gate against cross-client spillover, the one failure a bank cannot accept, and it holds by construction.

Source trust tiers
authoritative · core banking, CRM semi-trusted · internal mail, calendar, filed documents untrusted · external mail, web

The tier decides what content from a source is allowed to do, never whether the source is read. Untrusted content can supply facts but never instruct the system: the main defence against prompt injection from incoming mail and web pages.

Mining pipeline · writes the client memory
1

Inventory

Every source record, diffed against the mining log
2

Classify

Model picks which new or changed records matter and reads only those
3

Extract

Facts to the page that owns them: source, date, basis, confidence
4

Route

Page-routing map decides which fact type lands where; mirror fields copied, never inferred
5

Log

Mining log per source record; change log per client
Modes
refresh
new and changed records only · every nightly run
update
curation without mining new sources · monthly, or after a large mine
redo
controlled re-mining from scratch · on demand, after a schema or source change
First run per user

Nine steps, reported live, kept in an install report. Steps 1–2 (find sources, build the memory) are agent work; 3–9 are one command that refuses to run while 1–2 are unreported. Five clients are mined in parallel as subagents, falling back to inline mining where delegation is unavailable. Planning guidance is on Before you begin.

04 · Schedules · the overnight pipeline

A standing overnight batch: by 07:00 the advisor opens a finished dashboard

Scheduled tasks turn Remy from a set of on-demand skills into a standing overnight batch: every night the memory refreshes, the monitors raise what needs attention and the briefs are prepared. Nothing in the pipeline sends, decides or writes to a system of record.

A fixed prompt per task

Fresh chat, self-contained, ends with "then stop".

Runs as the advisor

Under the advisor's permissions and connectors.

Idempotent install

One tagged task per skill.

Local time, managed from chat

Times are converted at install.
The order matters · daily
04:45

Inbox

Yesterday's client mail → document folders
05:00

Mine

Memory refresh from every connected source, including those deposits
05:20 – 06:10

Monitors, staggered

radar · doc-expiry · screen · drift · suitability. All write actions.md, so never the same minute.
06:00

Briefs

One brief per meeting in the next five business days
06:20

Sync

Reconcile dashboard ticks with the mailbox
06:30 → 07:00

Dashboard

Last, so it reads everything fresh. The morning page, ready by 07:00.

What each run touches and how long it takes is on Running, monitoring, upgrading and recovery.

Default schedule set · 13 tagged tasks · install is idempotent
TimeCadenceSkillPurpose
04:45dailyinboxInbound client files into the document folders
05:00dailymine (refresh)Nightly memory update from all sources
05:20dailymarket-radarOvernight market scan → per-client impact, book radar
05:30Mondaydoc-expiryWeekly KYC document expiry check
05:45MondayscreenWeekly adverse-media and PEP screening
05:501st of monthportfolio-driftDrift versus mandate
06:101st of monthsuitability-reviewSuitability cycle and material-change check
05:3015th of monthupdateMemory curation: dedupe, rephrase, reshuffle
05:308th of monthreferralsReferral mining; heaviest web run, on its own day
06:00dailymeeting-briefMeetings register and briefs, next five business days
06:20dailyactions-syncApply dashboard ticks once the mailbox confirms
06:30dailydashboardMorning page, ready by 07:00
05:30quarterly · optionalsowSource-of-wealth refresh; normally on demand

Not installed by default: audit (suggested quarterly for integrity checks). Shaded rows run every night.

Tuning the cadence · one command, nothing else changes
MonitorDefaultAlternative
ScreeningWeeklyAlign to the bank's periodic review cycle
Portfolio driftMonthlyDaily/weekly for persistence-based escalation
SuitabilityMonthlyWeekly for a higher-touch book
ReferralsMonthly on the 8thQuarterly for a large book; on demand for one client before a meeting
Actions syncOnce, before the dashboardSeveral times a day if midday ticks should land before tomorrow
Document expiryWeeklyDaily is cheap: a pure date comparison

The cadence is a deployment setting, aligned to the bank's risk-based review cycle.

First run versus standing runs

Installer · one unattended pass

install schedules → inbox → mine → monitors → radar → briefs → actions-sync → dashboard

Before the schedules can be useful the book needs one full pass: the installer. A newly registered prospect gets a per-client catch-up prompt instead of waiting for the night. The install steps are under First run per user.

05 · Skills reference

Every skill produces exactly one thing, and no two skills produce the same thing

A skill is a versioned task definition in prose: declared inputs, outputs, permitted tools, write policy, evaluation suite. Where a monitor needs rules, it reads them from a policy file. A skill runs as the invoking user and never grants permissions. All skills produce drafts; none sends client mail or writes to a system of record.

Default cadences for the scheduled skills are on Schedules.

Memory · writes the client folder
mineBuilds and refreshes the memory from folders and every connector. refresh · update · redo
updateCurates without mining. Never drops an advisor-entered fact
rememberWrites a chat fact to its page, tagged. forget removes via a logged path
askAnswers from the memory with citations. Read-only
auditHealth report: coverage, broken links, unsourced facts, stale mirrors. Read-only
Monitoring · raises open actions · policy file each
doc-expiryT−60 / T−30 / expired, "not on file"weekly
portfolio-driftHoldings vs bands, limits, prohibitionsmonthly
suitability-reviewTiming and material changes; dossier, no conclusionmonthly
screenAdverse media and PEP; two keys per hit; pending dispositionweekly
market-radar24 h of market news scored per client and booknightly
Daily brief and dashboard · renders
dashboardRebuilds the morning page from all registers; writes nothing else
focusOne ranked focus day: the recommendations card
meeting-briefOne brief per meeting, HTML and branded PDF
meeting-followupWrite-up, outcome written back, follow-up draft
draft-emailOne drafted client email in two tones
home · design-systemOpens the dashboard; canonical visual identity and brand-pack override
Client lifecycle · advisor confirms every transition
registerNew prospect: namesake check, folders, mining, baseline screening, Day 1 gaps
onboardProspect to client: gap check, bundled request, hand-off pack
onboarding-intakePopulated intake workbook from the onboarding folder
offboardStart or complete without deleting the archive
sowSource-of-wealth narrative, proposed; never a KYC determination
Communication and actions
inboxFiles inbound attachments into the document folders; never writes the memory
actions-syncDone cards reconciled with the mailbox; reopened if unverified
referralsPublic network per client, scoring, graph on network.md, dossiers
Orchestration and setup
installUnattended first run, nine steps. Never asks, never sends
setupData mode, platform, connectors, user name; verifies connections
schedulerInstalls, inspects, retunes, pauses, removes the recurring runs
check · versionHealth report, running build, where memory lives, how to run any command

The two panels below are developer contracts, explained on Extending Remy.

How a monitor raises an action · the actions-register contract
1

One row on actions.md

Stable ID: a re-run updates, never duplicates; removed when clean
2

One prepared letter

Same addressee shares one draft per day; rewrite, never a second
3

One alert ledger

Per monitor in _meta/; the dashboard and export contract
4

Change-log entry

On changes.md
5

Never

Another skill's page; the registers by hand

The dashboard reads the register: a new monitor appears on it with no UI work.

Anatomy of a skill · prose that calls its service's command line
<skill-name>/ ├── SKILL.md name, description, trigger phrases + procedure ├── references/ policy files, templates, method notes └── scripts/ helpers; never a substitute for the service CLI
one product per skilldeclared inputs · outputs · tools · write policydrafts onlyasks nothing on a scheduled runreports sources used and unavailableown evaluation suiteversion inherited from the service
06 · Security, guardrails and compliance

Twelve guarantees that hold across all four layers: properties of the design, not manual checks

The guarantees Remy makes to a regulated institution, each paired with the mechanism that enforces it, and the security posture of the runtime.

Guarantee → how it is enforced

No cross-client mixing

Reads by client ID; two independent keys per web hit or name match; no merge under ambiguity; only confirmed identities feed a memory.

No invented facts

Mirror rule on compliance, screening, custody and performance pages; no such figure is ever derived.

Traceable

Followable source mandatory on every fact; bare system names rejected; documents live once, the memory links.

Pending until confirmed

Explicit confirmation flag; proposed rows render as pending; dispositions are human acts.

Advisor knowledge protected

Origin tag; removal only through the explicit forget path or a recorded decision.

Deliberately not stored

Exclusion list in the description file, applied by every skill, extended by the bank: politics, health, inferred personality, gossip, relatives' finances, tax law.

Never the system of record

Authorship classes; no skill writes to CRM, KYC or portfolio systems.

Basis beside every figure

Render rule in brief and dashboard; basis and confidence on every fact.

Drafts only

Letters written into the client folder; only the user's "Create draft" touches the mailbox, in their own account.

Owned by the institution

Knowledge-base folders under the bank's permissions, versioned, retained, backed up.

Under the user's permissions

Every run as the invoking user; team and organisation views bounded by folder permissions; a skill cannot widen entitlement.

Auditable

Platform audit log and versioning; append-only change log per client; alert ledgers per monitor; read-only audit skill.
Security posture of the runtime

Data leaving the tenant

Nothing does. Sources are read into the bank's knowledge base; the only outbound call is web search, where approved.

Rendered pages

Sandboxed HTML, no same-origin or top-navigation rights. Three typed channels only: read a file by path, hydrate a list, send a typed action. Checked at build time.

Prompt injection from content

Trust tiers: authoritative · semi-trusted · untrusted. Untrusted content supplies facts, never instructions. Scheduled prompts are fixed and end with "then stop".

Least privilege

Delegated on-behalf-of connectors; groups from the IdP; skills declare permitted tools and write policy; one writer per path.

Write-back to core systems

Read-only by default. Any write-back is a separate, receipted, version-checked decision outside the package.

Secrets and tokens

Connector credentials live in the platform's MCP hub; the admin tool's token stays local and is never deployed.

Retention, residency, backup

Inherited from the knowledge base and the bank's platform deployment; Remy adds no store.

Hosting

The bank's own deployment: public cloud, private cloud or on premises. Bounds model availability and outbound access.
Human in the loop
Reviews and sendsDraft in their own mailbox; the sent mail is mined on the next run and the action clears
Corrects and confirmsRemember, forget, edit, disposition, adjudicate: tagged, logged, protected; newest never wins automatically
Talks to clientsRe-enters through the sources on the next run
What Remy never does
  • Send a client email, book a trade, transfer an asset, open an account
  • Issue a suitability, screening or KYC conclusion
  • Write to CRM, KYC, portfolio or case-management systems
  • Store the categories the bank excludes
  • Act outside the permissions of the user who invoked it
07 · Services and knowledge base

One folder is one service; dependencies point downwards only

→ FULL PAGE: EXTENDING REMY
Service layers · what each owns
Presentation
frontenddashboard.html · setup.html · dashboard.jsonsetupsetup.json · install.jsonpublishpushes the skill treedemoseeds from fixtures
↓
Workflow
focusfocus.jsonschedulescheduler.jsonsecond-brainthe memory builder · nothing in Remy's tree
↓
Memory
clientsclients.json · clients/{id}/meetingsmeetings.json · meetings/{id}/draftsdrafts.json · drafts/{id}/actionsactions.jsonsourcesreads connectors
↓
Kernel
_kernelthe knowledge-base door, the layout, the contract checks

imports

code, checked at symbol level

invokes

one service calls another's command line

owns

exactly one writer per path
A contract check in CI covers manifests, ownership, layering, imports, skill names, "no two skills produce the same thing", version bumps and the dependency map. Every service carries its own version; a change without a bump fails the check. Around 375 tests.
Knowledge base view · three trees

Skills

/skills/
remy-skills/ ├── remy-installer.html ├── remy-install/ ├── remy-actions/ └── … second-brain-skills/ ├── second-brain-mine/ └── …

Remy dashboard

/home-<userId>/remy-artifacts/
dashboard.html clients.json meetings.json actions.json focus.json drafts.json scheduler.json setup.json install.json clients/ meetings/ drafts/ <id>/

The user's client memory

→ CLIENT MEMORY
/home-<userId>/second-brain/clients/<clientId>/
14 topic pages · actions.md · meetings.md · changes.md · documents.md · actions/<id>.email.md · _meta/, plus team and organisation memories at /<team>/clients/ and /<organisation>/clients/; client documents at /remy/clients/<Client>/, linked, never copied.

One writer per path

Memory as Markdown

Layout declaration

Everything Remy is and produces is a folder or a file in the knowledge base. Three trees, as an operator sees them.

How Remy reaches a deployment
Production default

In the platform image

Ships with the agent runtime; mounted on any space that declares Remy as its vertical.
Design phase · retuning · bank-authored skills

In the knowledge base

Skill tree pushed to a skills folder; the space points its Skills tool at it. No deploy.
Local development
Demo seeds a full installation from fixtures, never a real home Administration tool laptop-only, never deployed Publish pushes the skill tree End-to-end test real space, real install check · map · versions