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
|