π― 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 Generation | Component Approach β |
|---|---|
| Generate entire doc | Generate bullet by bullet |
| All or nothing | Mix human + AI |
| Hard to edit | Edit one line easily |
| Feels AI-written | Feels 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β
| Component | Status | Notes |
|---|---|---|
| Text generate API | β Ready | /api/ai/text/generate |
| Auth system | β Ready | Phase 2 |
| Rate limiting | β Ready | Phase 2 (if needed) |
| Stripe integration | β Ready | Phase 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β
| # | Task | Dependencies | Effort | Priority | Status |
|---|---|---|---|---|---|
| 1 | Bullet Component | β | 1 day | High | DONE |
| 2 | Speedback Form | 1 | 1 day | High | DONE |
| 3 | Export (Copy/MD) | 2 | 0.5 day | High | DONE |
| 4 | Landing Page | β | 0.5 day | High | DONE |
| 5 | Deploy | 1-4 | 0.5 day | High | PENDING |
| 6 | User Accounts | 5 | 1 day | Medium | BACKLOG |
| 7 | Stripe Integration | 6 | 1 day | Medium | BACKLOG |
| 8 | PDF Export | 3 | 0.5 day | Medium | BACKLOG |
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 Angular | Switch to Next.js |
|---|---|
| Reuse existing code | Fresh start |
| Faster to MVP | Modern React patterns |
| Same deployment | SSR/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:
| Dependency | Type | Status | Impact |
|---|---|---|---|
| AI generation | Internal | β Ready | Bullet generation + rewrite |
| LLM provider (Groq) | External | β Ready | Model used for MVP |
| Auth | Internal | β Ready | Phase 2 |
| Rate limiting | Internal | β Ready | Phase 2 (if needed) |
| Payments (Stripe) | External | β Ready | Phase 2 |
| Angular frontend | Internal | β Ready | UI framework |
Related Documentsβ
- Speedback Final Spec β Detailed UI/UX specification
- Roadmap β Delivery phases and backlog
- Architecture β Technical decisions
- Progress Report β Current status and what's done
- MVP Launch Plan β Detailed implementation plan
- Strategic plan (internal): see
_wip/strategic-plan-2026-01-20.md
Last Updated: 2026-01-20