innovatieplatform/CLAUDE.md

Innovatieplatform — R&D Lab Waterschap Brabantse Delta

Project

Innovation governance platform supporting the full lifecycle of innovation trajectories — from signal to handover — with built-in AI support.

Wiki (source of truth): https://gitea.wbd-rd.nl/vps1_gitea_admin/innovatieplatform/wiki/ Repo: https://gitea.wbd-rd.nl/vps1_gitea_admin/innovatieplatform

Tech Stack

• Backend: Laravel (latest LTS) — service-oriented, event-driven, API-first
• Frontend: Vue 3 + Composition API + Vite + Inertia.js
• Database: PostgreSQL 16+ with pgvector extension
• AI Service: Python (FastAPI + LangGraph + RAG pipeline)
• Queue: Redis + Laravel Horizon
• Infrastructure: Docker Compose (nginx, php-fpm, queue worker, scheduler, ai-service, postgresql, redis)

Architecture Principles

• Service-oriented: domain logic in service classes, not controllers
• Event-driven: status transitions via events → listeners
• API-first: all functionality available via API
• Audit trail: all mutations logged (append-only)
• AI content labeled: never auto-published without human confirmation

Build Agents

All agent definitions are in .claude/agents/:

1. orchestrator — coordination, planning, task distribution
2. domain-architect — domain model, functional design, acceptance criteria
3. solution-architect — technical architecture, integration, technology
4. backend-engineer — Laravel development, APIs, services, tests
5. frontend-engineer — Vue 3 components, Inertia pages, UX
6. data-modeler — database schema, migrations, pgvector, seeds
7. ai-engineer — Python AI service, RAG, LangGraph, prompts
8. devops-engineer — Docker, deployment, infrastructure
9. security-specialist — RBAC, audit, compliance, review
10. doc-designer — documentation structure, handover, knowledge design

MVP Scope (8 weeks)

• Project CRUD with innovation lifecycle phases
• Commitments & actions with owner/deadline
• Basic documentation (upload, link, search)
• Simple roadmap visualization
• RBAC (admin, project_owner, team_member, viewer)
• Basic AI chat + project summaries + semantic search
• Dashboard with personal overview

What Requires Human Validation

• Architecture decisions
• Domain model changes
• UX/design choices
• Scope changes
• AI behavior and prompt templates
• Security findings
• Handover process definitions