engineering-principles
/engineering-principles
Pilnuje podstawowych zasad jakości kodu: YAGNI, KISS, DRY z rozwagą i małych, czytelnych zmian.
- Autor
- johantor ↗
- Repozytorium
- brain ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Co robi i kiedy
Pilnuje podstawowych zasad jakości kodu: YAGNI, KISS, DRY z rozwagą i małych, czytelnych zmian.
Oryginalny opis (EN)
Core code-quality rules — YAGNI, KISS, DRY with judgment, small single-purpose units, clear naming, minimal-scope diffs. Use whenever writing, refactoring, or reviewing code in this repo.
Jak działa
SKILL.md bez nagłówków drugiego poziomu · 28 linii, 426 słów
Podgląd SKILL.md
--- name: engineering-principles description: Core code-quality rules — YAGNI, KISS, DRY with judgment, small single-purpose units, clear naming, minimal-scope diffs. Use whenever writing, refactoring, or reviewing code in this repo. --- <!-- A copy of the crew plugin's skill (johantor/crew, plugins/crew/skills/engineering-principles). --> # Engineering principles Defaults, not dogma — when a rule conflicts with the repo's established patterns, the repo wins. - **Match the repo.** Follow existing conventions, structure, and idioms even over personal preference. Consistency beats local "better". - **YAGNI.** Build only what the task needs. No speculative abstractions, config knobs, unused params, or "future-proofing". Delete dead code. - **KISS.** Simplest solution that works; optimize for the next reader, not cleverness. - **DRY with judgment.** Rule of three before abstracting; a little duplication beats the wrong abstraction; don't couple unrelated code that merely looks similar. - **Small units.** One thing, one reason to change; short functions; composition over inheritance; minimal public surface. - **Naming/comments.** Intention-revealing names; comments explain *why*, not *what*; no commented-out code; no TODO graveyards. - **Errors.** Fail fast, handle explicitly, validate at boundaries; never silently swallow. - **Security.** Treat external input as untrusted — validate and encode at trust boundaries; prefer the framework's safe API (parameterized queries, safe templating) over hand-rolled escaping. Never hardcode or log secrets; least privilege by default. - **Observability.** Make failures diagnosable — log with enough context to locate the cause and surface errors where they'll be seen, never bury them. Match the repo's logging idiom; no noisy logging on the happy path. - **Minimal-scope diffs.** Smallest change that solves the problem; don't sprawl refactors into unrelated files; list unrelated improvements instead of doing them. - **Backward compatibility.** Don't break existing callers or data — preserve public signatures, serialized formats, and observable behavior unless changing them is the task; when you must, migrate or version deliberately. - **Dependencies.** Prefer stdlib/existing deps; don't add a package for something trivial. - **Reach for new code last.** Before writing any, check these in order and stop at the first that applies. Subordinate to *match the repo*: never pick a shorter option over the house pattern. 1. Not needed → don't build it. 2. Stdlib or runtime covers it → use that. 3. Native platform/framework feature covers it → use that. 4. Installed dependency covers it → use that; don't add a new one. 5. Collapses to a line or two without hurting readability → do that. 6. Else write the minimum that works. On a tie between equal-size options, take the one that handles the edge cases. - **Performance.** Clarity first; measure before optimizing. - **Tests.** Test behavior, not implementation; meaningful assertions; no coverage theater. - **Before finishing.** Re-read your diff as a reviewer; remove anything unneeded; confirm it follows repo conventions.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · johantor/brain | 86 | Apache-2.0 |
| joeblackwaslike/agent-skills | 100 | MIT |
| wolfinApp/wolfin-senior | 100 | MIT |
| Cynnamoroll/factory-stack | 90 | MIT |
| voyager67/Agent-Workbench | 86 | MIT |
| ericwang200608-beep/LANYANT-Skills | 85 | MIT |
| jstarfilms/vibecode-protocol-suite | 85 | ISC |
Migawka bazy z 13.11.2026 · wersja paczki 8b7861acbf70 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100code-quality-principles
Stosuje zasady KISS, YAGNI i SOLID, aby uprościć kod i uniknąć nadmiarowej inżynierii podczas refaktoryzacji lub przeglądu. - 100react-principles
Pomaga pisać i przeglądać komponenty React zgodnie z zasadami SOLID, DRY, KISS i YAGNI, z hookami, stanem i efektami. - 95clean-code
Poprawia czytelność kodu według zasad DRY, KISS i YAGNI, gdy metody są długie, nazwy niejasne lub zagnieżdżenia głębokie. - 85backend-code-quality-review
Przegląda kod backendu pod kątem zasad SOLID, DRY, KISS i YAGNI oraz nazewnictwa, spójności i sprzężeń między modułami. - 100backend-development
Wprowadza zmiany w kodzie backendu dla handlerów Lambda, warstw usług i operacji DynamoDB według zasad KISS, YAGNI i DRY, minimalnymi poprawkami. - 100clean-code-principles
Omawia zasady SOLID, wzorce projektowe, DRY i KISS przy przeglądzie architektury, ocenie jakości kodu i refaktoryzacji.