meldestelle/docs/04_Agents
2026-04-12 17:43:48 +02:00
..
_archive Archive outdated journal logs and documents. Add Postman Runbook structure and centralize API testing documentation. Update Flyway configuration for ping-service with service-specific schema history. 2026-04-03 21:48:39 +02:00
Besprechung_2026-04-03 Archive outdated journal logs and documents. Add Postman Runbook structure and centralize API testing documentation. Update Flyway configuration for ping-service with service-specific schema history. 2026-04-03 21:48:39 +02:00
Journal Add documentation and templates for Start-/Ergebnislisten v07: Introduce foundational templates, print styles and partials, and consolidate related session notes. 2026-03-30 22:55:51 +02:00
Logs Convert Serie and SeriePunkt from data class to regular class, implement manual copy, equals, hashCode, and toString methods for JPA compliance, adjust column mappings, and add Flyway migration for database schema creation. 2026-04-12 17:43:48 +02:00
Playbooks Audit and enhance playbook documentation: fix path inconsistencies, add missing "Abschluss" sections, standardize "Curator" frontmatter, and update Agent roles in README 2026-03-25 23:58:39 +01:00
Roadmaps Remove veranstalter-feature (repositories, UI components, and domain models). 2026-04-11 13:29:08 +02:00
Sessions feat(docs): finalize editing forms guideline and define empty state specification 2026-04-03 11:54:44 +02:00
README.md Audit and enhance playbook documentation: fix path inconsistencies, add missing "Abschluss" sections, standardize "Curator" frontmatter, and update Agent roles in README 2026-03-25 23:58:39 +01:00
SessionLog_2026-03-30.md docs(ROADMAP & SessionLog): add nightly roadmap and session log for 2026-03-30 updates 2026-03-30 17:14:52 +02:00

type status owner
Reference ACTIVE Lead Architect

Agent Operating Model (AOM)

Dieses Verzeichnis definiert, wie KI-Unterstützung im Projekt eingesetzt wird: Rollen/Playbooks, Ablageorte und der minimale Prozess, damit Wissen nicht verloren geht.

Governance (Konfliktregel)

  • Single Source of Truth: docs/
  • Tooling/Automatisierung: .junie/ (Scripts, Checks, optional Archiv keine zweite „Wahrheit“)
  • Personas-Übersicht: AGENTS.md (Repo-Root)

Wenn Aussagen in .junie/* und docs/* widersprechen, gilt docs/*.

Artefakt-Vertrag (Anti-Wissensverlust)

Jede KI-Session endet mit genau einem Artefakt in docs/:

  1. ADR (docs/01_Architecture/adr/) Entscheidung/Optionen/Trade-offs (Status proposed ist erlaubt)
  2. Reference (passender Bereich) Fakten/Ist-Zustand/Inventar
  3. How-to / Runbook (passender Bereich) konkrete Schritte (Setup/Betrieb/Recovery)
  4. Journal Entry (docs/99_Journal/) Kurzprotokoll, wenn nichts „fertig“ wird

Tool-Rollen (keine Doppelarbeit)

  • Junie (IDE-nah): Code/Repo-Wahrheit (Dateien, konkrete Implementierung, Refactors)
  • Gemini (parallel/extern): Variantenraum (Optionen, Argumentation, Formulierungen, Gegenentwurf)

„Wahr“ wird es erst, wenn es im passenden docs/* Artefakt verankert ist.

Playbooks

Playbook Rolle Typ
Playbooks/Architect.md 🏗️ Lead Architect Strategie, Planung, Build-System
Playbooks/BackendDeveloper.md 👷 Backend Developer Spring Boot, Kotlin, DDD
Playbooks/Curator.md 🧹 Curator Dokumentation, Wissensmanagement
Playbooks/DevOpsEngineer.md 🐧 DevOps Engineer Docker, CI/CD, Infrastruktur
Playbooks/DomainExpert.md 📋 Domain Expert Fachlichkeit, Regelwerke, Gherkin
Playbooks/FrontendExpert.md 🎨 Frontend Expert KMP, Compose, Offline-First
Playbooks/Gemini.md 🤖 Gemini (extern) Konzeptarbeit, Optionen, ADR-Formulierung
Playbooks/Junie.md 🤖 Junie (IDE) Repo-nahe Arbeit, Code, Implementierung
Playbooks/QASpecialist.md 🧐 QA Specialist Teststrategie, Edge-Cases
Playbooks/RulebookExpert.md 📜 ÖTO/FEI Rulebook Expert Regelwerks-Compliance, Validierung
Playbooks/UIUXDesigner.md 🖌️ UI/UX Designer High-Density Design, Wireframes