principle-minimize-reader-load
/principle-minimize-reader-load
Liczy warstwy między pytaniem a odpowiedzią oraz stan w głowie czytelnika, zwija jednorazowe opakowania i zawęża zmienny zakres.
- Autor
- chmonitor ↗
- Repozytorium
- chmonitor ↗
- Licencja
- GPL-3.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
GPL-3.0, otwarta.
Co robi i kiedy
Liczy warstwy między pytaniem a odpowiedzią oraz stan w głowie czytelnika, zwija jednorazowe opakowania i zawęża zmienny zakres.
Oryginalny opis (EN)
Apply when reviewing or shaping code that's hard to trace. Count layers between question and answer, and hidden state in the reader's head; collapse one-caller wrappers and shrink mutable scope.
Jak działa
SKILL.md bez nagłówków drugiego poziomu · 19 linii, 288 słów
Podgląd SKILL.md
--- name: principle-minimize-reader-load description: "Apply when reviewing or shaping code that's hard to trace. Count layers between question and answer, and hidden state in the reader's head; collapse one-caller wrappers and shrink mutable scope." user-invocable: false --- # Minimize Reader Load Maintainability is the work a reader must do to understand code. Track two axes: 1. **Layers to trace.** How many indirections sit between the question and the answer. 2. **State to hold.** How much hidden or mutable context the reader must keep in their head. **Why:** Code is read far more than it is written. LOC, cyclomatic complexity, and "clean architecture" are proxies. Reader load is the thing that matters. The two axes are independent. A flat file with 50 globals can be as hard to reason about as a 6-layer adapter stack. Guard both. This is the human analog of [Guard the Context Window](../principle-guard-the-context-window/SKILL.md). Working memory is finite for readers too. **The pattern:** - **Collapse layers** that cost more than they save: wrappers with one caller, adapters with no second implementation, speculative indirection that was never needed. Inline them. - **Make adjacent layers change the abstraction.** A layer that repeats the same methods and arguments adds reader load without compression. Collapse pass-through layers. - **Demand interface compression.** A broad interface that hides little complexity makes readers learn both the surface and the implementation. Prefer boundaries that hide meaningful decisions. - **Shrink state scope:** prefer pure functions (returns over mutations), locals over fields, fields over module state, and module state over globals. Derive instead of sync. - **Name the invariant at the boundary,** not in every consumer, so the reader learns it once. - Before adding a layer or a piece of state, ask: does this reduce reader load somewhere else by at least as much? **The test:** Can a new reader answer "where does X come from?" and "what can change X?" in under 30 seconds? If not, cut layers or cut state.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · chmonitor/chmonitor | 86 | GPL-3.0 |
| requie/endostack | 90 | MIT |
| xinhi6716/axiom-atropos | 86 | MIT |
| workerstack/clients | 86 | MIT |
| jirayusueb/egm-stack | 86 | Apache-2.0 |
| robansuini/pstack-codex | 86 | MIT |
| sma1lboy/rove | 86 | MIT |
| Sup-Film/pstack-omp-lean | 86 | MIT |
| v1truv1us/ai-eng-system | 86 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 2d2e9b257069 (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
Brak podobnych skilli w bazie.