$npx -y skills add Svenja-dev/claude-code-skills --skill prompt-architectTransformiert Anforderungen in Best-Practice Prompts nach Claude 4.x Standards (Dezember 2025). Basiert auf: - Nate B. Jones 4 Beginner Moves: Shape, Context, Silent Plan, Self-Check - Anthropic Claude 4.x Best Practices: Explizitheit, Contract-Style, Examples beat Adjectives - P
| 1 | # Prompt-Architect: Best-Practice Prompt Generator |
| 2 | |
| 3 | ## Basiert auf Claude 4.x Best Practices (Dezember 2025) |
| 4 | |
| 5 | ### Quellen: |
| 6 | - Nate B. Jones Prompting Playbook 2025 |
| 7 | - Anthropic Official Claude 4.x Prompting Guide |
| 8 | - Claude Code Best Practices |
| 9 | |
| 10 | ## AKTIVIERUNG |
| 11 | |
| 12 | **Nur manuell.** Dieser Skill aktiviert sich NICHT automatisch — auch nicht nach |
| 13 | clarify-spec. Die fruehere Auto-Kette (clarify-spec -> prompt-architect) wurde |
| 14 | entfernt, weil sie eine Klaerungs-Schleife verstaerkt hat. |
| 15 | |
| 16 | ### Manuell mit Trigger |
| 17 | /prompt-architect [Aufgabenbeschreibung] |
| 18 | |
| 19 | Falls ein clarify-spec-Lauf vorausging und ein JSON-Ergebnis vorliegt, kann |
| 20 | prompt-architect dieses JSON nutzen — aber nur, wenn der User /prompt-architect |
| 21 | explizit aufruft. |
| 22 | |
| 23 | ## Die 4 Beginner Moves (Nate B. Jones) |
| 24 | |
| 25 | ### Move 1: Define the Shape of Output |
| 26 | NICHT: Schreib guten Code |
| 27 | SONDERN: Produziere eine TypeScript-Datei mit Interface X, exportiere Funktion Y |
| 28 | |
| 29 | Konkrete Artefakte definieren: |
| 30 | - Welche Dateien werden erstellt/geaendert? |
| 31 | - Welches Format hat der Output? |
| 32 | - Wie sieht ein Beispiel-Output aus? |
| 33 | |
| 34 | ### Move 2: Give Minimal but Sufficient Context |
| 35 | - Automatisch relevante Dateien einlesen |
| 36 | - CLAUDE.md/AGENTS.md Auszuege |
| 37 | - Nur das Noetige - kein Context-Overflow |
| 38 | - Token Budget beachten |
| 39 | |
| 40 | ### Move 3: Suggest a Silent Plan |
| 41 | - Claude soll INTERN planen bevor es antwortet |
| 42 | - Bei Claude 4.5: consider your approach first |
| 43 | - Vermeidung von think bei deaktiviertem Extended Thinking |
| 44 | |
| 45 | ### Move 4: Add a Quick Self-Check |
| 46 | - Evaluator-Block am Ende des Prompts |
| 47 | - Checkliste: Format eingehalten? Constraints erfuellt? |
| 48 | - Before responding, verify: [checklist] |
| 49 | |
| 50 | ## Claude 4.x Spezifische Patterns |
| 51 | |
| 52 | ### Explizitheit + Modifier |
| 53 | NICHT: Create dashboard |
| 54 | SONDERN: Create dashboard. Include as many relevant features as possible. Go beyond the basics. |
| 55 | |
| 56 | ### Context + Motivation (WARUM erklaert WAS) |
| 57 | NICHT: NEVER use ellipses |
| 58 | SONDERN: Your response will be read aloud by TTS, so never use ellipses since TTS cannot pronounce them. |
| 59 | |
| 60 | ### Examples beat Adjectives |
| 61 | NICHT: Schreib professionell |
| 62 | SONDERN: Beispiel-Output zeigen, Format demonstrieren |
| 63 | |
| 64 | ### XML-Tags fuer Struktur |
| 65 | <output_structure>, <constraints>, <verification> |
| 66 | |
| 67 | ### Uncertainty Permission |
| 68 | If unsure, state explicitly and ask clarifying question. |
| 69 | Reduziert Halluzinationen drastisch. |
| 70 | |
| 71 | ## Das Contract-Style Template |
| 72 | |
| 73 | Nach Analyse des Auftrags, generiere diesen strukturierten Prompt: |
| 74 | |
| 75 | ---BEGIN GENERATED PROMPT--- |
| 76 | |
| 77 | ## ROLE and GOAL |
| 78 | You are: [Rolle basierend auf Task-Typ, z.B. Senior TypeScript Developer] |
| 79 | Goal: [Konkrete Erfolgsdefinition in 1 Satz aus clarified_task.goal] |
| 80 | |
| 81 | ## CONTEXT |
| 82 | [Automatisch gesammelt:] |
| 83 | - Projekt: [Projektname aus CLAUDE.md] |
| 84 | - Relevante Dateien: [Liste mit kurzem Inhaltsuebersicht] |
| 85 | - Bestehende Patterns: [Aus Codebase extrahiert] |
| 86 | - No-Touch Zones: [Aus clarified_task.scope.no_touch] |
| 87 | |
| 88 | ## CONSTRAINTS |
| 89 | - [Constraint 1 als Bullet aus clarified_task.constraints] |
| 90 | - [Constraint 2 als Bullet] |
| 91 | - [Max 5 Constraints] |
| 92 | - If unsure about any aspect: State explicitly and ask for clarification |
| 93 | |
| 94 | ## TASK |
| 95 | [Klare Aufgabenbeschreibung aus clarified_task.goal + problem_statement] |
| 96 | |
| 97 | ### Success Criteria |
| 98 | - [Kriterium 1 aus clarified_task.success_criteria] |
| 99 | - [Kriterium 2] |
| 100 | - All existing tests must pass |
| 101 | |
| 102 | ### Examples (if examples_needed = true) |
| 103 | Input: [Beispiel-Input] |
| 104 | Expected Output: [Erwarteter Output] |
| 105 | |
| 106 | ## OUTPUT FORMAT |
| 107 | <output_structure> |
| 108 | [Exaktes Format basierend auf Task-Typ:] |
| 109 | - Fuer Code: Vollstaendige Dateien, keine Diffs, keine Platzhalter |
| 110 | - Fuer Docs: Markdown mit Headings |
| 111 | - Fuer Config: JSON/YAML mit Kommentaren |
| 112 | </output_structure> |
| 113 | |
| 114 | ## VERIFICATION (Self-Check) |
| 115 | Before responding, verify: |
| 116 | [ ] Output format followed exactly? |
| 117 | [ ] All constraints from CONSTRAINTS section satisfied? |
| 118 | [ ] All success criteria from TASK section met? |
| 119 | [ ] Uncertain claims marked with [UNCERTAIN]? |
| 120 | [ ] No changes to No-Touch Zones? |
| 121 | |
| 122 | ---END GENERATED PROMPT--- |
| 123 | |
| 124 | ## Workflow |
| 125 | |
| 126 | ### Schritt 1: Input analysieren |
| 127 | |
| 128 | Akzeptiert: |
| 129 | 1. JSON oder Kontext aus einem vorherigen clarify-spec-Lauf, wenn der User danach |
| 130 | explizit /prompt-architect aufruft |
| 131 | 2. Freie Textbeschreibung |
| 132 | 3. Kombiniert mit aktuellem Projekt-Kontext |
| 133 | |
| 134 | ### Schritt 2: Kontext automatisch sammeln |
| 135 | |
| 136 | - Glob fuer relevante Dateien |
| 137 | - Read CLAUDE.md/AGENTS.md |
| 138 | - Identify No-Touch Zones |
| 139 | - Extract existing patterns from codebase |
| 140 | |
| 141 | ### Schritt 3: Template ausfuellen |
| 142 | |
| 143 | Fuelle das Contract-Style Template mit: |
| 144 | - Role basierend auf Task-Typ (F |