meldestelle/docs/04_Agents
Stefan Mogeritsch 7e16b3f318
Some checks failed
Build and Publish Docker Images / build-and-push (., backend/infrastructure/gateway/Dockerfile, api-gateway, api-gateway) (push) Has been cancelled
Build and Publish Docker Images / build-and-push (., backend/services/ping/Dockerfile, ping-service, ping-service) (push) Has been cancelled
Build and Publish Docker Images / build-and-push (., config/docker/caddy/web-app/Dockerfile, web-app, web-app) (push) Has been cancelled
Build and Publish Docker Images / build-and-push (., config/docker/keycloak/Dockerfile, keycloak, keycloak) (push) Has been cancelled
docs(roadmaps): add sprint execution order and detailed role-specific roadmaps
- Added `SPRINT_EXECUTION_ORDER.md` to define the cross-role sprint step sequence.
- Created individual roadmaps for Architect, Backend, Frontend, DevOps, Rulebook, QA, UI/UX, and Curator.
- Captured developer responsibilities, dependencies, and timelines for Sprints A–C.
- Aligned sprint planning documentation with session log agreements.
- Provided structured documentation in `docs/04_Agents/Roadmaps/`.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-04-02 14:35:54 +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 feat(horses-service): remove legacy configuration and repository classes 2026-03-23 13:47:04 +01: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 docs(roadmaps): add sprint execution order and detailed role-specific roadmaps 2026-04-02 14:35:54 +02:00
Sessions feat(docs): add detailed session logs and initial architecture plan for Neumarkt 2026 2026-03-27 14:41:21 +01: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