@the-bearded-bear/claude-craft 3.0.2 → 3.0.3-next.d0d2746

package/Dev/i18n/de/Common/commands/setup-project-context.md

@@ -0,0 +1,286 @@
+---
+name: setup-project-context
+description: Codebase analysieren und Projektkontext interaktiv konfigurieren
+arguments:
+  - name: mode
+    description: Erkennungsmodus (--auto minimale Fragen, --full umfassender Fragebogen)
+    required: false
+---
+
+# Projektkontext Einrichten
+
+Konfiguriert `.claude/rules/00-project-context.md` durch Analyse der Codebase und gezielte Fragen.
+
+## Ausfuehrung
+
+### Phase 1: Automatische Erkennung
+
+Folgende Dateien und Verzeichnisse analysieren:
+
+**Konfigurationsdateien:**
+- `package.json` → Node.js Projektname, Abhangigkeiten, Skripte
+- `composer.json` → PHP Projektname, Abhangigkeiten, Framework
+- `pubspec.yaml` → Flutter/Dart Projektname, Abhangigkeiten
+- `requirements.txt` / `pyproject.toml` → Python Abhangigkeiten
+- `Cargo.toml` → Rust Projekt
+- `go.mod` → Go Modul
+
+**Umgebung & Konfiguration:**
+- `.env`, `.env.example` → Datenbank, Dienste
+- `config/` → Framework-Konfiguration
+- `docker-compose.yml` → Dienste (DB, Redis, etc.)
+
+**Struktur:**
+- `src/`, `lib/`, `app/` → Quellcode-Speicherort
+- `tests/`, `spec/` → Testing-Framework
+- `docs/`, `specifications/` → Dokumentation
+- `.github/`, `.gitlab-ci.yml` → CI/CD
+
+**Domane (falls zutreffend):**
+- `src/Entity/`, `src/Domain/` → Geschaftsentitaten (PHP/Symfony)
+- `lib/models/`, `lib/domain/` → Modelle (Flutter/Dart)
+- `models/`, `schemas/` → Datenmodelle
+- `migrations/` → Datenbankschema
+
+Analyseergebnisse anzeigen:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║             PROJEKTANALYSE-ERGEBNISSE                         ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Erkannte Informationen:
+┌─────────────────┬────────────────────────────────┐
+│ Element         │ Wert                           │
+├─────────────────┼────────────────────────────────┤
+│ Projektname     │ {erkannter_name}               │
+│ Sprache         │ {erkannte_sprache}             │
+│ Framework       │ {erkanntes_framework}          │
+│ Datenbank       │ {erkannte_datenbank}           │
+│ Testing         │ {erkanntes_testing}            │
+│ CI/CD           │ {erkanntes_cicd}               │
+└─────────────────┴────────────────────────────────┘
+
+📁 Projektstruktur:
+{erkannte_struktur}
+
+📄 Gefundene Dokumentation:
+{gefundene_docs}
+
+❌ Nicht Erkannt (wird abgefragt):
+- {fehlende_elemente}
+```
+
+### Phase 2: Interaktive Fragen
+
+Nur nach Informationen fragen, die in Phase 1 NICHT erkannt wurden.
+Fragen uberspringen, wenn `--auto` Modus verwendet wird und ein vernunftiger Standardwert existiert.
+
+**Wesentliche Fragen:**
+
+1. **Anwendungstyp** (falls nicht erkannt):
+   ```
+   Welcher Anwendungstyp ist das?
+   [ ] REST API      [ ] Webanwendung      [ ] Mobile App
+   [ ] CLI-Tool      [ ] Bibliothek/Paket  [ ] Monorepo
+   ```
+
+2. **Geschaftsdomane**:
+   ```
+   Was ist die Geschaftsdomane?
+   [ ] E-Commerce    [ ] SaaS-Plattform    [ ] FinTech
+   [ ] HealthTech    [ ] EdTech            [ ] Social/Community
+   [ ] Medien/Inhalt [ ] IoT               [ ] Andere: _____
+   ```
+
+3. **Zielbenutzer** (2-3 Personas):
+   ```
+   Beschreiben Sie Ihre Hauptbenutzer:
+
+   Primarer Benutzer:
+   > Rolle: _____
+   > Hauptziel: _____
+
+   Sekundarer Benutzer (optional):
+   > Rolle: _____
+   > Hauptziel: _____
+   ```
+
+4. **Compliance-Anforderungen**:
+   ```
+   Welche Compliance-Anforderungen gelten?
+   [ ] DSGVO (EU-Datenschutz)
+   [ ] HIPAA (US-Gesundheitswesen)
+   [ ] PCI-DSS (Zahlungskarten)
+   [ ] SOC2 (Sicherheit)
+   [ ] Keine / Nicht zutreffend
+   ```
+
+**Erweiterte Fragen** (nur mit `--full` Modus):
+
+5. **Geschaftsziele**:
+   ```
+   Kurzfristige Ziele (3-6 Monate):
+   > _____
+
+   Mittelfristige Ziele (6-12 Monate):
+   > _____
+   ```
+
+6. **Bekannte Probleme/Technische Schulden**:
+   ```
+   Gibt es bekannte Probleme oder technische Schulden zu dokumentieren?
+   > _____
+   ```
+
+7. **Glossarbegriffe**:
+   ```
+   Wichtige Geschaftsbegriffe zum Definieren (kommagetrennt):
+   > _____
+   ```
+
+### Phase 3: Kontextdatei Generieren
+
+`.claude/rules/00-project-context.md` erstellen:
+
+```markdown
+# Projektkontext - {PROJEKTNAME}
+
+> Automatisch generiert von `/common:setup-project-context` am {DATUM}
+> Nach Bedarf uberprufen und anpassen.
+
+## Ubersicht
+
+**{PROJEKTNAME}** ist eine {TYP}-Anwendung fur die {DOMANE}-Domane.
+
+{BESCHREIBUNG_AUS_README_ODER_BENUTZER}
+
+## Technischer Stack
+
+| Komponente   | Technologie          |
+|--------------|----------------------|
+| Sprache      | {SPRACHE}            |
+| Framework    | {FRAMEWORK}          |
+| Datenbank    | {DATABASE}           |
+| Cache        | {CACHE_FALLS_ERKANNT}|
+| Testing      | {TEST_FRAMEWORKS}    |
+| CI/CD        | {CICD_PLATTFORM}     |
+
+## Projektstruktur
+
+```
+{ERKANNTE_STRUKTUR}
+```
+
+## Geschaftsdomane
+
+### Kernkonzepte
+
+{ENTITATEN_FALLS_ERKANNT}
+
+### Bounded Contexts
+
+<!-- Hinzufugen bei DDD-Verwendung -->
+- Kontext 1: ...
+- Kontext 2: ...
+
+## Benutzer & Personas
+
+### {PRIMARER_BENUTZER_ROLLE}
+- **Ziel:** {PRIMARER_BENUTZER_ZIEL}
+- **Schmerzpunkte:** Zu dokumentieren
+- **Wichtige Workflows:** Zu dokumentieren
+
+### {SEKUNDARER_BENUTZER_ROLLE}
+- **Ziel:** {SEKUNDARER_BENUTZER_ZIEL}
+- **Schmerzpunkte:** Zu dokumentieren
+- **Wichtige Workflows:** Zu dokumentieren
+
+## Einschrankungen
+
+### Compliance
+{COMPLIANCE_ANFORDERUNGEN}
+
+### Leistungsziele
+- Seitenladezeit: < 3s
+- API-Antwortzeit: < 200ms
+- Verfugbarkeit: 99.9%
+
+### Sicherheitsanforderungen
+- OWASP Top 10 Konformitat
+- Eingabevalidierung an allen Endpunkten
+- Authentifizierung fur geschutzte Ressourcen erforderlich
+
+## Ziele
+
+### Kurzfristig
+{KURZFRISTIGE_ZIELE_ODER_PLATZHALTER}
+
+### Mittelfristig
+{MITTELFRISTIGE_ZIELE_ODER_PLATZHALTER}
+
+## Bekannte Probleme / Technische Schulden
+
+{PROBLEME_ODER_PLATZHALTER}
+
+## Glossar
+
+| Begriff | Definition |
+|---------|------------|
+{GLOSSARBEGRIFFE_ODER_BEISPIELE}
+```
+
+### Phase 4: Validierung & Nachste Schritte
+
+Zusammenfassung und Empfehlungen anzeigen:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║              PROJEKTKONTEXT GENERIERT                         ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Datei erstellt: .claude/rules/00-project-context.md
+
+Zusammenfassung:
+┌─────────────────┬────────────────────────────────┐
+│ Projekt         │ {PROJEKTNAME}                  │
+│ Typ             │ {TYP}                          │
+│ Stack           │ {FRAMEWORK} + {DATABASE}       │
+│ Domane          │ {DOMANE}                       │
+│ Compliance      │ {COMPLIANCE}                   │
+│ Personas        │ {ANZAHL} definiert             │
+└─────────────────┴────────────────────────────────┘
+
+📋 Empfohlene Nachste Schritte:
+
+1. Generierte Datei uberprufen und Platzhalterabschnitte ausfullen
+2. Detaillierte Bounded Contexts hinzufugen falls DDD verwendet wird
+3. Wichtige Geschaftsworkflows dokumentieren
+4. Spezialisierte Agenten ausfuhren erwagen:
+   - @database-architect → Datenbankschema dokumentieren
+   - @api-designer → API-Endpunkte dokumentieren
+   - @security-reviewer → Sicherheitseinschrankungen uberprufen
+
+Mochten Sie, dass ich die Datei zur Uberprufung offne?
+```
+
+## Modi
+
+| Modus | Verhalten |
+|-------|-----------|
+| (Standard) | Erkennung + wesentliche Fragen (Typ, Domane, Benutzer, Compliance) |
+| `--auto` | Maximale Auto-Erkennung, Fragen mit vernunftigen Standardwerten uberspringen |
+| `--full` | Alle Fragen einschliesslich Ziele, Probleme und Glossar |
+
+## Beispiele
+
+```bash
+# Standardmodus - ausgewogene Erkennung und Fragen
+/common:setup-project-context
+
+# Auto-Modus - minimale Interaktion
+/common:setup-project-context --auto
+
+# Vollstandiger Modus - umfassender Fragebogen
+/common:setup-project-context --full
+```

