# Issue-Filing-Template (Shared Reference)

> **Single Source of Truth** — Alle Prompts in `.github/prompts/` verwenden dieses Template für GitHub-Issue-Erstellung.
>
> **Sprache: Issues werden IMMER auf Englisch verfasst** — Titel, Body und Kommentare. Die Drift-Community ist international; englische Issues sind Pflicht.

## Allgemeine Regeln

1. **Vor Erstellung** prüfen, ob ein passendes Issue bereits existiert
2. **Ein Issue pro Problem** — keine Sammel-Issues
3. **Evidenz-Pflicht** — exaktes Kommando, Version, Artefakt-Pfad angeben
4. **Nur reproduzierbare Defekte** — kein lokales Umgebungsrauschen
5. **Label**: `agent-ux` plus ggf. spezifischeres Label
6. **Sprache**: Englisch (Titel + Body + Kommentare)

## Erstellungskriterien

### Issues erstellen für

- Schritte mit Bewertung `fail` oder wiederholtem `review` ohne Recovery
- Reproduzierbare Produkt-Defekte, fehlende Anleitung oder Agent-UX-Lücken
- Inkonsistenzen zwischen Kommandos, die zu falschen Entscheidungen führen
- Fehlende Struktur, die automatisierte Weiterverarbeitung verhindert

### Keine Issues erstellen für

- Rein lokale Umgebungsprobleme ohne Produktbezug
- Subjektive Formatpräferenzen ohne Workflow-Auswirkung
- Probleme, die bereits durch ein bestehendes Issue abgedeckt sind
- Ambiguität, die nur durch fehlenden externen Kontext entsteht (den Drift nicht beansprucht bereitzustellen)

## Prioritätsreihenfolge

1. `fail`-Bewertungen (Workflow-Blocker)
2. `review`-Bewertungen mit `dark` Recovery (nicht auffindbar)
3. `review`-Bewertungen mit `pattern-match` Recovery (nur für Experten)
4. Cross-Command-Inkonsistenzen mit Entscheidungsimpact

## Titel-Format

```
[<prompt-prefix>] <concise one-sentence problem description in English>
```

Prompt-Kürzel (prefix):
- `agent-ux` — aus drift-agent-ux.prompt.md
- `workflow-test` — aus drift-agent-workflow-test.prompt.md
- `ai-integration` — aus drift-ai-integration.prompt.md
- `ci-gate` — aus drift-ci-gate.prompt.md
- `onboarding` — aus drift-onboarding.prompt.md
- `signal-quality` — aus drift-signal-quality.prompt.md
- `pr-review` — aus PR-Orchestrator.prompt.md
- `release` — aus release.prompt.md

## Body-Template (English)

```markdown
## Observed behavior

[What the agent/user actually received]

## Expected behavior

[What would have been needed to proceed safely]

## Reproduction

- drift version: [VERSION]
- Command: `drift ...`
- Repository/context: [REPO or SANDBOX]
- Evidence: [ARTIFACT-PATH]

## Impact

- [ ] Workflow blocker (agent cannot proceed)
- [ ] Misinterpretation risk (agent must guess)
- [ ] Missing structure (automation blocked)
- [ ] Cross-command inconsistency
- [ ] Misleading guidance

## Source

Auto-generated by `.github/prompts/<PROMPT-FILE>` on [DATE].
```

## Abschlussausgabe

Nach Issue-Erstellung:

```text
Created issues:
- #[NUMBER]: [TITLE] - [URL]

Skipped issues (already exist):
- [TITLE] -> #[NUMBER]
```
