Skip to main content

🎯 Speedback – Epic

Purpose: AI-assisted feedback template where each bullet is independently generated from keywords.

Tagline: "It's a match!"


Business Value​

Speedback solves a real pain point: writing structured feedback takes too long. HR departments use the Speedback format (Strengths β†’ Development) but most people struggle to articulate feedback clearly.

Problem: 30+ minutes to write one Speedback Solution: 90 seconds with AI-assisted bullet generation Value: Keywords β†’ Generate β†’ Edit β†’ Export

Target Users:

  • HR teams running annual feedback rounds
  • Managers giving regular feedback
  • Team members participating in peer feedback

Revenue Model: Freemium (Phase 2)

  • MVP: Unlimited (no limits)
  • Pro: CHF 9/month (unlimited) - Phase 2
  • Team: CHF 29/month (5 seats) - Phase 3

Core Insight​

The template IS the interface.

Monolithic GenerationComponent Approach βœ“
Generate entire docGenerate bullet by bullet
All or nothingMix human + AI
Hard to editEdit one line easily
Feels AI-writtenFeels like YOUR words

Scope​

What This Product Covers​

Phase 1 (MVP) - DONE:

  • Bullet component (keywords β†’ generate β†’ edit)
  • Strength section (3 bullets)
  • Development section (3 bullets)
  • Remarks (free text)
  • Export: Copy, Markdown
  • Free tier limits (5 bullets/day) β†’ Unlimited for MVP
  • German language
  • No auth required (public endpoints)

Phase 2 (Monetization):

  • User accounts
  • Stripe payments
  • PDF export
  • Email sending
  • History (30 days)

Phase 3 (Team):

  • Team dashboard
  • Shared templates
  • Analytics

What This Product Does NOT Cover​

  • ❌ Full document editing (this is a structured feedback template)
  • ❌ Multi-language (English later)
  • ❌ Custom template builder
  • ❌ Integration APIs
  • ❌ Mobile app

Reuse Notes​

ComponentStatusNotes
Text generate APIβœ… Ready/api/ai/text/generate
Auth systemβœ… ReadyPhase 2
Rate limitingβœ… ReadyPhase 2 (if needed)
Stripe integrationβœ… ReadyPhase 2

Current Status (2026-01-20)​

Phase 1 MVP: 90% Complete (Frontend done, ready to deploy)

Scope Adjustments​

  • Auth: Deferred to Phase 2 (endpoints public for MVP)
  • Free tier limits: Unlimited for MVP (add limits in Phase 2 if needed)
  • AI Provider: Groq (free tier) instead of Ollama

Tasks​

#TaskDependenciesEffortPriorityStatus
1Bullet Componentβ€”1 dayHighDONE
2Speedback Form11 dayHighDONE
3Export (Copy/MD)20.5 dayHighDONE
4Landing Pageβ€”0.5 dayHighDONE
5Deploy1-40.5 dayHighPENDING
6User Accounts51 dayMediumBACKLOG
7Stripe Integration61 dayMediumBACKLOG
8PDF Export30.5 dayMediumBACKLOG

Task 1: Bullet Component​

The core component. States: Empty β†’ Generating β†’ Generated β†’ Editing

Files:

  • client/src/app/modules/speedback/components/bullet/
  • server/src/main/java/com/saas/speedback/api/BulletController.java

API:

POST /api/v1/speedback/bullet
{
"type": "strength" | "development",
"recipient": "Jasmin",
"keywords": "hilft spontan",
"language": "de"
}

Task 2: Speedback Form​

Full form with Header, Sections, Remarks.

Files:

  • client/src/app/modules/speedback/pages/speedback-form/
  • client/src/app/modules/speedback/components/section/
  • client/src/app/modules/speedback/components/header/

Task 3: Export​

Copy to clipboard, Markdown download.

Files:

  • client/src/app/modules/speedback/services/export.service.ts

Task 4: Landing Page​

Marketing page at / before login.

Task 5: Deploy​

Deploy to speedback.ch (or speedback.app).


System Prompts​

Strength Bullet (German)​

Du hilfst beim Schreiben von Feedback.

KONTEXT:
- Das ist ein "StΓ€rken"-Punkt in einem Speedback
- EmpfΓ€nger: {recipient_name}
- Format: Verhalten β†’ Wirkung β†’ Empfehlung

AUFGABE:
Erweitere diese Stichworte zu EINEM Feedback-Satz.

STICHWORTE: {keywords}

REGELN:
- Maximal 1-2 SΓ€tze
- Ich-Botschaft
- Ende mit: "behalte das bei" / "mach weiter so"
- NUR den Bullet-Text ausgeben

Development Bullet (German)​

Du hilfst beim Schreiben von Feedback.

KONTEXT:
- Das ist ein "Entwicklung"-Punkt in einem Speedback
- EmpfΓ€nger: {recipient_name}
- Format: Verhalten β†’ Wirkung β†’ Wunsch

AUFGABE:
Erweitere diese Stichworte zu EINEM Feedback-Satz.

STICHWORTE: {keywords}

REGELN:
- Maximal 1-2 SΓ€tze
- Ich-Botschaft
- Konstruktiv, nicht kritisch
- Ende mit konkretem Wunsch
- NUR den Bullet-Text ausgeben

Success Criteria​

Week 1​

  • Use it for real Speedback session
  • Complete feedback in < 2 minutes
  • Output is HR-ready

Month 1​

  • 100+ completed speedbacks
  • 10+ paying users
  • CHF 90+ MRR

Validation Complete When​

  • Someone you don't know signs up
  • First paying customer
  • Colleague asks "what tool is this?"

Non-Goals​

  • ❌ Competing with full HR software
  • ❌ Building a platform
  • ❌ Multi-language support (Phase 1)
  • ❌ Enterprise features

Architecture Decision​

Frontend: Keep Angular vs. switch to Next.js

Keep AngularSwitch to Next.js
Reuse existing codeFresh start
Faster to MVPModern React patterns
Same deploymentSSR/SEO benefits

Decision: Keep Angular for Phase 1 (speed to market).

Backend: Use the existing server. Add Speedback-specific endpoints as needed.


Dependencies​

External dependencies and blockers for this epic:

DependencyTypeStatusImpact
AI generationInternalβœ… ReadyBullet generation + rewrite
LLM provider (Groq)Externalβœ… ReadyModel used for MVP
AuthInternalβœ… ReadyPhase 2
Rate limitingInternalβœ… ReadyPhase 2 (if needed)
Payments (Stripe)Externalβœ… ReadyPhase 2
Angular frontendInternalβœ… ReadyUI framework


Last Updated: 2026-01-20