Public usefulness
Can projects, methods and decisions be shared, indexed and understood independently?
System architecture · Privacy · Knowledge design
KhaiTriOS will publish reusable proof, principles, playbooks and public-safe decisions while credentials, personal memory, client-sensitive information and private AI context remain in a separately protected layer.
01 · Context
KhaiTriOS has two different jobs. It should publicly demonstrate how projects are built and how decisions are made, while eventually giving AI assistants richer personal and operational context.
Those jobs require different trust boundaries. Public pages benefit from indexing, links and reusable explanations. Private context may contain credentials, personal memory, client details, account identifiers, raw conversations and assumptions that should never be published.
The architectural decision was required before expanding the public system or building the private AI layer, because mixing both types of knowledge in one location would make every future publication riskier.
02 · Decision criteria
Can projects, methods and decisions be shared, indexed and understood independently?
Can credentials, personal data and sensitive operating context remain protected by default?
Can approved context later be packaged for multiple assistants without publishing it?
Can a contributor tell where information belongs and which layer is authoritative?
Can the boundary evolve without rewriting or deleting public history?
Can visitors and collaborators understand what is deliberately excluded?
03 · Options considered
Place public knowledge, personal memory, credentials and AI context in one repository or website.
Use one protected vault and publish only the conventional portfolio.
Maintain a public OS for reusable records and a private vault for sensitive context.
The public layer contains only information that can be intentionally shared: operating principles, project records, playbooks, decision records, roadmap and changelog. The private layer will later contain identity context, raw memory, credentials, sensitive decisions, client data and assistant-specific context packs.
Public knowledge should default to shareable. Private memory should default to protected.
The private layer can preserve useful detail without forcing every note through a public-writing filter.
Visitors can evaluate real architecture and reasoning without needing access to private records.
Approved private context can later be packaged for different assistants while the public URLs remain stable.
05 · Consequences
Projects, playbooks and decisions can be indexed, linked and evaluated independently.
Sensitive memory does not need to be weakened into vague public language.
Context packs can be assembled by task and tool instead of exposing the complete vault.
A private source may require a public-safe summary before it becomes publishable.
New records must be checked for personal data, credentials and commercially sensitive context.
The private vault will need its own structure, history and access controls when implementation begins.
06 · Publishing guardrails
07 · Evidence to date
Principles, roadmap, changelog and privacy language were published without private credentials or personal memory.
Scent OS, AGVN, Airbnb Operations and Advertising Dashboards preserve architecture and lessons while excluding sensitive operating data.
Reusable methods became public without publishing client identities, private pricing, raw prompts or account details.
This decision record documents the choice and defines how future evidence can challenge it.
Derived lesson
The decision explains why the layers are separate. LSN-001 explains what future publishing workflows must do to keep that separation effective.
Classification, transformation, validation and human ownership turn the architecture decision into repeatable publishing behavior.
08 · Review plan
Confirm the private vault architecture and access model before creating AI context packs.
Test whether summarization preserves enough value or whether the record should remain private.
Review permissions, context minimization and update ownership.
Consider tooling or metadata links without merging the trust boundaries.
Decision status
This record remains active until a later decision reverses or supersedes the public/private architecture.