mitai-jinkendo/.claude/README.md
Lars b453ce63c6
All checks were successful
Deploy Development / deploy (push) Successful in 53s
Build Test / pytest-backend (push) Successful in 4s
Build Test / lint-backend (push) Successful in 0s
Build Test / build-frontend (push) Successful in 17s
feat(universal-csv-import): Introduce Universal CSV Import module and related documentation
- Added the Universal CSV Import module, including the `UNIVERSAL_CSV_IMPORT_AGENT_GUIDE.md` for guidelines on new import modules, executors, and templates.
- Updated relevant rules in `ARCHITECTURE.md` and `CODING_RULES.md` to include references to the new import module and its requirements.
- Revised the Gitea Issues Index to reflect the latest updates and added context for ongoing issues related to the CSV import functionality.
- Enhanced the README files to provide clearer navigation and documentation for the Universal CSV Import features.
2026-04-11 08:14:20 +02:00

63 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 | **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
│ ├── 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