svenja-dev/prompt-architect

Prompt-Architect: Best-Practice Prompt Generator

Basiert auf Claude 4.x Best Practices (Dezember 2025)

Quellen:

• Nate B. Jones Prompting Playbook 2025
• Anthropic Official Claude 4.x Prompting Guide
• Claude Code Best Practices

AKTIVIERUNG

Nur manuell. Dieser Skill aktiviert sich NICHT automatisch — auch nicht nach clarify-spec. Die fruehere Auto-Kette (clarify-spec -> prompt-architect) wurde entfernt, weil sie eine Klaerungs-Schleife verstaerkt hat.

Manuell mit Trigger

/prompt-architect [Aufgabenbeschreibung]

Falls ein clarify-spec-Lauf vorausging und ein JSON-Ergebnis vorliegt, kann prompt-architect dieses JSON nutzen — aber nur, wenn der User /prompt-architect explizit aufruft.

Die 4 Beginner Moves (Nate B. Jones)

Move 1: Define the Shape of Output

NICHT: Schreib guten Code SONDERN: Produziere eine TypeScript-Datei mit Interface X, exportiere Funktion Y

Konkrete Artefakte definieren:

• Welche Dateien werden erstellt/geaendert?
• Welches Format hat der Output?
• Wie sieht ein Beispiel-Output aus?

Move 2: Give Minimal but Sufficient Context

• Automatisch relevante Dateien einlesen
• CLAUDE.md/AGENTS.md Auszuege
• Nur das Noetige - kein Context-Overflow
• Token Budget beachten

Move 3: Suggest a Silent Plan

• Claude soll INTERN planen bevor es antwortet
• Bei Claude 4.5: consider your approach first
• Vermeidung von think bei deaktiviertem Extended Thinking

Move 4: Add a Quick Self-Check

• Evaluator-Block am Ende des Prompts
• Checkliste: Format eingehalten? Constraints erfuellt?
• Before responding, verify: [checklist]

Claude 4.x Spezifische Patterns

Explizitheit + Modifier

NICHT: Create dashboard SONDERN: Create dashboard. Include as many relevant features as possible. Go beyond the basics.

Context + Motivation (WARUM erklaert WAS)

NICHT: NEVER use ellipses SONDERN: Your response will be read aloud by TTS, so never use ellipses since TTS cannot pronounce them.

Examples beat Adjectives

NICHT: Schreib professionell SONDERN: Beispiel-Output zeigen, Format demonstrieren

XML-Tags fuer Struktur

<output_structure>, <constraints>, <verification>

Uncertainty Permission

If unsure, state explicitly and ask clarifying question. Reduziert Halluzinationen drastisch.

Das Contract-Style Template

Nach Analyse des Auftrags, generiere diesen strukturierten Prompt:

---BEGIN GENERATED PROMPT---

ROLE and GOAL

You are: [Rolle basierend auf Task-Typ, z.B. Senior TypeScript Developer] Goal: [Konkrete Erfolgsdefinition in 1 Satz aus clarified_task.goal]

CONTEXT

[Automatisch gesammelt:]

• Projekt: [Projektname aus CLAUDE.md]
• Relevante Dateien: [Liste mit kurzem Inhaltsuebersicht]
• Bestehende Patterns: [Aus Codebase extrahiert]
• No-Touch Zones: [Aus clarified_task.scope.no_touch]

CONSTRAINTS

• [Constraint 1 als Bullet aus clarified_task.constraints]
• [Constraint 2 als Bullet]
• [Max 5 Constraints]
• If unsure about any aspect: State explicitly and ask for clarification

TASK

[Klare Aufgabenbeschreibung aus clarified_task.goal + problem_statement]

Success Criteria

• [Kriterium 1 aus clarified_task.success_criteria]
• [Kriterium 2]
• All existing tests must pass

Examples (if examples_needed = true)

Input: [Beispiel-Input] Expected Output: [Erwarteter Output]

OUTPUT FORMAT

<output_structure> [Exaktes Format basierend auf Task-Typ:]

• Fuer Code: Vollstaendige Dateien, keine Diffs, keine Platzhalter
• Fuer Docs: Markdown mit Headings
• Fuer Config: JSON/YAML mit Kommentaren </output_structure>

VERIFICATION (Self-Check)

