docs: start milestone v1.5 Smart Onboarding + Personal AI Assistant

This commit is contained in:
Nexus Dev 2026-04-02 20:11:58 +00:00
parent 8ae8e526d9
commit 9caedf895e
2 changed files with 46 additions and 32 deletions

View file

@ -4,7 +4,7 @@
Nexus is a personal fork of Paperclip (MIT, v2026.318.0) that reframes the "companies with CEOs" corporate metaphor as "workspaces with agents." It's a project orchestration tool for a solo developer (Mikkel) managing AI agents across personal and professional projects. The fork stays mergeable with upstream by limiting changes to the display layer (UI strings, CLI output, agent templates, documentation) while leaving DB schema, API routes, code identifiers, and token formats unchanged.
v1.3 adds a full chat interface: real-time agent conversations with streaming, brainstormer workflow, file system, search/branching, and PWA support with offline capability and push notifications.
v1.3 added a full chat interface with streaming, brainstormer workflow, file system, search/branching, and PWA support. v1.4 made Hermes the default local provider with Ollama integration. v1.5 adds smart onboarding with hardware detection, tiered AI providers, and a Personal AI Assistant mode.
## Core Value
@ -32,17 +32,26 @@ A fresh onboard asks for ONE thing (root directory), auto-creates PM + Engineer
- ✓ Search, History & Branching (full-text search, bookmarks, branching, export) — v1.3
- ✓ File System (upload/preview/download, git versioning, voice input) — v1.3
- ✓ PWA & Performance (installable, offline, mobile responsive, push notifications) — v1.3
- ✓ Hermes adapter integration (spawn, heartbeat, session, skill sync, cost tracking) — v1.4
- ✓ Ollama detection, model listing, RAM/VRAM recommendations — v1.4
- ✓ Default provider logic (fallback to Hermes when no cloud provider) — v1.4
- ✓ Agent templates working with Hermes runtime — v1.4
- ✓ Dashboard Hermes-specific info (model, VRAM, native skills) — v1.4
### Active
- [ ] Onboarding redesign: root directory picker, auto-create PM + Engineer, skip to dashboard
- [ ] Terminology rename (display only): Company→Workspace, CEO→Project Manager, Board→Owner, Hire→Add, Fire→Remove, Paperclip→Nexus
- [ ] Predefined agent templates: PM and Engineer with sensible AGENTS.md, HEARTBEAT.md, SOUL.md, TOOLS.md
- [ ] Directory restructure: everything under user-chosen root, no ~/.paperclip/, human-readable agent dirs
- [ ] ~/.nexus pointer file mechanism (single file with root path)
- [ ] UI overhaul: Nexus branding, sidebar renames, dashboard cleanup, agent config page cleanup
- [ ] New Agent dialog: "Add Agent" button, predefined templates dropdown
- [ ] CLI output strings updated (paperclipai branding → nexus branding where display-only)
- [ ] Mode selection: Personal AI Assistant / Project Builder / Both
- [ ] Hardware detection with pre-built model database (GPU, Apple Silicon, CPU-only)
- [ ] Local AI setup via Ollama with RAM-aware model recommendations
- [ ] Voice features (Whisper + Piper) working on CPU-only hardware
- [ ] Zero-config cloud via Puter.js (no API keys, no sign-up)
- [ ] OAuth cloud tier (Google Gemini, OpenAI free tiers)
- [ ] Subscription/API key auto-detection (Hermes, Claude Code, OpenClaw)
- [ ] Personal AI Assistant with persistent memory, MCP, voice
- [ ] Project handoff: assistant conversation → PM with context transfer
- [ ] Summary screen → straight into chat
- [ ] `npx buildthis` CLI entry point
- [ ] Every onboarding step skippable
### Out of Scope
@ -133,16 +142,21 @@ After every `/gsd:complete-milestone`, perform an upstream rebase before startin
**Autonomous mode:** The autonomous workflow MUST check for this section and run the rebase after `complete-milestone` returns, before starting the next milestone.
## Current Milestone: v1.4 Hermes Default Provider
## Current Milestone: v1.5 Smart Onboarding + Personal AI Assistant
**Goal:** Make Hermes Agent the default local provider — Nexus works out of the box without any paid subscription or API key via Hermes + Ollama.
**Goal:** The definitive onboarding experience — hardware detection, tiered provider setup (local/free cloud/paid), and a Personal AI Assistant mode that coexists with the Project Builder.
**Target features:**
- Hermes adapter integration (spawn, heartbeat, session persistence, skill sync, cost tracking)
- Ollama detection, model listing, RAM/VRAM-based recommendations
- Default provider logic (fallback to Hermes when no cloud provider detected)
- Agent templates working with Hermes runtime
- Dashboard showing Hermes-specific info
- Mode selection (Personal AI Assistant / Project Builder / Both)
- Hardware detection with pre-built model database (GPU, Apple Silicon, CPU-only)
- Local AI setup via Ollama with RAM-aware model recommendations + voice (Whisper + Piper)
- Zero-config cloud via Puter.js (500+ models, no API keys)
- OAuth cloud tier (Google Gemini, OpenAI free tiers)
- Subscription/API key auto-detection (Hermes, Claude Code, OpenClaw)
- Personal AI Assistant with persistent memory, MCP, voice, project handoff
- Summary screen → straight into chat
- `npx buildthis` CLI entry point
- Every step skippable, local-first framed as privacy premium
---
*Last updated: 2026-04-02 after v1.4 milestone*
*Last updated: 2026-04-02 after v1.5 milestone started*

View file

@ -1,16 +1,16 @@
---
gsd_state_version: 1.0
milestone: v1.4
milestone_name: milestone
status: verifying
stopped_at: Completed 29-default-provider-29-02-PLAN.md
last_updated: "2026-04-02T17:44:25.937Z"
milestone: v1.5
milestone_name: Smart Onboarding + Personal AI Assistant
status: planning
stopped_at: null
last_updated: "2026-04-02T18:00:00.000Z"
last_activity: 2026-04-02
progress:
total_phases: 3
completed_phases: 3
total_plans: 6
completed_plans: 6
total_phases: 0
completed_phases: 0
total_plans: 0
completed_plans: 0
percent: 0
---
@ -20,15 +20,15 @@ progress:
See: .planning/PROJECT.md (updated 2026-04-02)
**Core value:** Nexus works out of the box without any paid subscription or API key.
**Current focus:** Phase 29 — default-provider
**Core value:** A fresh onboard asks for ONE thing (root directory), auto-creates PM + Engineer agents, and drops you in the dashboard.
**Current focus:** Defining requirements for v1.5
## Current Position
Phase: 29
Plan: Not started
Status: Phase complete — ready for verification
Last activity: 2026-04-02
Phase: Not started (defining requirements)
Plan:
Status: Defining requirements
Last activity: 2026-04-02 — Milestone v1.5 started
Progress: [__________] 0%