Haaaiawd/Sequential-thinking-skills

AGENTS.md - KI-Kooperationsprotokoll

„Wenn du diese Datei liest, bist du die Intelligenz (The Intelligence).“

Diese Datei ist dein Anker (Anchor). Sie definiert die Gesetze des Projekts, die Karte des Territoriums und das Gedächtnisprotokoll. Wenn du aufwachst (eine neue Sitzung startest), lies zuerst diese Datei.

---

🧠 30-Sekunden-Wiederherstellungsprotokoll (Quick Recovery)

Wenn du eine neue Sitzung beginnst oder das Gefühl hast, dich „verloren“ zu haben, führe sofort Folgendes aus:

1. Lese die AGENTS.md im Stammverzeichnis → Erhalte die Projektkarte
2. Überprüfe den untenstehenden „Aktuellen Status“ → Finde die neueste Architekturversion
3. Lese .anws/v{N}/05_TASKS.md → Erfahre die aktuellen Aufgaben
4. Beginne mit der Arbeit

---

🗺️ Karte (Territoriumswahrnehmung)

So ist dieses Projekt organisiert:

Pfad	Beschreibung	Zugriffsprotokoll
src/	Implementierungsebene. Der eigentliche Code.	Lese-/Schreibzugriff über Tasks.
.anws/	Einheitliches Architekturverzeichnis. Enthält versionierte Architekturzustände und Upgrade-Aufzeichnungen.	Schreibgeschützt (alt) / Einmal schreiben (neu) / changelog wird von der CLI verwaltet.
.anws/v{N}/	Aktuelle Wahrheit. Die neueste Architekturdefinition.	Suche immer nach der größten v{N}.
.anws/changelog/	Upgrade-Aufzeichnungen. Von anws update generierte Änderungsprotokolle.	Wird automatisch von der CLI verwaltet, nicht löschen.
zielspezifische Workflow-Projektion	Workflows. /genesis, /blueprint usw.	Lese die native Projektionsdatei des aktuellen Ziels.
zielspezifische Skill-Projektion	Fähigkeitsbibliothek. Atomare Fähigkeiten.	Rufe die native Projektionsdatei des aktuellen Ziels auf.
.nexus-map/	Wissensdatenbank. Strukturkarte der Codebasis.	Wird von nexus-mapper generiert.

🛠️ Workflow-Registrierung

[!WICHTIG] Workflow-vor-Prinzip: Wenn eine Aufgabe zu einem Workflow passt oder du beurteilst, dass die aktuelle Aufgabe offensichtlich, im Wesentlichen oder auch nur vermutlich in das Anwendungsszenario eines Workflows fällt, musst du zuerst die entsprechende Datei lesen und die darin enthaltenen Schritte strikt befolgen. Workflows sind sorgfältig entworfene Protokolle, keine optionalen Referenzen.

Auslöseprozess:

1. Der Benutzer erwähnt den Workflow-Namen, oder du beurteilst, dass die aktuelle Aufgabe offensichtlich, im Wesentlichen oder auch nur vermutlich in das Anwendungsszenario eines Workflows fällt
2. Lese sofort die entsprechende Workflow-Datei
3. Befolge strikt die Schritte im Workflow
4. Halte an Kontrollpunkten an und warte auf die Bestätigung des Benutzers

