Claude
9b18e2710d
- /docs/ now contains 12 numbered guides + index.md (navigator).
- Old duplicates removed: nexa-core/doc/, DEPLOYMENT.md, PLAN.md,
config/{classification_logic,workflows_spec}.md.
- 09-deployment.md targets the running infra (LXC 104 docker host,
Zoraxy at 192.168.1.4, existing Memos/n8n/LiteLLM/Nextcloud/Qdrant)
rather than spinning a parallel stack; minimal-config approach.
- 11-open-questions.md tracks user-info-required blockers.
- 12-optimization-opportunities.md captures homelab tweaks.
- CLAUDE.md added so future agent runs know repo conventions and infra.
35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# 01 — Vision & Scope
|
|
|
|
## Vision
|
|
|
|
Nexa is the **central nervous system** of a personal IT setup: an intelligent middleware sitting between input sources (Memos, e-mail, RSS, Karakeep, Bluesky), knowledge stores (Obsidian, Qdrant, Nextcloud) and organization tools (Nextcloud Calendar/Tasks).
|
|
|
|
### Core goals
|
|
|
|
- **Cognitive offload** — Nexa sorts, filters and proposes; it doesn't just store.
|
|
- **Context separation** — clean AI-driven split between *Work* and *Personal*.
|
|
- **Single point of interaction** — Memos is the primary surface ("voice & ear").
|
|
- **Knowledge synergy** — link ephemeral memos to deep notes via semantic search.
|
|
|
|
## Scope
|
|
|
|
### In-scope
|
|
|
|
- Triaging ~20 personal e-mails per day.
|
|
- Routing tasks to the right Nextcloud list (Work vs. Personal).
|
|
- Suggesting time-boxes in the work calendar.
|
|
- Long-term memory in Qdrant (and optionally a graph DB).
|
|
- Aggregating critical IT alerts (Proxmox, Backrest) into a Memos system feed.
|
|
|
|
### Out-of-scope
|
|
|
|
- Direct access to work IT (work mail, work servers).
|
|
- Active document editing (metadata extraction only).
|
|
- Replacing specialist UIs (Arcane / Dozzle / Portainer for containers).
|
|
|
|
## Success metrics
|
|
|
|
- **Reduced mail interaction** — less time in the mail app, more on the Nexa digest.
|
|
- **Calendar fill-rate** — focus slots auto-blocked on the work calendar.
|
|
- **Search latency** — old memos / Obsidian notes resurface instantly via `#nexa:ask`.
|