Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

improving-architecture

/improving-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.

Repozytorium
skill-set ↗
Licencja
MIT
Ostatnia zmiana repozytorium
19.10.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 19.10.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

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.

Oryginalny opis (EN)

Finds and ranks evidence-backed deep-module and seam refactor candidates in a codebase. Use when a user asks for architecture improvement opportunities, tangled-code analysis, modularity, testability seams, deep or shallow modules, or a ranked refactor shortlist.

Jak działa

  1. Boundary
  2. Vocabulary
  3. Process
  4. Candidate Format
  5. Failure Handling
Sekcje z nagłówków SKILL.md, w oryginale · 54 linii, 459 słów
Podgląd SKILL.md
---
name: improving-architecture
description: Finds and ranks evidence-backed deep-module and seam refactor candidates in a codebase. Use when a user asks for architecture improvement opportunities, tangled-code analysis, modularity, testability seams, deep or shallow modules, or a ranked refactor shortlist.
allowed-tools: Read, Grep, Glob
---

# Improving Architecture

## Boundary

Return read-only ranked candidates. Do not edit code, design a final interface, write an implementation plan, select a candidate for the user, or invoke another skill.

Read `CONTEXT.md` and relevant ADRs if they exist, using them only as vocabulary and constraint evidence. Never create or update those files.

## Vocabulary

- **Depth** — behavior hidden behind a smaller interface.
- **Shallow module** — callers must understand nearly as much complexity as the implementation.
- **Seam** — a bounded interface where behavior can vary without editing callers.
- **Locality** — related knowledge, change, and failure are concentrated.
- **Leverage** — multiple callers stop repeating knowledge or coordination.

Read [deep-module examples](reference/deep-modules.md) when depth or seam value is unclear, and [the deletion test](reference/deletion-test.md) when evaluating a suspected pass-through. Caller or adapter counts alone do not establish value; inspect the invariant or coordination the boundary contains.

## Process

1. Orient to domain terms and constraints from existing context, ADRs, tests, and package structure.
2. Trace areas where one concept requires many files, callers repeat ordering or invariants, interfaces leak implementation knowledge, or testing requires internal coupling.
3. Apply the deletion test to suspected pass-through modules: if deleting the module removes complexity, it is shallow; if complexity reappears across callers, it may be earning its interface.
4. Gather path-and-line evidence for every claim. Drop speculative candidates without direct evidence.
5. Rank candidates by combined locality gain, leverage gain, risk, and ability to complete as a bounded refactor.
6. Return only the candidate report and stop after presenting candidates.

## Candidate Format

```text
## 1. <candidate in domain vocabulary>

- Files: <exact paths>
- Evidence: <observed duplication, ordering, leakage, or test friction with locations>
- Problem: <why the current boundary creates maintenance or caller complexity>
- Proposed seam: <plain-language boundary, not a designed API>
- Locality gain: <knowledge/change concentrated>
- Leverage gain: <what callers no longer coordinate>
- Test impact: <tests preserved, added, or moved to an observable boundary>
- Risks: <migration, compatibility, performance, ownership, or uncertainty>
```

Every item must contain Files, Evidence, Problem, Proposed seam, Locality gain, Leverage gain, Test impact, and Risks. Omit any candidate that cannot support all eight fields. Keep the shortlist ranked and bounded; five strong candidates are preferable to a comprehensive catalog.

## Failure Handling

- Existing ADR conflicts: cite the ADR in Evidence and state the conflict in Risks; do not relitigate it silently.
- Missing callers or tests: record the evidence gap in Risks and lower the rank.
- Candidate requires a ground-up rewrite: split it into a bounded seam or omit it.
- Interface shape is uncertain: describe only the capability boundary in Proposed seam.

Use the user's language for the report. Keep paths, identifiers, and canonical architecture terms exact.
Pliki w paczce (3)
  • SKILL.md 3 KB
  • reference/deep-modules.md 6 KB
  • reference/deletion-test.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie improving-architecture.

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

  • 100codebase-design
    Dostarcza wspólne słownictwo do projektowania głębokich modułów, szukania możliwości ich pogłębiania, wyboru położenia szwów i poprawy testowalności kodu.
  • 100codebase-design
    Dostarcza wspólne słownictwo do projektowania głębokich modułów, szukania możliwości ich pogłębiania, wyboru położenia szwów i poprawy testowalności kodu.
  • 100codebase-design
    Dostarcza wspólne słownictwo do projektowania głębokich modułów, pogłębiania wybranego modułu, ustalania położenia szwów i poprawy testowalności kodu.
  • 95workflow-codebase-design
    Wyjaśnia wspólne słownictwo do projektowania głębokich modułów: interfejsy, szwy i miejsca poprawy testowalności kodu.
  • 100improve-codebase-architecture
    Wskazuje refaktoryzacje zamieniające płytkie moduły w głębokie, w oparciu o CONTEXT.md i docs/adr/, dla lepszej testowalności i nawigacji przez agentów.
  • 100codebase-design
    Opisuje słownictwo i zasady projektowania głębokich modułów: małe interfejsy, czyste szwy i testowanie przez interfejs.

Uwagi i zgłoszenia

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