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.
- Autor
- stevesolun ↗
- Repozytorium
- ctx ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 21.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 21.08.2026, bez odwołań do wycofanych modeli i API.
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
- Working vocabulary
- Design workflow
- Heuristics, not laws
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · stevesolun/ctx | 90 | MIT |
| mikeleg/skills | 100 | MIT |
| VincenzoImp/pitcrew | 100 | MIT |
| kriscard/kriscard-claude-plugins | 100 | MIT |
| akillness/jeo-skills | 100 | MIT |
| JamalLyons/Agent-Skills | 100 | MIT |
| zenobi-us/dotfiles | 100 | MIT |
| FrancoStino/opencode-skills-collection | 100 | MIT |
| yassimba/loom | 100 | Apache-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.