Skip to content

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