mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
78cda88ae6
meldestelle/docs/04_Agents
History
StefanMoCoAt c50acd641e chore(docs+infra): add hardware setup logs, guidelines, and Minisforum MS-R1 documentation 
- Updated `MASTER_ROADMAP_2026_Q1.md` to reflect delivery of Minisforum MS-R1 hardware and progress on infrastructure setup.
- Added detailed documentation for Minisforum MS-R1, including specifications, host OS setup guide, and service configuration guide.
- Logged DevOps setup session and curator's session with focus on hardware integration, SSH hardening, and networking adjustments (Macvlan workaround).
- Included user manual for Minisforum MS-R1 and related assets (e.g., images).
2026-02-08 01:27:28 +01:00
..
Logs chore(docs+infra): add hardware setup logs, guidelines, and Minisforum MS-R1 documentation 2026-02-08 01:27:28 +01:00
Playbooks build: switch to hybrid build for Kotlin/JS web-app and optimize Docker setup 2026-02-04 15:34:40 +01:00
README.md docs: restructure domain documentation and update references 2026-01-15 13:44:49 +01:00

README.md

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

  • Playbooks/Junie.md
  • Playbooks/Gemini.md
  • Playbooks/Curator.md