UX Principles — Knowledge Hub
UX Principles — Knowledge Hub
Section titled “UX Principles — Knowledge Hub”Status: Canonical product UX direction. Source: Extracted from
ads-v1.md §6 (10 February 2026) before that document was archived. The 13
principles below remain the canonical UX framework for Knowledge Hub regardless
of the technology stack drift in the rest of ADS v1.0. See also:
docs/reference/ai-visibility-policy.md (AI framing rules),
docs/design/warm-meridian-philosophy.md (visual design system),
docs/reference/state-of-the-product.md §11 (product direction).
The 13 Governing Principles
Section titled “The 13 Governing Principles”When principles conflict, lower-numbered principles take precedence over higher-numbered ones.
| # | Principle | Summary |
|---|---|---|
| 1 | The Tool Disappears; the Work Remains | AI never announces itself. |
| 2 | Coordinator Directs; Tool Executes | Coordinator is orchestrator, not editor. |
| 3 | Content Anchors Everything | Every AI contribution cites sources. |
| 4 | Interface Density Scales with Involvement | Less UI when AI is confident, more when human input is needed. |
| 5 | Speed is a Feature | Sub-100ms micro-feedback. |
| 6 | Progressive Disclosure, Two Levels Maximum | Never more than two expansion levels. |
| 7 | The Platform Goes to People | SMEs interact via email and tokenised links. |
| 8 | Silence is Part of the UX | Default to silence. No global notification bell. |
| 9 | Honesty Over Optimism | ”I don’t have content for this yet” over a weak guess. |
| 10 | Security by Default | Domain verification, attestation identity-pinned, audit trail. |
| 11 | Education Through Use | Features teach themselves through contextual guidance. |
| 12 | Resist Enterprise Heaviness | This is for SMBs. No mandatory fields, no sequential approvals. |
| 13 | Accessible by Design | WCAG 2.1 AA. Never colour alone. Always keyboard-accessible. |
Navigation Model
Section titled “Navigation Model”Four primary views: Home (Activity & Action Centre), Working Session, Content Library, Settings.
- Persistent header with Cmd+K command palette
- No sidebar, no hamburger, no global nav links, no notification bell
Speed Targets
Section titled “Speed Targets”| Category | Target |
|---|---|
| Micro-feedback (button presses, toggles) | 100-150ms |
| Small transitions (panel expand, drawer slide) | 200-300ms |
| Medium transitions (page navigation) | 300-500ms |
| AI streaming | 5ms per character (200 chars/second) |
Extracted from ads-v1.md §6 (now archived to
.planning/.archive/.reference/ads-v1.md) on 7 April 2026 as part of S151 Task
17b. Principles unchanged from the 10 February 2026 source.