Communitygithub.com

Luijaa/web-template

Projete um novo sistema ou um recurso grande antes de qualquer código — entreviste em rodadas, escreva docs/design/<slug>.md a partir do modelo, ADRs e glossário, execute make docs-check e abra um PR apenas de documentação para aprovação. Use quando solicitado a projetar algo, ou quando /new-feature descobrir que o recurso é grande.

O que é web-template?

Esta skill orienta o processo de design de sistemas ou funcionalidades de grande porte antes de qualquer implementação de código. Ela é útil para garantir que a arquitetura e as decisões sejam documentadas e aprovadas pela equipe antes do desenvolvimento, evitando retrabalho. A skill é compatível com qualquer repositório que possua um arquivo `docs/design-process.md` e um Makefile com o target `docs-check`. O fluxo de trabalho segue etapas definidas: desde a avaliação da necessidade de design, criação de branches e arquivos de design, entrevistas estruturadas em rodadas com questões sobre bordas e ramificações, até a escrita incremental de documentação (design, ADRs, glossário, diagramas C4) e a abertura de Pull Requests exclusivos de documentação para aprovação. Ao final, a skill desmembra o design em issues menores para implementação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Luijaa/web-template/tree/HEAD/.agents/skills/design
Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

Design: $ARGUMENTS

Siga cada etapa de docs/design-process.md — esse arquivo é a regra; esta skill apenas organiza o trabalho. Se houver conflito, prevalece o arquivo.

  1. Precisa de design? — Compare com a tabela do tópico 1 de docs/design-process.md
    • Não: Justifique em uma linha e volte a usar new-feature
    • Não tem certeza: Pergunte primeiro
  2. Iniciar (tópico 3.0): issue épica (label design), branch docs/<id>-design-<slug>, copie docs/design/template.md → docs/design/<slug>.md (system.md ou <número da épica>-<slug>.md), defina status: draft e adicione uma linha em docs/design/README.md
  3. Leia antes de perguntar: CONTEXT.md, docs/adr/, docs/architecture.md, outro design em docs/design/ — fatos que você pode descobrir sozinho, pesquise por conta própria; não pergunte
  4. Entreviste em rodadas (tópico 3.1) no formato Qn — Tópico: Pergunta + Sugestão: … em cada item, 1–2 casos de borda por rodada — percorra os ramos A–H (tópico 3.2) completamente e aguarde a pessoa nos pontos de aprovação 1, 2 (sistema), 3
  5. Escreva no arquivo após cada rodada: tópicos no arquivo de design, novas palavras em CONTEXT.md, ADR proposed em docs/adr/ (+ índice), diagramas C4 em docs/architecture.md se contêineres/sistemas externos mudarem
  6. Verifique (tópico 3.3): make docs-check deve passar (repositório sem esse target no Makefile: python3 <caminho do web-template>/scripts/check-docs.py <repo> — time Hermes: /home/opc/projects/web-template) + checklist manual, depois defina status: proposed
  7. PR exclusivo de documentação: docs(design): <slug>, corpo com Refs #<epic>, resumo das alternativas ainda abertas e tópico ## CHANGELOG como - — sem código, sem merge
  8. Aprovação (tópico 3.4): quando a pessoa aprovar, commit com status: approved + approved-by + ADR como accepted no mesmo PR (make docs-check deve passar), então a pessoa faz o merge
  9. Após o merge (tópico 3.5): abra issues filhas conforme o tópico 13, uma por vez, cada uma linkando a épica e o arquivo de design — o trabalho de código começa com 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.

Habilidades Relacionadas

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