Praxis-Referenz: Claude Code Projektarbeit

Zweck: Schnelles Nachschlagen während der Arbeit
Format: Lookup-Tables, Copy-Paste-Snippets, Entscheidungshilfen

Quick Reference Cards

Card 1: Ordnerstruktur auf einen Blick

📄 CLAUDE.md              → "Was soll Claude wissen?"
📁 .claude/
   ├── settings.json      → "Wie soll Claude arbeiten?"
   ├── commands/          → Schnelle /slash-Aktionen
   └── skills/            → Interaktive Werkzeuge
📁 docs/
   ├── architecture/      → Entscheidungen (ADRs)
   ├── context/           → Domain-Wissen
   ├── prompts/           → Autonome Pipelines
   └── templates/         → Wiederverwendbare Vorlagen
📁 refs/                  → Externe Links (JSON)
📁 input/raw/             → Unverarbeitet
📁 input/processed/       → Nach Pipeline
📁 output/                → Ergebnisse
📁 notes/                 → Dein Workspace
📁 src/                   → Code & Tools

Card 2: Wann was nutzen?

Card 3: Datei-Templates

CLAUDE.md (Minimal)

# Projekt: [NAME]

## Kontext
[1-2 Sätze]

## Aktueller Fokus
- [ ] [Task]

## Wichtige Pfade
- Kontext: `/docs/context/`
- Entscheidungen: `/docs/architecture/`
- Externe Refs: `/refs/_INDEX.json`

Command (.claude/commands/[name].md)

# /[name]

[Was soll passieren - 1-3 Schritte]

**Output:** [Format/Ort]

Skill (.claude/skills/[name]/SKILL.md)

# Skill: [Name]

## Trigger
"[Wie ruft man es auf]"

## Ablauf
1. [Schritt]
2. **FRAGE:** "[Rückfrage an User]"
3. [Schritt]

## Output
[Was kommt raus, wohin]

Prompt (docs/prompts/[##]_[name].md)

# [##] – [Name]

## Variablen
- `INPUT`: [Pfad]
- `OUTPUT`: [Pfad]

## Anweisungen
1. [Schritt]
2. [Schritt]

## Modus
- Automatisch | Interaktiv
- Delta-Erkennung: ja | nein
- Sub-Agents: ja | nein

## Output-Format
[Beschreibung oder Template]

Workflow README (docs/prompts/README.md)

# Prompts – Workflow

## Übersicht
| Nr. | Prompt | Zweck | Modus |
|-----|--------|-------|-------|
| 01 | ... | ... | Auto |

## Workflow

[Pfad] → [01] → [Pfad] → [02] → ...

## Nutzung
"Führe docs/prompts/01_xxx.md aus"

Card 4: JSON-Strukturen

refs/_INDEX.json

{
  "meta": {
    "project": "[Name]",
    "updated": "YYYY-MM-DD"
  },
  "entities": {
    "[slug]": {
      "type": "analysis|architecture|reference",
      "local": "/docs/context/[file].md",
      "external": {
        "confluence": "https://...",
        "figma": "https://...",
        "live": "https://..."
      }
    }
  }
}

.claude/settings.json

{
  "permissions": {
    "allow": ["read", "write", "mcp"],
    "deny": []
  },
  "preferences": {
    "language": "de",
    "explainConcepts": true
  }
}

Card 5: Prompt-Modus-Flags

Sub-Agent Syntax im Prompt

## Modus
- **Sub-Agents:** Ja, bei >3 Dateien
- **Parallelisierung:** Pro Datei ein Agent
- **Zusammenführung:** Ergebnisse in _INDEX.md sammeln

Card 6: Häufige Aktionen

Neues Projekt starten

# Minimalstruktur
mkdir -p .claude/commands .claude/skills
mkdir -p docs/{architecture,context,prompts,templates}
mkdir -p refs input/{raw,processed} output notes src
touch CLAUDE.md .claude/settings.json refs/_INDEX.json

Dokument aus Mac Projects übernehmen

1. In Mac App: Dokument als Markdown exportieren
2. Speichern unter: /docs/context/[name].md
3. In CLAUDE.md referenzieren
4. Optional: In /refs/_INDEX.json externe Links ergänzen

Neuen Prompt erstellen

1. Nächste Nummer ermitteln (01, 02, ...)
2. Datei anlegen: /docs/prompts/[##]_[name].md
3. Template ausfüllen (siehe Card 3)
4. In /docs/prompts/README.md Workflow aktualisieren

Skill zu Prompt konvertieren

Wenn ein Skill "ausgereift" ist (keine Rückfragen mehr nötig):

1. Skill-Logik in Prompt-Format übersetzen
2. Alle Entscheidungen als Defaults definieren
3. Modus: Automatisch setzen
4. Skill optional behalten für explorative Nutzung

Card 7: Debugging & Troubleshooting

Card 8: Naming Conventions

Card 9: Workflow-Patterns

Pattern A: Linear Pipeline

[01] → [02] → [03]
  │      │      │
  ▼      ▼      ▼
Input  Transform Output

Pattern B: Fork & Merge

        ┌→ [02a] ─┐
[01] ──→│         ├→ [03]
        └→ [02b] ─┘

Pattern C: Iterativ mit Feedback-Loop

[01] → [02] → [03]
              ↓
        ┌─────┴─────┐
        ↓           │
   User Review      │
        │           │
        └→ [02] ────┘ (wenn Änderungen)

Card 10: MCP-Nutzung

Im Prompt referenzieren

## Abhängigkeiten
- **MCP-Server:** filesystem (für /input), github (für Commits)

## Anweisungen
1. Nutze MCP-filesystem um Dateien in /input/raw/ zu listen
2. ...

In settings.json erlauben

{
  "permissions": {
    "allow": ["read", "write", "mcp"],
    "mcp": {
      "servers": ["filesystem", "github", "notion"]
    }
  }
}

Schnell-Checkliste: Vor dem Arbeiten

□ CLAUDE.md ist aktuell (Fokus stimmt)
□ /input/raw/ hat neue Dateien? → Pipeline starten
□ Letzte Änderung in /notes/journal.md dokumentiert?
□ Externe Refs noch gültig? (bei längerer Pause prüfen)

Praxis-Referenz v1.0 – Januar 2026