# Dev Zyklus

> >

- **Type:** Skill
- **Install:** `agentstack add skill-ellmos-ai-skills-dev-cycle`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ellmos-ai](https://agentstack.voostack.com/s/ellmos-ai)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ellmos-ai](https://github.com/ellmos-ai)
- **Source:** https://github.com/ellmos-ai/skills/tree/master/skills/dev/dev-cycle
- **Website:** https://github.com/ellmos-ai/skills#readme

## Install

```sh
agentstack add skill-ellmos-ai-skills-dev-cycle
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Entwicklungszyklus (Dev-Zyklus)

> **Ziel:** Strukturierter Ablauf von Feature-Wunsch bis validiertem System.
> Jede Entwicklung durchlaeuft diese 8 Phasen.

---

## Uebersicht

```
  ┌──────────────────────────────────────────────────────────────────┐
  │                    ENTWICKLUNGSZYKLUS                            │
  ├──────────────────────────────────────────────────────────────────┤
  │                                                                  │
  │  Phase 1   Feature-Wuensche (Anforderungen funktional)           │
  │     │                                                            │
  │     v                                                            │
  │  Phase 2   Ist-Stand pruefen (Was gibt es schon?)                │
  │     │                                                            │
  │     v                                                            │
  │  Phase 3   Funktionale Planung                                   │
  │            (Workflows, Agenten, Experten, Skills, Services)      │
  │     │                                                            │
  │     v                                                            │
  │  Phase 4   Functional Frontend implementieren                    │
  │            (Skill-Dateien, Workflow-Markdown, Agent-Profile)      │
  │     │                                                            │
  │     v                                                            │
  │  Phase 5   Backend planen und ausrichten                         │
  │            (CLI-Handler, DB-Schema, API-Endpoints)               │
  │     │                                                            │
  │     v                                                            │
  │  Phase 6   Backend-Aufgaben umsetzen                             │
  │            (Python-Code, Tools, DB-Migrationen)                  │
  │     │                                                            │
  │     v                                                            │
  │  Phase 7   Technische Tests und Bugfixes                         │
  │            (B/O/E-Tests, Bugfix-Protokoll)                       │
  │     │                                                            │
  │     v                                                            │
  │  Phase 8   Funktions- und Featuretest: USECASES                  │
  │            (End-to-End Validierung aus Nutzersicht)               │
  │                                                                  │
  └──────────────────────────────────────────────────────────────────┘

  Grundprinzipien durchgaengig:
  - Funktionale Beschreibung zuerst (vor Code)
  - CLI First (alles ueber Terminal steuerbar)
  - Klare Trennung von User-Daten und System-Daten
```

---

## Phase 1: Feature-Wuensche (Anforderungen funktional)

**Was:** Funktionale Anforderungen sammeln und formulieren.

**Eingabe:**
- User-Wuensche, Ideen, Probleme
- Partner-Vorschlaege (LLM-Assistenten)
- Erkenntnisse aus Usecases (Rueckkopplung!)

**Ergebnis:**
- Tasks im Task-System (z.B. als Issue, Ticket oder TODO-Liste)
- Anforderung beschreibt WAS gewuenscht ist, nicht WIE

**Regeln:**
- Anforderungen immer funktional formulieren ("User kann X tun")
- Nicht technisch ("Implementiere REST-Endpoint fuer X")
- Usecases als Anforderungsquelle nutzen (Phase 8 -> Phase 1)

---

## Phase 2: Ist-Stand pruefen

**Was:** Vorhandene Funktionalitaet inventarisieren.

**Checkliste:**
```
  [ ] Bestehende Tools/Skripte durchsuchen
  [ ] Dokumentation/Hilfe zum Thema pruefen
  [ ] Vorhandene Skills/Agenten/Services pruefen
  [ ] DB-Schema pruefen (falls relevant)
  [ ] Usecases pruefen - wurde etwas Aehnliches getestet?
```

**Ergebnis:**
- Dokumentation was existiert, was fehlt, was erweitert werden muss
- Vermeidung von Duplikaten

---

## Phase 3: Funktionale Planung

**Was:** Auf der funktionalen Ebene planen - NICHT sofort Code schreiben.

**Planungs-Ebenen:**

| Ebene | Frage | Artefakt |
|-------|-------|----------|
| Workflow | WANN/WIE wird koordiniert? | workflows/*.md |
| Agent | WER fuehrt aus? | agents/*.txt |
| Experte | WER hat Fachwissen? | experts/*/ |
| Skill | WAS wird getan? | skills/*.md |
| Service | WIE wird es technisch getan? | services/*/ |

**Regeln:**
- Erst funktional denken, dann technisch
- Workflows beschreiben Ablaeufe, keine Implementierungsdetails
- Jeder Agent braucht ein klares Profil
- Services muessen ohne User-Daten funktionieren

---

## Phase 4: Functional Frontend implementieren

**Was:** Skill-Dateien, Workflow-Markdown, Agent-Profile erstellen.

Das "Frontend" ist hier die funktionale Beschreibungsebene:
- Workflow-Dateien (.md)
- Agent-Profile (.txt)
- Experten-Wissen
- Service-Beschreibungen
- Help-Dateien

**Ergebnis:**
- Alle funktionalen Beschreibungen existieren
- Ein LLM-Partner koennte den Workflow lesen und verstehen
- Die funktionale Ebene ist komplett dokumentiert

---

## Phase 5: Backend planen und ausrichten

**Was:** Technische Architektur auf das funktionale Frontend ausrichten.

**Planungs-Bereiche:**

| Bereich | Frage | Ort |
|---------|-------|-----|
| CLI-Handler | Welche Befehle? | handlers/*.py |
| DB-Schema | Welche Tabellen/Spalten? | schema/*.sql |
| API-Endpoints | Welche GUI-Endpunkte? | server.py |
| Tools | Welche Python-Scripts? | tools/*.py |

**Ergebnis:**
- Technischer Plan der sich am funktionalen Frontend orientiert
- DB-Schema-Entwurf
- CLI-Befehlsstruktur

---

## Phase 6: Backend-Aufgaben umsetzen

**Was:** Python-Code schreiben, DB-Migrationen, CLI-Handler.

**Checkliste (pro Aufgabe):**
```
  [ ] Funktioniert ohne User-Daten (leere DB)?
  [ ] CLI-Befehl vorhanden?
  [ ] Input kann aus Dateien/Ordnern kommen?
  [ ] Output geht in strukturierte DB?
  [ ] Scan/Import ist wiederholbar (idempotent)?
  [ ] Kein Hardcoded-Pfad?
  [ ] Tool registriert und dokumentiert?
  [ ] Help-Datei erstellt?
```

---

## Phase 7: Technische Tests und Bugfixes

**Was:** Technische Korrektheit sicherstellen.

**Test-Typen (B/O/E):**

| Typ | Perspektive | Beschreibung |
|-----|-------------|--------------|
| B-Tests | Extern/Automatisiert | Automatisierte Tests, CI/CD |
| O-Tests | Funktional (Input->Output) | Manuelle Funktionspruefung |
| E-Tests | Subjektiv/Erfahrung | UX-Bewertung, Ergonomie |

**Bei Bugs:**
- Bugfix-Protokoll anwenden
- 20-Minuten-Regel beachten (nach 20 Min. Ansatz wechseln)
- Lessons Learned dokumentieren

---

## Phase 8: Funktions- und Featuretest - USECASES

**Was:** End-to-End Validierung aus Nutzersicht.

**Usecases sind BEIDES:**
1. **Feature-Hinweisgeber** - Was ist gewuenscht? Was soll moeglich sein?
2. **Test-Szenarien** - Funktioniert es wirklich von A bis Z?

**Usecase-Format:**
```
  USECASE_NNN: Kurztitel

  VORBEDINGUNG: Was muss vorhanden sein?
  EINGABE:      Was gibt der User ein / welche Daten?
  ERWARTUNG:    Was soll herauskommen?
  PRUEFT:       Welche Komponenten werden getestet?
```

**Rueckkopplung:**
- Fehlgeschlagene Usecases -> neue Tasks in Phase 1
- Erfolgreiche Usecases -> validierte Features
- Neue Usecase-Ideen -> als Task erfassen

---

## Zusammenfassung: Der Kreislauf

```
  Phase 8 (Usecases)
       │
       │ Neue Anforderungen / Bugs
       v
  Phase 1 (Feature-Wuensche)  -->  Phase 2 (Ist-Stand)
       ^                                    │
       │                                    v
  Phase 7 (Tests/Bugs)         Phase 3 (Funktionale Planung)
       ^                                    │
       │                                    v
  Phase 6 (Backend Code)       Phase 4 (Functional Frontend)
       ^                                    │
       │                                    v
       └──────────────────── Phase 5 (Backend Planung)
```

Der Zyklus ist ein Kreislauf: Usecases validieren Features und
generieren gleichzeitig neue Anforderungen.

---

## Phasen-spezifische Skills

| Phase | Spezialisierter Skill | Trigger |
|-------|----------------------|---------|
| Phase 1-3 | Projekt-Bootstrapper (falls vorhanden) | Neues Projekt anlegen (Greenfield) |
| Phase 2 | [project-onboarding](../project-onboarding/SKILL.md) | Bestehendes Projekt aufnehmen |
| Phase 2-3 | [docs-analysis](../docs-analysis/SKILL.md) | Anforderungsdokumente gegen Code pruefen |
| Phase 5-6 | [pipeline-optimizer](../pipeline-optimizer/SKILL.md) | Bestehende Strukturen renovieren |
| Phase 7 | [bugfix-protocol](../bugfix-protocol/SKILL.md) | Systematisches 6-Phasen Debugging |
| Phase 7-8 | [bugsweep](../bugsweep/SKILL.md) | Konvergierender Bug-Sweep vor Release |

Falls deine Skill-Sammlung einen Skill-Index hat, dort nach weiteren phasen-spezifischen Skills suchen.

---

## Changelog

### 1.1.0 (2026-06-13)
- Neue Tabelle "Phasen-spezifische Skills" mit Verweisen auf project-onboarding, docs-analysis, pipeline-optimizer, bugfix-protocol und bugsweep

### 1.0.0 (2026-03-12)
- Portiert aus BACH (dev-zyklus v1.0.0)

---

*Erstellt: 2026-01-28 | Portiert: 2026-03-12*

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ellmos-ai](https://github.com/ellmos-ai)
- **Source:** [ellmos-ai/skills](https://github.com/ellmos-ai/skills)
- **License:** MIT
- **Homepage:** https://github.com/ellmos-ai/skills#readme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ellmos-ai-skills-dev-cycle
- Seller: https://agentstack.voostack.com/s/ellmos-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
