Von der Story bis zum Deploy

So läuft eine Aufgabe bei AWL ab, wenn Claude Code mitarbeitet. Die Schritte sind keine Vorschrift für jede Kleinigkeit – ein Tippfehler braucht keine sieben Stationen. Für alles ab einer Story gilt die Reihenfolge.

1. Story klären
2. Verstehen
3. Umsetzen
4. Testen
5. Prüfen
6. Ausliefern
7. Lernen

Story klären

Code entsteht erst, wenn klar ist, was fertig heisst. clickup-stories legt User Stories mit Akzeptanzkriterien in ClickUp an und pflegt sie.

Sag zu ClaudeKopieren

Schreib eine User Story für den Passwort-Reset per E-Mail in die Liste «Sprint 12».

Verstehen

Je nach Ausgangslage:

• Etwas ist kaputt → analyse-bug reproduziert den Fehler, grenzt die Ursache ein und liefert eine strukturierte Diagnose. Erst danach wird gefixt.
• Neue oder aktualisierte Dependency → research holt die offizielle Doku, bevor Claude aus dem Gedächtnis eine veraltete API verwendet.
• Fremde Codebase → explain-codebase für den schnellen Einstieg.

BugKopieren

Der Upload bricht bei Dateien über 10 MB ab – not working seit dem letzten Release.

Umsetzen

Hier arbeiten die Stack-Plugins. Sie kennen die AWL-Templates und internen Pakete:

• Android und Kotlin Multiplatform: kotlin-expert
• iOS und SwiftUI: swiftui-expert-skill
• SvelteKit und Payload: awl-npm-packages – zuerst schauen, was @awl/* schon löst
• Neue oder bestehende SvelteKit-App mit den @awl/*-Paketen verdrahten: sveltekit-app-setup
• Payload-Backend mit den @awl/payload-*-Paketen erweitern: payload-plugins
• UI-Komponenten mit AWL-Tokens: component-gen

Für grosse Aufgaben über viele Dateien verteilt orchestrator die Arbeit auf parallele Subagents.

Testen

Der Agent Tester schreibt Tests im Stil des jeweiligen Stacks und nutzt dafür testing-web, testing-swift, testing-android und testing-dotnet.

Sag zu ClaudeKopieren

@awl-testing:Tester schreib Tests für den neuen PasswordResetService.

Prüfen

Vor jedem Merge Request:

• review sucht Bugs, Sicherheitsprobleme und bekannte Fehler-Muster.
• ac-checker prüft jedes Akzeptanzkriterium der Story gegen den Code.
• design-review findet hartcodierte Farben und Abstände, wo Design-Tokens hingehören.

Sag zu ClaudeKopieren

Review meine Änderungen und check danach die ACs.

Ausliefern

gitlab-cicd richtet die Pipeline mit den AWL-Komponenten ein, deploying-to-kubernetes den Deploy-Job. Bevor eine Deploy-Änderung gemergt wird, läuft pre-deploy-check – er prüft CI-Variablen, Protected Branches und DEPLOYMENT_VALUES gegen den echten GitLab-Stand, bevor ArgoCD rot wird.

Sag zu ClaudeKopieren

Can I merge this? Mach den pre-deploy check.

Den ganzen Weg zeigt das Playbook Web-App deployen.

Lernen

Am Ende einer Session hält reflect fest, was Claude beim nächsten Mal besser wissen sollte – als Regel in CLAUDE.md oder im Memory.

Sag zu ClaudeKopieren

/awl-general:reflect