Lars 7940dc7560 docs: Struktur .claude/docs versionieren, working/, Gitea-Index, Regeln

- .gitignore: .claude/docs, rules, commands tracken; settings.local weiter ignorieren
- DOCUMENTATION.md: verbindliche Ablage functional/technical/working/issues
- .claude/README.md: Agent-Einstieg; GITEA_ISSUES_INDEX aus MCP (Stand 2026-04-08)
- Arbeitspapiere von docs/ nach .claude/docs/working/ verschoben
- docs/MEMBERSHIP_SYSTEM.md als Stub; kanonisch technical/MEMBERSHIP_SYSTEM.md
- CLAUDE.md PflichtlektÃ¼re und Links angepasst; docs/README.md vereinfacht

Made-with: Cursor

2026-04-08 13:01:49 +02:00

2.4 KiB

Raw Blame History

Mitai Jinkendo – Claude-Arbeitsumgebung

Dieser Ordner ist der primäre Orientierungspunkt für Claude Code / Cursor-Agenten. Dauerhafte Spezifikationen liegen unter .claude/docs/ (functional/, technical/ …). Das Repository docs/ (Projektroot) ist u. a. für docs/issues/ – nicht verwechseln.

Pflichtlektüre (vor größeren Änderungen)

Reihenfolge	Datei
1	`../CLAUDE.md`
2	`rules/DOCUMENTATION.md` – Ablage- und Dokumentationsregeln
3	`rules/ARCHITECTURE.md`, `rules/CODING_RULES.md`, `rules/LESSONS_LEARNED.md`
4	Issue-Landkarte: `.claude/docs/GITEA_ISSUES_INDEX.md`

Themen mit UI/Nav/PWA: siehe ../docs/issues/GUI_IA_ADMIN_NAV_2026-04-05.md (im Projekt-docs/, nicht hier).

Verzeichnisbaum (Kurz)

.claude/
├── README.md              ← Diese Datei
├── rules/                 ← Verbindliche Regeln (versioniert, wenn konfiguriert)
├── docs/                  ← Spezifikationen + Arbeitspapiere
│   ├── functional/        ← Fachlich (WAS)
│   ├── technical/         ← Technisch (WIE)
│   ├── architecture/      ← Querschnitt
│   ├── working/           ← Zwischenstände, Analysen (nicht allein „Wahrheit“)
│   ├── audit/             ← Audits, Matrizen
│   ├── README.md          ← Katalog aller Spec-Dateien
│   └── GITEA_ISSUES_INDEX.md
├── commands/              ← Slash-Befehle (optional versioniert)
├── task/                  ← Lokale Arbeitspakete (meist nur lokal)
├── handover/              ← Session-Notizen (meist nur lokal)
├── skills/                ← Skills (lokal)
└── settings.json          ← Editor-Konfiguration (lokal)
.settings.local.json       ← Nicht committen

Wo neue Inhalte ablegen

Siehe rules/DOCUMENTATION.md (Tabelle „Ablagepflicht“). Kurz:

Langfristige fachliche Spec → docs/functional/ (innerhalb von .claude, siehe Baum oben).
Langfristige technische Spec → docs/technical/.
Session-Analyse / grobe Notizen → docs/working/.
Epic/Issue lang → ../docs/issues/ im Repository.

Projekt-`docs/` (Repository)

../docs/issues/ enthält issue-nummerierte Markdown-Dateien und Abnahme-Dokumente – parallel zu diesem Ordner, für alle sichtbar die das Repo klonen.

Stand: 2026-04-08

2.4 KiB Raw Blame History Unescape Escape