package/Dev/i18n/en/Common/commands/setup-project-context.md

@@ -0,0 +1,286 @@
+---
+name: setup-project-context
+description: Analyze codebase and configure project context interactively
+arguments:
+  - name: mode
+    description: Detection mode (--auto minimal questions, --full comprehensive)
+    required: false
+---
+
+# Setup Project Context
+
+Configure `.claude/rules/00-project-context.md` by analyzing the codebase and asking targeted questions.
+
+## Execution
+
+### Phase 1: Automatic Detection
+
+Analyze the following files and directories:
+
+**Configuration Files:**
+- `package.json` → Node.js project name, dependencies, scripts
+- `composer.json` → PHP project name, dependencies, framework
+- `pubspec.yaml` → Flutter/Dart project name, dependencies
+- `requirements.txt` / `pyproject.toml` → Python dependencies
+- `Cargo.toml` → Rust project
+- `go.mod` → Go module
+
+**Environment & Config:**
+- `.env`, `.env.example` → Database, services
+- `config/` → Framework configuration
+- `docker-compose.yml` → Services (DB, Redis, etc.)
+
+**Structure:**
+- `src/`, `lib/`, `app/` → Source code location
+- `tests/`, `spec/` → Testing framework
+- `docs/`, `specifications/` → Documentation
+- `.github/`, `.gitlab-ci.yml` → CI/CD
+
+**Domain (if applicable):**
+- `src/Entity/`, `src/Domain/` → Business entities (PHP/Symfony)
+- `lib/models/`, `lib/domain/` → Models (Flutter/Dart)
+- `models/`, `schemas/` → Data models
+- `migrations/` → Database schema
+
+Display analysis results:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                 PROJECT ANALYSIS RESULTS                      ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Detected Information:
+┌─────────────────┬────────────────────────────────┐
+│ Element         │ Value                          │
+├─────────────────┼────────────────────────────────┤
+│ Project Name    │ {detected_name}                │
+│ Language        │ {detected_language}            │
+│ Framework       │ {detected_framework}           │
+│ Database        │ {detected_database}            │
+│ Testing         │ {detected_testing}             │
+│ CI/CD           │ {detected_cicd}                │
+└─────────────────┴────────────────────────────────┘
+
+📁 Project Structure:
+{detected_structure}
+
+📄 Documentation Found:
+{detected_docs}
+
+❌ Not Detected (will ask):
+- {missing_items}
+```
+
+### Phase 2: Interactive Questions
+
+Ask only for information NOT detected in Phase 1.
+Skip questions if `--auto` mode is used and a reasonable default exists.
+
+**Essential Questions:**
+
+1. **Application Type** (if not detected):
+   ```
+   What type of application is this?
+   [ ] REST API      [ ] Web Application    [ ] Mobile App
+   [ ] CLI Tool      [ ] Library/Package    [ ] Monorepo
+   ```
+
+2. **Business Domain**:
+   ```
+   What is the business domain?
+   [ ] E-commerce    [ ] SaaS Platform      [ ] FinTech
+   [ ] HealthTech    [ ] EdTech             [ ] Social/Community
+   [ ] Media/Content [ ] IoT                [ ] Other: _____
+   ```
+
+3. **Target Users** (2-3 personas):
+   ```
+   Describe your main users:
+
+   Primary User:
+   > Role: _____
+   > Main goal: _____
+
+   Secondary User (optional):
+   > Role: _____
+   > Main goal: _____
+   ```
+
+4. **Compliance Requirements**:
+   ```
+   Which compliance requirements apply?
+   [ ] GDPR (EU data protection)
+   [ ] HIPAA (US healthcare)
+   [ ] PCI-DSS (Payment card)
+   [ ] SOC2 (Security)
+   [ ] None / Not applicable
+   ```
+
+**Extended Questions** (only with `--full` mode):
+
+5. **Business Goals**:
+   ```
+   Short-term goals (3-6 months):
+   > _____
+
+   Medium-term goals (6-12 months):
+   > _____
+   ```
+
+6. **Known Issues/Technical Debt**:
+   ```
+   Any known issues or technical debt to document?
+   > _____
+   ```
+
+7. **Glossary Terms**:
+   ```
+   Key business terms to define (comma-separated):
+   > _____
+   ```
+
+### Phase 3: Generate Context File
+
+Create `.claude/rules/00-project-context.md`:
+
+```markdown
+# Project Context - {PROJECT_NAME}
+
+> Auto-generated by `/common:setup-project-context` on {DATE}
+> Review and customize as needed.
+
+## Overview
+
+**{PROJECT_NAME}** is a {TYPE} application for the {DOMAIN} domain.
+
+{DESCRIPTION_FROM_README_OR_USER}
+
+## Technical Stack
+
+| Component    | Technology           |
+|--------------|----------------------|
+| Language     | {LANGUAGE}           |
+| Framework    | {FRAMEWORK}          |
+| Database     | {DATABASE}           |
+| Cache        | {CACHE_IF_DETECTED}  |
+| Testing      | {TESTING_FRAMEWORKS} |
+| CI/CD        | {CICD_PLATFORM}      |
+
+## Project Structure
+
+```
+{DETECTED_STRUCTURE}
+```
+
+## Business Domain
+
+### Core Concepts
+
+{ENTITIES_IF_DETECTED}
+
+### Bounded Contexts
+
+<!-- Add if using DDD -->
+- Context 1: ...
+- Context 2: ...
+
+## Users & Personas
+
+### {PRIMARY_USER_ROLE}
+- **Goal:** {PRIMARY_USER_GOAL}
+- **Pain points:** To be documented
+- **Key workflows:** To be documented
+
+### {SECONDARY_USER_ROLE}
+- **Goal:** {SECONDARY_USER_GOAL}
+- **Pain points:** To be documented
+- **Key workflows:** To be documented
+
+## Constraints
+
+### Compliance
+{COMPLIANCE_REQUIREMENTS}
+
+### Performance Targets
+- Page load time: < 3s
+- API response time: < 200ms
+- Availability: 99.9%
+
+### Security Requirements
+- OWASP Top 10 compliance
+- Input validation on all endpoints
+- Authentication required for protected resources
+
+## Goals
+
+### Short-term
+{SHORT_TERM_GOALS_OR_PLACEHOLDER}
+
+### Medium-term
+{MEDIUM_TERM_GOALS_OR_PLACEHOLDER}
+
+## Known Issues / Technical Debt
+
+{ISSUES_OR_PLACEHOLDER}
+
+## Glossary
+
+| Term | Definition |
+|------|------------|
+{GLOSSARY_TERMS_OR_EXAMPLES}
+```
+
+### Phase 4: Validation & Next Steps
+
+Display summary and recommendations:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║              PROJECT CONTEXT GENERATED                        ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ File created: .claude/rules/00-project-context.md
+
+Summary:
+┌─────────────────┬────────────────────────────────┐
+│ Project         │ {PROJECT_NAME}                 │
+│ Type            │ {TYPE}                         │
+│ Stack           │ {FRAMEWORK} + {DATABASE}       │
+│ Domain          │ {DOMAIN}                       │
+│ Compliance      │ {COMPLIANCE}                   │
+│ Personas        │ {COUNT} defined                │
+└─────────────────┴────────────────────────────────┘
+
+📋 Recommended Next Steps:
+
+1. Review generated file and complete placeholder sections
+2. Add detailed bounded contexts if using DDD
+3. Document key business workflows
+4. Consider running specialized agents:
+   - @database-architect → Document database schema
+   - @api-designer → Document API endpoints
+   - @security-reviewer → Review security constraints
+
+Would you like me to open the file for review?
+```
+
+## Modes
+
+| Mode | Behavior |
+|------|----------|
+| (default) | Detect + essential questions (type, domain, users, compliance) |
+| `--auto` | Maximum auto-detection, skip questions with reasonable defaults |
+| `--full` | All questions including goals, issues, and glossary |
+
+## Examples
+
+```bash
+# Standard mode - balanced detection and questions
+/common:setup-project-context
+
+# Auto mode - minimal interaction
+/common:setup-project-context --auto
+
+# Full mode - comprehensive questionnaire
+/common:setup-project-context --full
+```