Spec, research, data model, API contract, implementation plan, and task breakdown for the public event detail page. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.8 KiB
3.8 KiB
fete
A privacy-focused, self-hostable PWA for event announcements and RSVPs. Alternative to Facebook Events or Telegram groups — reduced to the essentials.
Constitution
Project principles, constraints, tech stack, and governance are defined in .specify/memory/constitution.md. That file is the single source of truth — read and follow it.
Language
- Conversation and brainstorming: German.
- Code, comments, commits, documentation: English — no exceptions.
Build Commands
| What | Command |
|---|---|
| Backend test | cd backend && ./mvnw test |
| Backend run | cd backend && ./mvnw spring-boot:run |
| Frontend install | cd frontend && npm install |
| Frontend build | cd frontend && npm run build |
| Frontend test | cd frontend && npm run test:unit |
| Frontend dev | cd frontend && npm run dev |
| Backend checkstyle | cd backend && ./mvnw checkstyle:check |
| Backend full verify | cd backend && ./mvnw verify |
Agent Documentation
- Feature specs, research, and plans:
specs/[NNN-feature-name]/(e.g.specs/006-create-event/spec.md,research.md,plan.md) - Cross-cutting research:
.specify/memory/research/ - Cross-cutting plans:
.specify/memory/plans/ - Agent test reports (browser verification):
.agent-tests/(gitignored) - Use the
browser-interactive-testingskill (rodney/showboat) for visual verification — this is an agent tool, not manual work.
Skills
The following skills are available and should be used for their respective purposes:
| Skill | Trigger | Purpose |
|---|---|---|
rpi-research |
Deep codebase investigation needed | Conducts thorough research and produces a written report. Use for understanding how something works before changing it. |
rpi-plan |
Feature, refactor, or bug fix needs planning | Creates detailed, phased implementation plans through interactive research and iteration. |
rpi-implement |
Approved plan ready for execution | Executes approved implementation plans phase by phase with automated and manual verification. |
browser-interactive-testing |
Visual verification of web pages | Headless Chrome testing via rodney/showboat. Use for screenshots, browser automation, and visual test reports. |
Ralph Loops
- Autonomous work is done via Ralph Loops. See .claude/rules/ralph-loops.md for documentation.
- The loop runner is
ralph.sh. Each run lives in its own directory under.ralph/. - Run directories contain:
instructions.md(prompt),chief-wiggum.md(directives),answers.md(human answers),questions.md(Ralph's questions),progress.txt(iteration log),meta.md(metadata),run.log(execution log). - Project specifications (user stories, setup tasks, personas, etc.) live in
specs/(feature dirs) and.specify/memory/(cross-cutting docs).
Active Technologies
- Java 25 (backend), TypeScript 5.9 (frontend) + Spring Boot 3.5.x, Vue 3, Vue Router 5, openapi-fetch, openapi-typescript (007-view-event)
- PostgreSQL (JPA via Spring Data, Liquibase migrations) (007-view-event)
Recent Changes
- 007-view-event: Added Java 25 (backend), TypeScript 5.9 (frontend) + Spring Boot 3.5.x, Vue 3, Vue Router 5, openapi-fetch, openapi-typescript