Before responding, verify: [ ] Output format followed exactly? [ ] All constraints from CONSTRAINTS section satisfied? [ ] All success criteria from TASK section met? [ ] Uncertain claims marked with [UNCERTAIN]? [ ] No changes to No-Touch Zones?

---END GENERATED PROMPT---

Workflow

Schritt 1: Input analysieren

Akzeptiert:

1. JSON oder Kontext aus einem vorherigen clarify-spec-Lauf, wenn der User danach explizit /prompt-architect aufruft
2. Freie Textbeschreibung
3. Kombiniert mit aktuellem Projekt-Kontext

Schritt 2: Kontext automatisch sammeln

• Glob fuer relevante Dateien
• Read CLAUDE.md/AGENTS.md
• Identify No-Touch Zones
• Extract existing patterns from codebase

Schritt 3: Template ausfuellen

Fuelle das Contract-Style Template mit:

• Role basierend auf Task-Typ (Frontend, Backend, DevOps, etc.)
• Goal aus clarified_task.goal
• Context aus Projekt-Analyse
• Constraints aus clarified_task.constraints
• Task aus goal + problem_statement
• Output Format basierend auf erwarteten Artefakten
• Verification Checklist

Schritt 4: Prompt praesentieren

Zeige den generierten Prompt dem User:

---

Generierter Best-Practice Prompt

[Vollstaendiger Prompt hier]

---

Optionen:

• ausfuehren: Diesen Prompt jetzt ausfuehren
• anpassen: Prompt modifizieren
• kopieren: Prompt in Zwischenablage
• speichern: Als Template speichern

Schritt 5: Ausfuehrung

Bei ausfuehren:

1. Prompt intern verwenden
2. Mit Quality Gates (wenn /supervisor aktiv)
3. Ergebnis praesentieren

Beispiel: Vom vagen Auftrag zum Best-Practice Prompt

Input (von clarify-spec):

{ clarified_task: { goal: PPTX-Export fixen, damit AI-Bilder zuverlaessig erscheinen, problem_statement: Bilder fehlen manchmal im PPTX-Download, scope: { files: [presentationBuilder.ts, chartVisualGenerator.ts], no_touch: [api/analyze.ts] }, success_criteria: [Alle Bilder erscheinen, Unter 500KB, Keine Errors], constraints: [Keine Breaking Changes] } }

Output (generierter Prompt):

ROLE and GOAL

You are: Senior TypeScript Developer specializing in browser-based file generation Goal: Fix PPTX export so AI-generated images reliably appear in downloaded files

CONTEXT

• Projekt: fabrikIQ Analyzer (Manufacturing AI Platform)
• Relevante Dateien:
  • presentationBuilder.ts: PptxGenJS integration, slide generation
  • chartVisualGenerator.ts: Gemini image generation, base64 handling
• Bestehende Patterns: Async/await, try-catch error handling
• No-Touch Zones: api/analyze.ts (core analysis)

CONSTRAINTS

• No breaking changes to existing PPTX export functionality
• Images must be compressed to under 500KB
• Maintain existing error handling patterns
• If unsure about any aspect: State explicitly and ask

TASK

Fix the PPTX export to ensure AI-generated images reliably appear in downloads. The current issue: Images sometimes fail to appear in the final PPTX file.

Success Criteria

• All AI-generated images appear in PPTX
• Image file size under 500KB each
• No console errors during download
• Existing tests still pass

OUTPUT FORMAT

<output_structure> Provide complete, modified TypeScript files. No diffs, no placeholders, no partial implementations. Include brief comments explaining key changes. </output_structure>

VERIFICATION

Before responding, verify: [ ] All images will be embedded correctly? [ ] Compression logic handles edge cases? [ ] No changes to api/analyze.ts? [ ] Error handling covers network failures?

Token-Effizienz

Der generierte Prompt ist optimiert fuer:

• Minimaler Context (nur relevante Infos)
• Maximale Klarheit (keine Ambiguitaet)
• Self-Verification (reduziert Iterationen)

Integration

Nach clarify-spec

clarify-spec -> User ruft /prompt-architect explizit auf -> Prompt -> Ausfuehrung

Mit /supervisor

prompt-architect -> Prompt -> /supervisor -> Quality Gates -> Ergebnis

Standalone

/prompt-architect [Aufgabe] -> Prompt -> Ausfuehrung