Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

explore-before-editing

/explore-before-editing

Buduje mapę nieznanego kodu przed zmianą: punkty wejścia, warstwy, konwencje, polecenia budowania i testów oraz to, co może pęknąć.

Licencja
MIT
Ostatnia zmiana repozytorium
10.11.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Buduje mapę nieznanego kodu przed zmianą: punkty wejścia, warstwy, konwencje, polecenia budowania i testów oraz to, co może pęknąć.

Oryginalny opis (EN)

Build a working map of an unfamiliar codebase before changing it: entry points, layers, conventions, build and test commands, where the change belongs, and what could break. Use when starting work in a repository or module you have not touched yet, when a change request names code you have not read, or before any refactor that crosses several files.

Jak działa

  1. Steps
  2. Red flags
  3. Output
Sekcje z nagłówków SKILL.md, w oryginale · 23 linii, 230 słów
Podgląd SKILL.md
---
name: explore-before-editing
description: "Build a working map of an unfamiliar codebase before changing it: entry points, layers, conventions, build and test commands, where the change belongs, and what could break. Use when starting work in a repository or module you have not touched yet, when a change request names code you have not read, or before any refactor that crosses several files."
---

# Explore before editing

```
NO EDIT BEFORE YOU CAN SAY WHERE THE CHANGE GOES AND HOW YOU WILL KNOW IT WORKS
```

## Steps
1. **Build and test commands**: find them (README, `*.sln`, `package.json`, `Makefile`, pipeline YAML) and run the tests once to get a baseline. Note pre-existing failures; they are not yours.
2. **Map**: entry points (controllers, jobs, CLI, UI routes), layers, the 5-10 files that matter for this change. Use search, not guesses: `git grep`, symbol search, callers of the function.
3. **Conventions**: naming, error handling, logging, DI, test style. Read two neighbouring files and copy their patterns.
4. **History**: `git log --oneline -15 -- <path>` and blame on the lines you will touch. Why is it like this? A strange line often fixes a real bug.
5. **Blast radius**: who calls this code (other modules, APIs, batch jobs, reports)? Public contracts (API, DB schema, file formats) need extra care.
6. **Write it down** in 10 lines: where the change goes, files to touch, tests to add, risks, open questions. Ask the open questions before coding.

## Red flags
- "I'll just add it here" without having read the callers.
- Creating a new helper when an equivalent exists two folders away.
- Changing formatting or names in files you only needed to read.

## Output
A short map: commands, key files, conventions, blast radius, plan, questions.

Wersje

W bazie nie ma innych skilli o nazwie explore-before-editing.

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

  • 100repo-brief
    Przygotowuje zwięzłe omówienie nieznanego repozytorium przed edycją: stos, polecenia uruchomienia, punkty wejścia i ryzyka do potwierdzenia.
  • 100codebase-onboarding
    Mapuje nieznane repozytorium przed zmianą: stos, polecenia, punkty wejścia, przepływ danych i sposób wdrażania zmian.
  • 86explore
    Buduje dokładny obraz nieznanego kodu, funkcji lub obszaru przed zmianą: gdzie leży, jak się łączy i co robi.
  • 100repository-exploration
    Tworzy mapę nieznanego repozytorium: architekturę, punkty wejścia, przepływ danych, konwencje i miejsca, które najłatwiej zaskakują, zanim ktokolwiek zmieni kod.
  • 81recon
    Mapuje nieznany kod przed zmianą: punkty wejścia, łańcuchy wywołań, przepływ danych i konwencje, aż znane będą wszystkie miejsca zmiany.
  • 100orient-in-codebase
    Poznaje nieznane repozytorium przed zmianami: prawdziwe komendy budowania i testów, konwencje oraz obecny stan.

Uwagi i zgłoszenia

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