Zum Inhalt

Checklisten

Referenz-Checklisten für die häufigsten Claude Code Workflows.

Checkliste: Vor dem ersten Claude Code Projekt

Bevor du loslegst, zahlt sich 10 Minuten Setup aus.

Setup

  • [ ] claude --version – ist Claude Code installiert und aktuell?
  • [ ] ANTHROPIC_API_KEY gesetzt (in Shell oder ~/.claude/settings.json)
  • [ ] Model in settings.json konfiguriert (claude-sonnet-4-6 für 80% der Fälle)
  • [ ] Sub-Agent Model gesetzt (claude-haiku-4-5-20251001 für günstige Parallelarbeit)

Projekt-Vorbereitung

  • [ ] CLAUDE.md im Projekt-Root erstellt
    • [ ] Tech-Stack dokumentiert
    • [ ] Build/Test/Start Commands
    • [ ] Wichtigste Konventionen (3-5 Regeln)
    • [ ] Off-Limits Bereiche definiert
  • [ ] .gitignore enthält keine Dateien die Claude braucht
  • [ ] Repo ist sauber (git status zeigt keine ungewollten Uncommitted Changes)

Erste Session

  • [ ] Kurzen Projekt-Überblick geben: "Das ist ein [Typ] Projekt das [Zweck] hat"
  • [ ] /help einmal durchgeschaut
  • [ ] /usage Token-Baseline notiert

Checkliste: Vor einer großen Änderung

Für Refactorings, neue Features, Architektur-Änderungen.

Vorbereitung

  • [ ] Anforderungen klar definiert (nicht vage)
  • [ ] Bestehende Tests laufen durch
  • [ ] git status ist sauber (Uncommitted Changes committen oder stashen)
  • [ ] Plan Mode aktivieren: claude --plan "..." oder /plan im Chat

Plan Review

  • [ ] Plan vollständig verstanden?
  • [ ] Scope passt? (Nicht zu groß, nicht zu vage)
  • [ ] Off-Limits Bereiche nicht im Scope?
  • [ ] Reihenfolge der Schritte macht Sinn?
  • [ ] Fallback definiert wenn was schiefgeht?

Nach der Änderung

  • [ ] Tests laufen durch
  • [ ] Manuelle Smoke-Tests gemacht
  • [ ] git diff reviewed (nichts Unerwünschtes?)
  • [ ] Commit-Message beschreibt was und warum

Checkliste: Code Review mit Claude

Für systematisches Review von PRs oder eigenem Code.

Vorbereitung

  • [ ] Review-Scope definiert: Was soll Claude prüfen? (Security, Performance, Style, Alle?)
  • [ ] Kontext gegeben: "Das ist ein [Typ], es soll [Zweck] erfüllen"
  • [ ] Fork Context nutzen wenn der Review-Context nicht bleiben soll

Review-Fokus

  • [ ] Security: Input-Validierung, SQL-Injection, XSS, hardcoded Secrets
  • [ ] Logik: Edge Cases, Error Handling, Null-Checks
  • [ ] Performance: N+1 Queries, unnötige Loops, fehlende Indizes
  • [ ] Tests: Kritische Pfade gedeckt? Tests sinnvoll?
  • [ ] Lesbarkeit: Verständliche Namen, unnötige Komplexität?

Nach dem Review

  • [ ] Kritische Findings sofort adressiert
  • [ ] Warnungen in Backlog/Ticket aufgenommen
  • [ ] Empfehlungen bewertet (nicht alles ist wichtig)

Checkliste: SKILL.md erstellen

Für einen neuen Claude Code Skill.

Inhalt

  • [ ] name definiert (wird zum /slash-command)
  • [ ] description klar: Wann soll der Skill aktiviert werden? (für Auto-Trigger)
  • [ ] context gewählt: conversation (default), fork (read-only), project
  • [ ] allowed-tools beschränkt wenn Skill read-only sein soll
  • [ ] Instructions klar und konkret (nicht vage)
  • [ ] Output-Format definiert

Qualität

  • [ ] Eingabe-Format definiert: Was braucht der Skill um zu starten?
  • [ ] Fehlerfälle behandelt: Was wenn Input unvollständig ist?
  • [ ] Mit echtem Use Case getestet
  • [ ] Nach erstem Test iteriert

Speicherort

  • [ ] Global: ~/.claude/skills/[name]/SKILL.md (alle Projekte)
  • [ ] Lokal: ./.claude/skills/[name]/SKILL.md (dieses Projekt, Git-committed)

Checkliste: Ansible Playbook mit Claude generieren

Spezifisch für MSP/Netzwerk-Automatisierung.

Anforderungen definieren

  • [ ] Ziel-Plattform(en) klar: FortiGate? OPNsense? Cisco? Linux?
  • [ ] Genauer Scope: Was soll konfiguriert/geändert werden?
  • [ ] Inventory-Struktur bekannt (oder definiert)
  • [ ] Vault-Strategie klar: Welche Secrets müssen in Vault?
  • [ ] Idempotenz-Anforderung: Soll Playbook mehrfach laufen können?

Generierung

  • [ ] Plan Mode nutzen für komplexe Playbooks
  • [ ] Sub-Agents wenn mehrere Vendors parallel
  • [ ] Vendor-spezifische Collections im Skill/Kontext erwähnt

Review vor Ausführung

  • [ ] ansible-playbook --syntax-check läuft durch
  • [ ] ansible-playbook --check --diff auf Staging geprüft
  • [ ] Keine Klartext-Credentials in Tasks
  • [ ] no_log: true bei sensitiven Tasks
  • [ ] Tags vorhanden für selektive Ausführung
  • [ ] Handlers für Service-Restarts statt direkte command-Module

Checkliste: Infrastruktur-Doku erstellen

Vorbereitung

  • [ ] Scope klar: Was soll dokumentiert werden?
  • [ ] Zielgruppe klar: Für wen ist die Doku? (Selbst als Referenz, Kollegen, Kunden?)
  • [ ] Aktuelle Configs/Exports verfügbar

Dokumentation

  • [ ] Übersicht: Was macht die Infrastruktur?
  • [ ] Architektur-Diagramm (ASCII reicht)
  • [ ] Kritische Konfigurationsparameter dokumentiert
  • [ ] Bekannte Eigenheiten und Gotchas aufgeführt
  • [ ] Betriebsprozesse: Restart, Update, Troubleshooting

Qualität

  • [ ] Mit echtem Testfall verifiziert (nicht nur theoretisch)
  • [ ] Versionierung: Wann wurde die Doku erstellt/aktualisiert?
  • [ ] Lagerort klar und für Zielpersonen zugänglich