Lars
532e17c4cd
- Introduced a new section for the Jinkendo Foundation, detailing design principles for the product family. - Updated README files to include references to the new design principles documentation. - Enhanced the overall documentation structure to improve navigation and accessibility of design resources. - Ensured consistency across documentation related to the Jinkendo Foundation and its principles.
65 lines
2.7 KiB
Markdown
65 lines
2.7 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`** |
|
||
| 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
|