Files

T

2026-06-11 14:10:36 +02:00

name, description

name	description
nexus-sdd-workflow	Arbeitsablauf für SDD-Karten im Repo l.kirchner/nexus-hub (Family Knowledge Hub). Verwenden bei JEDER Arbeit an einer nexus-Karte - vom Aufnehmen einer Karte aus todo/ bis zum Merge. Deckt ab - Worktree-Disziplin, Karten-Lebenszyklus, Codex-Cross-Review via MCP, CI-Pflicht, Wiki-Pflege, Memory-Hub-Spiegelung.

nexus SDD-Workflow

Kontext laden (immer zuerst, in dieser Reihenfolge)

docs/00_README.md — Lesepfad-Manifest des Repos
Die nummerierten Docs in Reihenfolge (mind. Brief, PRD, Architektur), soweit fürs Karten-Scope relevant
docs/agent-rules.md — gemeinsame Regeln (verbindlich)
Die Karte selbst unter .specs/tasks/todo/
Memory Hub (MCP memory): Entity Family Knowledge Hub für aktuelle Entscheidungen/Lessons

Präzedenz bei Widersprüchen: Repo-Docs > ADRs > Memory Hub > Pipeline-Repo.

Aufnehmen: Karte von todo/ nach in-progress/ verschieben (eigener Commit). Pro Karte genau EIN führender Agent (ADR-0001) — steht in der Karte.
Worktree: Niemals auf dem Haupt-Checkout arbeiten. git worktree add ../nexus-hub-<karte> -b karte/<nr>-<slug>.
Implementieren: Akzeptanzkriterien der Karte sind das Ziel. Jede Karte erweitert die CI passend zu ihrem Scope (.gitea/workflows/ci.yml). Commits referenzieren die Karte (K-1xx: ...).
Cross-Review: Vor dem Merge die Änderungen vom jeweils anderen Agenten reviewen lassen — als Claude Code: Codex via MCP-Tool codex (read-only Sandbox, Diff + Karte als Kontext übergeben). Findings triagieren: fixen oder begründet ablehnen (in der Karte dokumentieren).
Merge: Nur bei grüner CI inkl. SICHT-4-Suite. Karte nach done/ verschieben, offene Folgepunkte als neue Draft-Karten anlegen.
Nacharbeiten (Pflicht, nicht optional):
- Wiki Status + Phase-Tracking aktualisieren (Gitea-MCP wiki_write)
- Entscheidungen → Wiki Decisions-Log + ADR + Memory-Hub-Spiegelung (Decision-Entity, Relation PART_OF_PROJECT → Family Knowledge Hub)
- Neue Projekt-Kommandos in docs/agent-rules.md dokumentieren