Zum Hauptinhalt springen

Entwicklungsansatz — True North, Leitprinzipien & Way-of-Working

Zweck. Diese Seite stellt den Entwicklungsansatz von Taktano explizit und an einer Stelle dar: woran wir Wert messen (True North), welche Prinzipien jede Entscheidung leiten und wie wir arbeiten (Way-of-Working). Sie ist die lesbare Übersicht über den Ansatz — die verbindliche Kurzfassung steht in der Root-CLAUDE.md, die detaillierten Agenten-Regeln in agents.md. Bei Widerspruch gilt CLAUDE.md.

Standard-Leitplanke (drkv, verbindlich): Jedes Repo zeigt seinen Way-of-Working sichtbar in der Doku — genau in dieser Datei. Sie ist der Einstieg für „wie entwickeln wir hier?" und wird je PR aktuell gehalten. (Der drkv-weite Kanon inkl. Vorlage lebt im Template everything-as-code-template.)

In einem Satz: Jedes Feature, jeder PR und jede Doku muss die Taktung/Reihenfolge-Optimierung und die drei True-North-Fragen direkter/schneller/genauer bedienen — festgehalten als Code im Repo.

1. True North — die drei Leitfragen​

#LeitfrageBedeutung
1Wie hoch ist die Auslastung?Belegung von Mitarbeitern und Buchten, jetzt und im Verlauf.
2Wo stehen die Fahrzeuge?Physischer Standort und Bearbeitungsphase je Auftrag.
3Wann sind die nächsten freien Kapazitäten?Nächste freie Zeitfenster je Leistung (Angebotsmodus).

Regel (verbindlich): Jedes Feature/PR/Doc muss ≥ 1 dieser Fragen direkter, schneller oder genauer beantworten — sonst wird es kritisch hinterfragt. Lebende Prüfliste: ../betrieb/Sanity-Checkliste.md.

2. Leitprinzipien​

PrinzipKern in einem Satz
Einfachheit (geringste Komplexität)Immer die einfachste tragfähige Lösung in Code/Technik/UI/UX; kleinste sinnvolle Änderung, bestehende Muster wiederverwenden, keine spekulative Abstraktion (YAGNI), keine ungefragten Refactorings.
SelbsterklärbarkeitSprechende Begriffe aus der Werkstatt-Praxis statt technischer Labels — in UI und Doku (z. B. „Fahrzeug angeliefert" statt „Reserviert").
Dokumentation als MeisterwerkDoku ist Produkt, nicht Beiwerk: pyramidal (Kernaussage zuerst), zielgruppen-gerecht (benannte Rolle, deren Sprache), visuell wo es trägt (Mermaid/Tabellen).
Everything-as-Code / Single Source of TruthDas Repo ist die einzige Quelle der Wahrheit; Entscheidungen landen als .md-Commit; derived State nie doppelt speichern — immer ableiten.
Compliance & Datenschutz (DE·AT·CH)Regulatorisch Relevantes proaktiv flaggen (DSGVO, E-Rechnung, Arbeitszeit …); PII minimal, EU-Residenz, keine Secrets im Klartext.
Betriebskosten automatisch ziehen (cost-pull-at-source, OP-COST)Infra-/Cloud-/API-Kosten je Provider-Billing-API ziehen statt pflegen; Kosten = abgeleitete Sicht.

Hinweis zu IDs: Die globalen Constraints G-1…G-3 in CLAUDE.md sind Scheduler-Regeln (Kontextwechsel-Pönale u. ä.), nicht die drkv-Leitprinzipien — nicht verwechseln. Die drkv-weite G-1…G-7-Nummerierung findet sich im Template und in den Schwester-Repos; Taktanos Prinzipien tragen hier sprechende Namen.

3. Wie das zusammenspielt​

True North sagt wozu, die Leitprinzipien sagen wie, der Prozess führt es aus, und die Artefakte im Repo sind der auditierbare Nachweis.

4. Way-of-Working — der Prozess​

  • Everything-as-Code & Audit-Trail: Jede Design-/Architektur-/Prozess-Entscheidung landet bevor die Session endet in HANDOFF.md §4 + docs/fachlich/Lastenheft.md + CHANGELOG.md (je PR); Design in design/. Details: agents.md §5.
  • ID-System: G-n global · R-n Module · Rn-F## Felder · A-n Architektur · S-n Vereinfachungen · OP-Rn-n offene Punkte · UC-x · FR-n/FM-n. Navigation: Register.md · IDs.md.
  • Branch-first & PR: nie direkt auf main; Feature-Branch → PR → Squash-Merge → Branch löschen. GitHub-Writes über die GitHub-API/MCP (Remote-Session). Branch regelmäßig auf main aktuell halten. Merge-Strategie/Log-Hygiene + Doku-Fast-Track: agents.md §6.6/§7.
  • Doku-Konsistenz-Check (OP-DOCS-9): Doku in sich widerspruchsfrei und zur Implementierung passend — zu Session-Beginn sichten, vor jedem PR gegenprüfen. Mechanik: bash scripts/check-doc-consistency.sh (warnt); der semantische Teil bleibt Agenten-Pflicht.
  • Versionierung (SemVer): MAJOR.MINOR.PATCH, bewusst je PR; MVP = 1.0.0. Single Source server/src/version.ts; Build-Nummer automatisch aus dem Git-Commit-Count. Sichtbar in UI und Logs.

5. Standard-Bausteine (drkv) — Taktano als Referenz-Implementierung​

Taktano ist die Referenz für den bewirtschafteten drkv-Standard-Tech-Stack (kanonisch im Template everything-as-code-template/docs/Standard-Tech-Stack.md). Die vier Standard-Eigenschaften sind hier gebaut:

  • Echtzeit — Live-State im Durable Object, WebSocket-Broadcast an alle Clients.
  • Moderne Frameworks — Angular 22 (Standalone + Signals), laufende Dependency-Bumps.
  • In-App-Chatbot — LLM + RAG auf Live-Daten und Doku (Doku-Q&A · Insights · Feedback), vorschlagend, berechtigungsgefiltert, dormant ohne Secret. Detail: ../architektur/In-App-Assistent.md.
  • Feedback — im Kontext sammeln (Element/Screenshot → GitHub-Issue) und anzeigen (Overlay/Liste in App und Doku). Teil des In-App-Assistenten.

6. Compliance-Haltung (DE · AT · CH)​

Proaktiv, nicht nachgelagert: regulatorisch relevante Themen (DSGVO, E-Rechnung, Arbeitszeit, SBOM/Audit- Bereitschaft) aktiv benennen + Optionen aufzeigen. Geführt in ../betrieb/Compliance.md und ../betrieb/Risikoregister.md.

7. Quellen & Vertiefung​

WasWo
Verbindliche KurzfassungRoot-CLAUDE.md
Detaillierte Konventionenagents.md
In-App-Chatbot + Feedback../architektur/In-App-Assistent.md
Lesepfade nach Zielgruppe../zielgruppen/Lesepfade.md
True-North-Prüfliste../betrieb/Sanity-Checkliste.md
Doku-Landkarte../README.md