Communitygithub.com

Design: $ARGUMENTS

Ein neues System oder eine große Funktion entwerfen, bevor Code geschrieben wird – in Runden interviewen, docs/design/<slug>.md aus der Vorlage erstellen, ADRs und Glossar anlegen, make docs-check ausführen und einen dokumentationsreinen PR zur Freigabe öffnen. Verwenden, wenn ein Design gefordert wird oder /new-feature ergibt, dass die Funktion umfangreich ist.

Was ist Design: $ARGUMENTS?

Dieses Skill führt strukturiert durch den gesamten Design-Prozess für neue Systeme oder große Features, bevor Code implementiert wird. Es folgt strikt der `docs/design-process.md` und stellt sicher, dass Entwürfe durch mehrere Runden von Anforderungsinterviews und Dokumentation iterativ verfeinert werden. Der Skill unterstützt die Erstellung von Design-Dokumenten, ADRs (Architecture Decision Records) und C4-Modellen und validiert die Ergebnisse mit `make docs-check`. Nach der Freigabe durch einen PR wird automatisch eine Reihe von Sub-Issues für die Implementierung erstellt. Geeignet für Agenten wie Claude Code, Cursor oder Codex, die in einem Repository mit einer definierten Design-Dokumentation arbeiten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Luijaa/web-template/tree/HEAD/.agents/skills/design
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Was macht Design: $ARGUMENTS?

Befolge docs/design-process.md in jedem Schritt – diese Datei ist die Richtlinie; dieses Skill gibt nur die Reihenfolge der Arbeiten vor. Bei Widersprüchen gilt die Datei.

  1. Muss ein Design erstellt werden? – Vergleiche mit der Tabelle in Abschnitt 1 von docs/design-process.md
    • Nein: Grund in einer Zeile angeben und zu new-feature zurückkehren.
    • Unsicher: Vorher beim Menschen nachfragen.
  2. Starten (Abschnitt 3.0): Epic-Issue (Label design), Branch docs/<id>-design-<slug>, kopiere docs/design/template.md nach docs/design/<slug>.md (system.md oder <epic-id>-<slug>.md), setze status: draft und füge eine Zeile in docs/design/README.md hinzu.
  3. Vor dem Fragen lesen: CONTEXT.md, docs/adr/, docs/architecture.md, andere Designs in docs/design/ – selbstständig beschaffbare Fakten selbst suchen, nicht fragen.
  4. In Runden interviewen (Abschnitt 3.1) Format Qn — Thema: Frage + Empfehlung: … für jede Frage, 1–2 Randbedingungen pro Runde – alle Zweige A–H (Abschnitt 3.2) durchgehen und an den Genehmigungspunkten 1, 2 (System) und 3 auf Freigabe warten.
  5. Nach jeder Runde in Dateien schreiben: Abschnitte in der Design-Datei, neue Einträge in CONTEXT.md, ADR proposed in docs/adr/ (+ Index), C4-Diagramm in docs/architecture.md, falls Container/externe Systeme geändert wurden.
  6. Prüfen (Abschnitt 3.3): make docs-check muss bestehen (Repository ohne diesen Make-Target: python3 <pfad-zu-web-template>/scripts/check-docs.py <repo> – Team Hermes: /home/opc/projects/web-template) + selbst prüfen und dann status: proposed setzen.
  7. Reiner Dokumentations-PR: docs(design): <slug>, Body mit Refs #<epic>, Zusammenfassung der noch offenen Alternativen und Abschnitt ## CHANGELOG mit - – kein Code, kein Merge.
  8. Genehmigung (Abschnitt 3.4): Wenn der Genehmiger committed: status: approved + approved-by + ADR auf accepted setzen im selben PR (make docs-check muss bestehen) – dann vom Menschen mergen lassen.
  9. Nach dem Merge (Abschnitt 3.5): Sub-Issues gemäß Abschnitt 13 Stück für Stück öffnen, jedes verlinkt auf das Epic und die Design-Datei – Codierungsarbeit beginnt mit new-feature.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Luijaa/web-template

Fix a reported bug or failing test — reproduce it as a failing test first, trace the fail path, try to disprove each hypothesis, keep an experiment log, fix the root cause, look for the same bug elsewhere, and record root cause and why it slipped through in the PR. Use when a bug is reported, something is broken or throwing, a test or CI job fails, or an error log or stack trace is pasted.

Luijaa/web-template

Start a new feature end-to-end in this repo — clarify requirements, plan, branch, implement with tests, and prepare a PR. Use when asked to add a feature, page, or endpoint.

Luijaa/web-template

Run the full pre-PR checklist (make check, secret scan, docs, diff review) before opening or updating a pull request. Use before creating a PR or when asked if work is ready.

Luijaa/web-template

Review a pull request or branch diff against main — read-only. Checks intent and simpler alternatives, traces real code paths beyond the diff, then runs the repo checklist (CI, tests, authz and user-supplied ids, dependencies and EOL, security, audit/session/health, UI/i18n, design, bug-fix evidence, core rule files) and reports must-fix items with evidence and a one-line verdict. Use before opening a PR, when asked to review, or when assigned a review card.

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community