Lars
7940dc7560
- .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
62 lines
2.4 KiB
Markdown
62 lines
2.4 KiB
Markdown
# 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
|