zip — Claude Code Plugin

Feature-Development-Pipeline für Claude Code. Von Discovery bis Deployment mit Quality Gates, Multi-Agent-Orchestrierung und Conflict-Aware Merge-Strategie.

Version: 2.0.0 · Autor: zipmend

---

Installation

# 1. Marketplace hinzufügen
/plugin marketplace add annaundflora/cc-agents

# 2. Plugin installieren
/plugin install zip@annaundflora

---

Workflow

Discovery → Wireframe → Architecture → Planning → Implementation → Testing
    │            │            │            │              │              │
  Gate 0      Gate 0       Gate 1      Gate 2/3     Code Review     QA Manual

Jede Phase wird von einem dedizierten Command gesteuert. Quality Gates validieren automatisch nach jeder Phase.

---

Commands

Command	Beschreibung
/zip:discovery	Feature-Konzeption: strukturierte Q&A-Session → Discovery-Dokument
/zip:wireframe	Wireframes + UX Expert Review + Gate 0 Compliance (max 3 Retries)
/zip:architecture	Technische Architektur + Gate 1 Compliance (max 3 Retries)
/zip:planner	Slice-Planung: ACs + Tests, kein Code. Gate 2 (pro Slice) + Gate 3. Anti-Bias-Fixes.
/zip:orchestrate	Feature-Implementierung Wave-by-Wave. 6-Step Pipeline mit 9 Retries.
/zip:roadmap	Strategische Produkt-Orientierung: Navigator, Priorisierer, Analyst.
/zip:debugger	Systematische Fehlersuche (Hypothese → Logs → Analyse → Fix).
/zip:design-explore	Interaktiver Design-Prozess mit Varianten und Design System Recherche.
/zip:qa-manual	Geführtes manuelles Feature-Testing mit Bug-Dokumentation.
/zip:pm-ux-review-de	UX Expert Review mit automatischem Versioning.
/zip:conflict-scan	Manueller Conflict-Scan gegen parallele Pipeline-Sessions.

---

Agents (Sub-Agents)

Die folgenden Agents werden von Commands via Task() aufgerufen — sie arbeiten autonom im Hintergrund.

Discovery & Konzeption

Agent	Aufgabe
discovery	Feature-Konzeption: divergiert (Optionen) → konvergiert (Scope, States, Flows)
wireframe	ASCII-Wireframes für Stakeholder-Validierung
architecture	Technische Konzeption: API, Datenbank, Security-Design
design-explore	Interaktiver Design-Prozess mit Varianten und Pencil-Integration
roadmap	Strategischer Roadmap-Agent
ux-expert-review-de	Senior UX Expert Review auf Deutsch

Quality Gates

Agent	Gate	Prüft
discovery-wireframe-compliance	Gate 0	Discovery → Wireframe bidirektionale Konsistenz
architecture-compliance	Gate 1	Architecture gegen Discovery + Wireframes
slice-compliance	Gate 2	Hybrid: deterministische Struktur-Checks + LLM-Inhalts-Checks
integration-map	Gate 3	E2E-Validierung nach allen Slices

Planning & Implementation

Agent	Aufgabe
slicer	Zerlegt Discovery-Slices in atomare 1-3-Datei-Tasks
slice-writer	Schlanke Slice-Specs: ACs + Test-Skeletons + Contracts
slice-implementer	Task-Driven Implementierung gegen ACs + Architecture

Review & Testing

Agent	Aufgabe
code-reviewer	Adversarial AC-basierter Code-Review gegen Spec + Architecture
test-writer	Schreibt Tests gegen Slice ACs. 100% AC-Coverage.
test-validator	Führt alle Test-Stages aus, liefert strukturierten JSON-Report
debugger	Wissenschaftliche Fehlersuche: Hypothese → Logs → Fix

Conflict-Aware Pipeline

Agent	Aufgabe
conflict-scanner	Extrahiert Claims, berechnet Overlaps, verwaltet GitHub Issues
conflict-reporter	Liest overlap-report.json, kommentiert betroffene GitHub Issues

QA

Agent	Aufgabe
qa-manual	Manuelles Feature-Testing mit User-Interaktion + Bug-Summary

---

Templates

Template	Verwendung
discovery-feature.md	Basis-Template für Discovery-Dokumente
architecture-feature.md	Basis-Template für Architecture-Dokumente
plan-spec.md	Slice-Spezifikations-Template
wireframe-template.md	Wireframe-Struktur
roadmap.md	Roadmap-Template
project.md	Projekt-Kontext-Template
summary.md	Feature-Summary-Template
checkpoint-example.md	Checkpoint-Dokumentation
ui-implementation-checklist.md	UI-Implementierungs-Checkliste
design-decisions-template.md	Design-Entscheidungen-Dokumentation
weave-setup.md	Installations-Anleitung für Weave CLI + rerere
gitattributes-weave.template	.gitattributes mit Weave merge driver + funcname-Patterns

---

Updates

Auto-Update ist für Third-Party-Marketplaces standardmäßig deaktiviert.

Manuell updaten:

claude plugin update zip

Auto-Update aktivieren:

/plugin → Marketplaces → annaundflora → Enable auto-update

Neue Plugin-Versionen erfordern immer einen Version-Bump in plugin.json UND marketplace.json — ohne Bump in beiden Dateien erkennt Claude Code keine neue Version.