Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

codebase-design

/codebase-design

Ocenia i poprawia interfejsy modułów heurystykami głębokich modułów, by zmniejszyć złożoność po stronie wywołujących.

Repozytorium
ctx ↗
Licencja
MIT
Ostatnia zmiana repozytorium
21.08.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 21.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Ocenia i poprawia interfejsy modułów heurystykami głębokich modułów, by zmniejszyć złożoność po stronie wywołujących.

Oryginalny opis (EN)

Design or improve module interfaces using deep-module heuristics. Use when deciding where a seam belongs, reducing caller-facing complexity, improving testability or navigability, or comparing module designs.

Jak działa

  1. Working vocabulary
  2. Design workflow
  3. Heuristics, not laws
Sekcje z nagłówków SKILL.md, w oryginale · 51 linii, 320 słów
Podgląd SKILL.md
---
name: codebase-design
description: Design or improve module interfaces using deep-module heuristics. Use when deciding where a seam belongs, reducing caller-facing complexity, improving testability or navigability, or comparing module designs.
---

# Codebase Design

Seek **deep modules**: substantial useful behavior behind a small, stable
interface. Use the concepts below as design lenses, while matching the
repository's established domain language.

## Working vocabulary

- **Module**: a coherent unit with an interface and implementation, at any scale.
- **Interface**: everything callers must know, including invariants and failure
  modes—not just a type signature.
- **Seam**: a location where behavior can vary without editing its callers.
- **Adapter**: an implementation that connects at a seam.
- **Depth**: useful capability relative to interface complexity.
- **Leverage**: capability gained by callers; **locality**: change and knowledge
  concentrated for maintainers.

Translate these terms to the project's vocabulary when that makes the design
clearer. Consistency with the codebase is more valuable than enforcing a private
lexicon.

## Design workflow

1. Map representative callers, responsibilities, dependencies, and existing
   contracts.
2. Look for coordination or policy that can move behind a smaller interface.
3. Place seams where variation, ownership, or test isolation justifies them.
4. Compare alternatives when the choice is consequential.
5. Validate the candidate with representative caller code and tests.

## Heuristics, not laws

- Reduce methods, parameters, ordering constraints, and configuration callers
  must understand.
- Use the deletion test: if removing a module merely spreads its complexity
  across callers, it was likely earning its keep.
- Treat pass-through layers skeptically, but keep them when they provide a real
  compatibility, ownership, policy, or navigation boundary.
- Introduce dependency seams when actual variation or test isolation repays the
  indirection; avoid interfaces justified only by hypothetical futures.
- Prefer tests through observable interfaces, while allowing focused internal
  tests when they provide cheaper or more precise feedback.
- Favor explicit dependencies and returned results when they improve control and
  testability; side effects and internally created dependencies can still be
  appropriate at well-defined boundaries.

Read [DEEPENING.md](DEEPENING.md) when consolidating a cluster across dependency
boundaries. Read [DESIGN-IT-TWICE.md](DESIGN-IT-TWICE.md) when materially
different interface designs can be explored independently.
Pliki w paczce (4)
  • DEEPENING.md 2 KB
  • DESIGN-IT-TWICE.md 2 KB
  • SKILL.md 3 KB
  • agents/openai.yaml 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · stevesolun/ctx90MIT
mikeleg/skills100MIT
VincenzoImp/pitcrew100MIT
kriscard/kriscard-claude-plugins100MIT
akillness/jeo-skills100MIT
JamalLyons/Agent-Skills100MIT
zenobi-us/dotfiles100MIT
FrancoStino/opencode-skills-collection100MIT
yassimba/loom100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 08f48d457fad (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

  • 95workflow-codebase-design
    Wyjaśnia wspólne słownictwo do projektowania głębokich modułów: interfejsy, szwy i miejsca poprawy testowalności kodu.
  • 100oracle-codebase-design
    Opisuje wspólne słownictwo i zasady projektowania głębokich modułów: interfejsy, miejsca szwów, obsługa niezaufanych danych na brzegach, poziom testowania i nazewnictwo.
  • 100improving-architecture
    Znajduje i szereguje poparte dowodami kandydatów na refaktoryzacje głębokich modułów i szwów w bazie kodu, przy analizie splątanego kodu, modularności i testowalności.
  • 100rc-codebase-design
    Podaje słownik głębokich modułów: interfejs, głębokość, szew i adapter, pomocny przy decyzji, gdzie umieścić interfejs.
  • 100matt-codebase-design
    Wyjaśnia pojęcia głębokich modułów, szwów i adapterów, szuka w kodzie miejsc do pogłębienia i zapisuje propozycje ulepszeń architektury.
  • 90improve-codebase-architecture
    Ocenia lub poprawia architekturę istniejącego kodu: granice modułów, sprzężenie, rozproszoną własność, testowalność, lokalność zmian, głębokie moduły i refaktoryzacje zachowujące zachowanie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.