NAVIGATOR The tour Sign in

Technical appendix

How the coach reasons

The architecture of a grounded, private advisory system.

§1The problem shape

Generic AI chat fails at organizational politics in three ways. It forgets the field: the coalition that formed in January is gone from March's conversation. It has no method: asked for advice, it gives advice, even when the right first move is to ask what the asker hasn't noticed. And it isn't grounded: the counsel may come from scholarship or from plausible-sounding air, and there is no way to tell.

The Navigator is built against those failures: a durable record of the user's field, a method that asks before it prescribes, and a curated body of knowledge behind every reply.

§2The reasoning stack

Every consult assembles its context fresh from three layers: the method, the knowledge, and the record.

The charter the method and the ethic, fixed in code The knowledge the curated library plus the user's own additions; cards always present, deep sections selected per question The record this user's situations, people, relationship ties, and intel log, theirs alone One consult context assembled fresh, per question counsel, streamed in the coach's own voice FIG. 1 · CONTEXT ASSEMBLY
Three layers, one context. Nothing reaches the model but the method, the knowledge, and this user's own record.

§3The loop, not the answer

The unit of value is a working loop: map, read, move, rehearse, debrief. When the record is thin, the coach interviews before it advises. Its reads separate what the record documents from what it infers and what is unknown. Its recommendations come in order, with the actual language to use. It will play the counterpart in character so a hard conversation is rehearsed before it is real, and it will red-team a plan before reality does.

The model never writes to the record. Profiles, situations, and updates arrive as proposals the user applies with one click, or doesn't. Every debrief sharpens the next read.

§4Knowledge, distilled and selected

Sources enter through an absorb pipeline that runs in the browser: read locally, distilled section by section, each distillation audited against its source for gaps, then stored as a card plus deep sections. The synthesis is stored, never the source.

At consult time the cards always ride along. When the deep material exceeds the context budget, a fast model selects the sections relevant to the question. The selection never shows in the reply; the coach answers in its own voice. Retrieval is deliberately simple for a corpus this size, with a vector-search upgrade path left open.

§5Isolation and trust

Accounts
Neon Auth (managed Better Auth). Sessions live in a secure, HttpOnly cookie; the client mints short-lived tokens from the session for its own API calls.
Verification
Every API request's token is checked against the auth server's published keys (JWKS). The user id comes from the verified sub claim, never from the client.
Isolation
Every row carries its owner and every query is owner-scoped. No cross-user read path, no admin view into a user's record.
Observability
A health endpoint reports the deployed commit, configuration, a live database ping, and a live auth probe. What is running is inspectable.

§6The stack, plainly

Frontend
Static pages and a single-file application. Zero runtime dependencies.
Backend
Five serverless edge functions. One dependency (jose, for token verification).
Data
Neon Postgres: records, knowledge, consult history, and the auth schema, with branch-per-environment isolation for safe testing.
Models
Claude: the strongest tier for counsel, a mid tier for distillation, a fast tier for relevance selection. Prompt caching holds the stable layers.

The system is small on purpose. The claim isn't scale; it's that grounded, methodical, private counsel can be assembled from first principles.

Navigator The tour