mitai-jinkendo/.claude/README.md

# 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`** |
| 5 | **Jinkendo Foundation** (Designprinzipien 1–9): **`docs/jinkendo-foundation/design-principles/README.md`** |
| 6 | **Universal CSV Import** (Modul/Executor/Vorlagen): **`docs/technical/UNIVERSAL_CSV_IMPORT_AGENT_GUIDE.md`** (unter `.claude/`) |

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
│   ├── jinkendo-foundation/ ← Foundation Produktfamilie (Designprinzipien)
│   ├── 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