Description
HUMAN.md Personalization gives users a durable way to tell Dots who they are and how an assistant should work with them. The Settings surface lists HUMAN.md documents, supports creating and editing their markdown content, and selects a global active document. Chat can override that choice per conversation through the Context Picker, making different working identities or guidance available for different projects.
The AI can also help author HUMAN.md content without writing behind the user’s back. Builder mode returns a proposed create or update as a conversation chip; the user reviews the target and content, then explicitly confirms or discards it. Confirmed updates travel through the live client and refresh the document catalog, while unresolved proposals remain visible in the conversation record.
Selling Points
- Makes personalization explicit, inspectable, and user-owned rather than burying behavioral assumptions in an opaque profile.
- Supports multiple working identities, letting one person use different guidance for leadership, research, or client contexts.
- Carries the active HUMAN.md into Chat consistently while still allowing a conversation-specific choice.
- Lets AI assist with drafting improvements without granting it silent write authority over personal guidance.
- Stores personalization as durable workspace knowledge that can be reviewed and edited over time.
User Story
A consultant keeps separate HUMAN.md documents for executive advising and research. They select the executive document globally, switch one research conversation to the alternate document, and ask Builder mode to improve its source-handling guidance. Chat presents the proposed edit, and the consultant confirms it only after reviewing the changes.
Extension Surface
The feature is configurable through user-authored documents and active selection. apps/web/src/modules/shell/settings/tabs/human-md/HumanMdTab.tsx manages the document catalog and editor, while packages/parts/src/composer/context-picker/HumanMdScreen.tsx selects per-conversation guidance. The document format is open markdown, but supported injection and proposal behavior remain product-defined.
Capabilities & Limits
- Creates, edits, lists, and selects HUMAN.md documents.
- Supports global personalization and per-conversation overrides.
- Presents AI-authored create or update proposals with explicit confirm and discard actions.
- Limit: Chat cannot silently accept a HUMAN.md proposal, and only active readable documents can be selected for a conversation.
Implementation Map
apps/web/src/modules/shell/settings/tabs/human-md/HumanMdTab.tsxapps/web/src/modules/shell/settings/tabs/human-md/human-md-client.tspackages/parts/src/composer/context-picker/HumanMdScreen.tsxapps/web/src/modules/chat/components/human-md/HumanMdProposalChipRenderer.tsx