Workflow	Auslösezeitpunkt	Ergebnis
/quickstart	Einstieg für neue Benutzer / Keine Ahnung, wo anzufangen	Orchestriert andere Workflows
/genesis	Neues Projekt / Große Refaktorisierung	PRD, Architektur, ADRs
/probe	Vor Änderungen / Projektübernahme	.anws/v{N}/00_PROBE_REPORT.md
/design-system	Nach genesis	04_SYSTEM_DESIGN/*.md
/blueprint	Nach genesis	05_TASKS.md + initiale AGENTS.md-Welle
/change	Feinabstimmung bestehender Tasks	Aktualisiert TASKS + SYSTEM_DESIGN (nur Änderungen) + CHANGELOG
/explore	Bei Recherchen	Erkundungsbericht
/challenge	Hinterfragen vor Entscheidungen	07_CHALLENGE_REPORT.md (mit Problemübersichtsverzeichnis)
/forge	Codierungsausführung	Code + Aktualisierung des AGENTS.md-Wellenblocks
/craft	Erstellen von Workflows/Skills/Prompts	Workflow / Skill / Prompt-Dokument
/upgrade	Upgrade-Orchestrierung nach anws update	Entscheidet Minor / Major und leitet an /change oder /genesis weiter

---

📜 Verfassung (The Constitution)

1. Version ist Gesetz: „Repariere“ kein Architekturdokument, „evoziere“ es nur. Änderungen müssen eine neue Version erstellen.
2. Expliziter Kontext: Entscheidungen in ADRs festhalten, nicht im „Chat-Gedächtnis“ belassen.
3. Kreuzvalidierung: Vor dem Codieren mit 05_TASKS.md abgleichen. Tue ich geplante Aufgaben?
4. Ästhetik: Dokumente sollten schön sein. Nutze Markdown und Emojis sinnvoll.

---

🔄 Projektstatus-Reservat

📍 Aktueller Status (wird von Workflows automatisch aktualisiert)

Hinweis: Dies ist ein reservierter Teil der Projektdatei, der automatisch von /genesis, /blueprint und /forge verwaltet wird.

• Neueste Architekturversion: .anws/v1
• Aktive Aufgabenliste: .anws/v1/05_TASKS.md
• Anzahl ausstehender Tasks: 0 blockierende Implementierungstasks; derzeit in der finalen manuellen Überprüfungsphase
• Letzte Aktualisierung: 2026-03-16

🌊 Welle 1 — Geführter Kern + Wiederholungshauptkette abgeschlossen

• CLI-Hauptpfad start / step / replay abgeschlossen
• Automatisches Speichern, final.md, replay.md und Export in das aktuelle Verzeichnis abgeschlossen
• verify-Ein-Klick-Überprüfungskette abgeschlossen
• Rückmeldung des CLI-Protokolls an .windsurf/skills/sequential-thinking/SKILL.md und skills/sequential-thinking-skills/SKILL.md abgeschlossen
• Aktueller Status: Warte auf finale manuelle Überprüfung und Entscheidung über den Commit

---

🌳 Projektstruktur (Project Tree)

Hinweis: Dieser Teil wird von /genesis verwaltet.

src/
└── anws/
    ├── bin/cli.js
    ├── lib/ (init, update, diff, changelog, copy, manifest, ...)
    └── templates/
        ├── .agents/   (interne kanonische Vorlagenquelle, wird per Projektion auf jedes Ziel ausgespielt)
        └── AGENTS.md

.anws/
├── changelog/         (Upgrade-Aufzeichnungen)
└── v{N}/              (Aktuelle Architekturdokumente)

---

🧭 Navigationsanleitung (Navigation Guide)

Hinweis: Dieser Teil wird von /genesis verwaltet.

• Bevor die neue Architektur bereit ist: Nimm keine großflächigen Codeänderungen vor.
• Architekturübersicht: .anws/v{N}/02_ARCHITECTURE_OVERVIEW.md
• ADR: .anws/v{N}/03_ADR/ (Einzige Aufzeichnungsquelle für systemübergreifende Entscheidungen)
• Bei Architekturfragen: Konsultiere .anws/v{N}/03_ADR/.

---

Technologie-Stack-Entscheidungen

• [Wird automatisch von .anws/tech-evaluator oder /genesis ausgefüllt]

Systemgrenzen

• [Wird automatisch von .anws/system-architect oder /genesis ausgefüllt]

Aktive ADRs

• [Wird automatisch von .anws mit ADR-Zusammenfassungen ausgefüllt]

Aktueller Aufgabenstatus

• T4.3.1 abgeschlossen
• T1.3.1 abgeschlossen
• pnpm typecheck / test / build / verify alle bestanden
• Aktuell kein automatischer Git-Commit, warte auf manuelle Bestätigung

---

Status-Selbsttest: Bereit? Erinnere den Benutzer daran, /quickstart auszuführen, um zu beginnen.