Communitygithub.com

Luijaa/web-template

Concevez un nouveau système ou une fonctionnalité importante avant d'écrire du code — menez des entretiens par cycles, rédigez un fichier docs/design/<slug>.md à partir du modèle, les ADR et un glossaire, exécutez make docs-check, et ouvrez une PR uniquement documentaire pour approbation. Utilisez-le lorsqu'on vous demande de concevoir quelque chose, ou lorsque /new-feature détermine que la fonctionnalité est volumineuse.

Qu'est-ce que web-template ?

Cette compétence guide le processus de conception formelle d'une fonctionnalité ou d'un système majeur, en suivant scrupuleusement le manuel `docs/design-process.md`. Elle orchestre un flux structuré : vérification de la nécessité d'une conception, création d'un epic issue et d'une branche dédiée `docs/<id>-design-<slug>`, puis conduite d'entretiens par cycles. Chaque cycle génère des questions structurées (`Qn — Sujet : Question` + `Recommandation : …`), explore les alternatives de A à H, et attend les points d'approbation prédéfinis. Après chaque cycle, le skill met à jour le fichier de conception, le glossaire, les ADR (Decision Records) en statut `proposed`, et les diagrammes C4 si nécessaire. Il garantit la qualité via `make docs-check` (ou un script équivalent) avant d'ouvrir une Pull Request purement documentaire. Une fois la PR approuvée et mergée (mise à jour des ADR en `accepted`), le skill génère des issues enfants pour chaque sous-tâche, prêtes pour le développement avec `/new-feature`. Il prend en charge les référentiels disposant d'un `docs/design-process.md` et d'une structure de dossiers `docs/design/`, `docs/adr/`, `CONTEXT.md` et `docs/architecture.md`. La conception produit un fichier de conception, un glossaire, des ADR, un diagramme C4 mis à jour, et un ensemble d'issues prêtes pour le développement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Luijaa/web-template/tree/HEAD/.agents/skills/design
Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Conception : $ARGUMENTS

Suivez toutes les étapes de docs/design-process.md — ce fichier est la règle, cette compétence n'est que l'ordre de travail. En cas de conflit, référez-vous à ce fichier.

  1. Faut-il concevoir ? — Comparez avec le tableau du sujet 1 de docs/design-process.md
    • Pas nécessaire : donnez une raison en une ligne, puis revenez à new-feature
    • Incertain : demandez à la personne
  2. Démarrage (sujet 3.0) : epic issue (label design), branche docs/<id>-design-<slug>, copiez docs/design/template.md → docs/design/<slug>.md (system.md ou <numéro epic>-<slug>.md), définissez status: draft et ajoutez une ligne dans docs/design/README.md
  3. Lire avant de demander : CONTEXT.md, docs/adr/, docs/architecture.md, autres conceptions dans docs/design/ — les faits que vous pouvez trouver seul, trouvez-les seul, ne demandez pas
  4. Entretiens par cycles (sujet 3.1) format Qn — Sujet : Question + Recommandation : … pour chaque question, 1–2 cas limites par cycle — parcourez les branches A–H (sujet 3.2) complètement et arrêtez-vous aux points d'approbation 1, 2 (système), 3 en attendant la personne
  5. Écrire dans le fichier après chaque cycle : sections dans le fichier de conception, nouveaux termes dans CONTEXT.md, ADR proposed dans docs/adr/ (+ index), diagramme C4 dans docs/architecture.md si le conteneur/système externe change
  6. Vérification (sujet 3.3) : make docs-check doit réussir (dépôt sans cette cible Makefile : python3 <chemin de web-template>/scripts/check-docs.py <dépôt> — équipe Hermes : /home/opc/projects/web-template) + auto-vérification, puis définissez status: proposed
  7. PR uniquement documentaire : docs(design): <slug>, corps avec Refs #<epic>, résumé des alternatives encore ouvertes et section ## CHANGELOG avec - — pas de code, pas de merge
  8. Approbation (sujet 3.4) : lorsque la personne approuve, commit avec status: approved + approved-by + ADR passe à accepted dans la même PR (make docs-check doit réussir), puis laissez la personne merger
  9. Après le merge (sujet 3.5) : ouvrez des issues enfants selon le sujet 13, une par sous-tâche, chacune liée à l'epic et au fichier de conception — le travail de code commence par 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.

Skills associés

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