Sterling’s identity, safety rules, tools, persistent memory and skill catalog. Stable and always present.
How the agent system thinks, remembers and scales
This reference explains the working context, persistent memory, skills, compaction, durable evidence, local capacity, Cloudflare execution, and the signals that justify another Hermes agent or provider account.
The complete architecture
Different kinds of knowledge live in different layers. Efficiency comes from loading only the layer required for the current decision.
The current conversation, active task, loaded skills, retrieved evidence and recent tool output.
A tiny curated set of durable facts about Brad, preferences and operating boundaries.
Reusable procedures and focused chapters loaded only when their trigger applies.
Session transcripts, SQLite, D1, R2, checkpoints and source snapshots. Queried rather than injected wholesale.
Large organized knowledge
Thousands of Markdown references, database records and source snapshots are manageable when indexed and retrieved selectively. They do not consume the context window merely by existing.
Always loading everything
Huge persistent-memory files, giant main skills and raw project transcripts waste context. The solution is progressive disclosure, checkpoints and ranked retrieval—not deleting useful evidence.
Shared vocabulary
These are the exact terms Brad and Sterling should use.
The finite working space sent to the model for the current turn.
System instructions, conversation, loaded knowledge, retrieved evidence and tool results.
MEMORY.md and USER.md: compact, curated and always loaded.
Identity, safety, tools, environment, memory/profile and the skill catalog.
Files such as AGENTS.md or .hermes.md that define a project’s conventions.
An on-demand operating contract loaded when a task matches its trigger.
A separate linked file loaded only when that specific capability is needed.
Durable history in Hermes state.db; searchable, but not loaded wholesale.
A structured, lossy replacement for older turns inside a long session.
Current state, proof, blockers, approvals and the exact next action required to resume.
SQLite, D1, R2 or indexed files holding cases, sources, dates and architecture implications.
Separate configuration, memory, sessions, skills, cron jobs, credentials and gateway state.
The working context
What actually enters the model’s whiteboard and what stays outside it.
Automatically present
- Sterling’s identity and safety requirements
- Available tool definitions
- Persistent Memory and user profile
- Names and descriptions in the skill catalog
- The active conversation or compacted version
- Relevant project context discovered from the working directory
Not automatically present
- Every local file on the Mac
- Full bodies of every skill
- Every Cloudflare case study
- The complete session database
- Every Gmail, Drive or Google Chat message
- Raw source snapshots and large evidence stores
Persistent Memory
The small curated layer brought into every session.
MEMORY.md
Stable system and operating facts: approved boundaries, established architecture, recurring conventions and durable environment details.
USER.md
Stable facts about Brad: response preferences, approval expectations, naming conventions and durable working style.
Skills and deep knowledge
The main skill is a router. Focused references and indexed evidence contain the depth.
Triggers, boundaries, taxonomy and retrieval instructions.
Ranked records are retrieved for the active question. The entire library is never loaded at once.
Main skill
Short operating contract. Target approximately 15–20 KB. A main skill over 50 KB is a strong signal to split it.
Reference file
One decision boundary or capability. Loaded separately only when needed.
Database
Large, changing evidence. Queried by date, keyword, capability, job and architecture relevance.
Compaction and continuity
How Hermes protects a long conversation—and why durable checkpoints still matter.
What compaction does
- Prunes large old tool results where safe.
- Protects the initial exchange and recent messages.
- Summarizes goals, constraints, progress, blockers, decisions, files and next steps.
- Updates the prior summary on later compactions.
What compaction cannot guarantee
- Every minor detail survives.
- Project state becomes permanent memory.
- External systems are still in the state described.
- A summary replaces source-of-truth proof.
Compaction is continuity protection. The checkpoint is the durable project ledger.
Capacity and scaling decisions
Add resources for measured constraints or durable ownership—not merely because the knowledge library is large.
Use for isolated ownership
Separate memory, skills, sessions, cron, credentials, safety boundaries or public routes. A dedicated Marketing Machine builder is a logical future profile when continuous ownership competes with Sterling’s executive operations.
Use only for measured provider limits
Trigger on sustained throttling, quota exhaustion, unacceptable concurrency latency, security isolation or contractual requirements—not storage, Markdown count or ordinary compaction.
Cloudflare’s role
Cloudflare scales deterministic execution and durable systems. It does not replace the Hermes reasoning process or model context.
Reasoning and governance
- Interpret Brad’s goals
- Research and synthesize
- Choose tools and procedures
- Coordinate specialist agents
- Apply approvals and safety boundaries
- Explain decisions
Deterministic execution
- Workers and Workflows
- Queues and retries
- Durable Objects and locks
- D1 and R2 state/evidence
- Scheduled jobs and APIs
- Sanitized observability dashboards
Capacity metrics
Sanitized operational measurements from the recurring local audit. No prompts, message bodies, memory text, credentials, internal paths or raw logs are published.
Active capacity signals
Loading current audit…
Scaling recommendation
Loading current recommendation…
The full audit remains local on the Mac. This page receives only a strict aggregate projection. A manifest lock prevents the recurring metrics publisher from deploying if any unrelated Brad–Sterling2 file changes.