convez.ai
SkillProdutividadeIntermediário
iliyanyotov

House Rules

iliyanyotov/house-rules

Princípios de engenharia que realmente funcionam em produção

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto de skills para Claude Code com princípios e padrões de engenharia de software extraídos de bugs em produção, refatorações reais e patterns que persistem em diferentes formatos de equipe. Cobre correção dirigida por tipos, resiliência, testes, gestão de mudanças e meta-princípios como KISS e YAGNI.

Instalação

$npx convez-ai iliyanyotov/house-rules

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Estruturar código mais robusto e resiliente
  • Estabelecer padrões consistentes em equipes
  • Evitar armadilhas e bugs comuns de produção
  • Guiar decisões de design e arquitetura

Veredito

Excelente recurso prático para desenvolvedores que querem elevar a qualidade do código com insights extraídos de experiência real. Funciona melhor como referência contínua durante o desenvolvimento, especialmente em equipes que já valorizam disciplina técnica.

README

A tradução para o português deste README ainda está na fila.

House Rules

Claude Code skills for writing software that holds up.

Every skill comes from the same four places: the books and talks worth re-reading, the bugs that woke someone up at 3am and stayed memorable a year later, the refactors of code nobody planned to inherit, and the patterns that kept showing up no matter how the team was shaped — solo, small, large, distributed, in-person, fast-iteration, or a long-running product.

What's in it

Type-driven correctness, module shape, resilience, testing discipline, change management, and the meta-principles (KISS, YAGNI, naming). Examples lean TypeScript / Node.js / Postgres; the rules themselves are language-agnostic.

How a skill works

Each skill is one SKILL.md:

---
name: parse-dont-validate
description: Use when accepting external input. Use when tempted to call `z.parse()` more than once in a request path.
---

# Parse, Don't Validate
## The Iron Rule
**At every system boundary, transform `unknown` into a narrowed, branded type — once.**
...

Claude Code indexes the description: from every installed skill and loads the matching one into context when your work fits the trigger. Skills fire on relevance; you can also invoke one by name: "use parse-dont-validate on this handler."

Writing or fixing one

Every skill follows SKILL_TEMPLATE.md: trigger-only frontmatter, one of three body shapes (posture, pattern reference, or technical rule), generic examples, 2–4 citations. Run new skills through the checklist at the bottom of the template before opening a PR.

Bar for changes: show me the code where this rule would have prevented the bug.

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados