MVP User Stories
The user stories that were actually delivered in the YapHub MVP, organized by feature area.
Overview
The MVP delivers a complete Slack-native knowledge management system with AI summaries, digest distribution, and Notion sync.
Status: Complete
Knowledge Capture
- US-001: As a user, I can save any Slack message as knowledge via the message shortcut (three-dot menu → "Add to YapHub")
- US-002: As a user, I can quickly add knowledge from anywhere in Slack via the global shortcut
- US-003: As a user, I can add knowledge from the App Home dashboard
- US-004: As a user, when I save knowledge with a URL, the system automatically extracts and appends the page content
- US-005: As a user, my knowledge items are automatically synced to Notion pages
Category Management
- US-006: As a user, I can create categories (thematic lists) with name, description, and emoji icon from the App Home
- US-007: As a user, categories are synced bidirectionally with Notion
- US-008: As a user, I can configure digest settings per category (frequency, day, time)
- US-009: As a user, I can see categories with their target groups in the App Home
AI Summaries
- US-010: As a user, the system generates 2-3 sentence Dutch AI summaries for my knowledge items during digest creation
- US-011: As a user, summaries are generated only when needed (lazy) and cached for reuse
- US-012: As a user, if the AI fails, the system gracefully falls back to truncated content
Digest Generation
- US-013: As a user, I can generate a digest for any category with a configurable date range (last N days, date range, all time)
- US-014: As a user, digests are formatted as Dutch Markdown with per-item AI summaries, tags, and Notion links
- US-015: As a user, digests are persisted and synced to Notion with full content embedding
- US-016: As a user, digests include statistics (item count, day count) and an immutable snapshot of highlights
Digest Distribution
- US-017: As a user, I can distribute a digest to all subscribers of its category
- US-018: As a user, I receive digests as formatted Slack DMs
- US-019: As an admin, I can track per-user delivery status and retry failed deliveries
- US-020: As a user, the initiator of a digest always receives a copy
Subscriptions
- US-021: As a user, I can subscribe to categories via the App Home overflow menu
- US-022: As a user, I can unsubscribe from categories (soft-delete preserving history)
- US-023: As a user, I can see my subscription status per category in the App Home
Notion Integration
- US-024: As a user, knowledge items are synced to Notion on creation with full properties
- US-025: As a user, categories are synced bidirectionally (local ↔ Notion)
- US-026: As a user, digests are synced to Notion with embedded Markdown content
- US-027: As a user, subscriptions are synced to Notion
- US-028: As an admin, I can pull knowledge and categories from Notion into the local database
App Home
- US-029: As a user, the App Home shows a dynamic dashboard with quick action buttons, statistics, and category list
- US-030: As a user, each category card has an overflow menu with contextual actions
Deferred Stories
These stories were planned but not implemented in the MVP:
- Slash commands (
/knowledge add,/knowledge digest,/knowledge search) - Per-role AI summaries (multiple summaries per item for different audiences)
- Prompt template management (CRUD for AI prompts)
- Summary editing UI (edit, regenerate, history)
- Knowledge edit/delete UI
- Advanced search with filters
- URL validation service
- PDF/RSS/YouTube content extraction
- Email delivery channel
- User authentication system
- Analytics dashboard
Related Documentation
- MVP Scope — Detailed feature and architecture documentation
- MVP Roadmap — Development timeline
- E2E Flow — Complete system flow diagram
- Weekly Reports — Week-by-week development logs