Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

rc-codemap

/rc-codemap

Buduje i odświeża pliki codemap.md w każdym katalogu jako tanią mapę struktury przed eksploracją dużego repozytorium.

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

Brak sygnałów. Repozytorium zmienione 06.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 sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/stale.sh

Co robi i kiedy

Buduje i odświeża pliki codemap.md w każdym katalogu jako tanią mapę struktury przed eksploracją dużego repozytorium.

Oryginalny opis (EN)

Builds and refreshes per-directory codemap.md as a cheap structure map. Use before exploring a large repo. Do not use to trace one bug.

Jak działa

  1. Store & staleness
  2. Workflow
  3. Rules
  4. When to read (not generate)
  5. Error handling
Sekcje z nagłówków SKILL.md, w oryginale · 50 linii, 406 słów
Podgląd SKILL.md
---
name: rc-codemap
description: "Builds and refreshes per-directory codemap.md as a cheap structure map. Use before exploring a large repo. Do not use to trace one bug."
model: sonnet
effort: medium
---

# Codemap

Maintain a hierarchical, per-directory map of the repository so every exploration-heavy task
starts from a written summary instead of re-scanning source. Each significant directory gets a
`codemap.md`; a root `codemap.md` links them. Regeneration is **incremental** — only directories
that changed since the last run are rebuilt.

## Store & staleness

- Maps live as `codemap.md` inside each mapped directory (committed alongside the code).
- State lives at `.rc/codemap/last-commit` (the git SHA at the last generation).
- `scripts/stale.sh [root]` prints the directories that changed since that SHA — or every
  directory when there is no state yet (first build). `scripts/stale.sh --record [root]` records
  the current HEAD after a successful generation. Both **fail open**: on any git problem they
  behave as if everything is stale, which is safe.

## Workflow

1. **Scope.** Run `scripts/stale.sh` to get the stale directories. If it returns everything,
   you're doing a first full build.
2. **Regenerate stale maps.** For each stale directory — skipping vendored/generated dirs
   (`.git`, `node_modules`, `vendor`, build output, fixtures) — read its files enough to
   summarize, then (re)write its `codemap.md` with: the directory's responsibility, its key
   files and their roles, notable patterns, and how it connects to sibling directories. Anchor
   claims to real paths.
3. **Update the index.** Refresh the root `codemap.md` so it links every directory map.
4. **Record state.** Run `scripts/stale.sh --record` so the next run only rebuilds what changes
   after this point.

## Rules

- A codemap is a map, not a copy: summarize roles and wiring; never paste large code blocks.
- Keep each map short and skimmable — a reader should grasp a directory in under a minute.
- Do not map throwaway directories (build output, vendored deps, fixtures, generated code).
- On a first build of a large repo, map top-down: root + top-level directories first, then
  descend only into directories that hold real logic.

## When to read (not generate)

In any task that begins with codebase exploration, **read the relevant `codemap.md` files
first** and fall back to grep/Read only for what the maps don't cover. That is the token-saving
payoff — the maps exist so agents don't re-derive structure every session.

## Error handling

- Not a git repository → `stale.sh` fails open and reports all directories; do a full build and
  skip the `--record` step (nothing to record without git).
- A directory that is pure generated output → skip it; do not write a map you'll never trust.
Pliki w paczce (2)
  • SKILL.md 3 KB
  • scripts/stale.sh 2 KB

Wersje

W bazie nie ma innych skilli o nazwie rc-codemap.

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

  • 100codemap-export
    Eksportuje mapę kodu (codemap) jako JSON do dalszego przetwarzania przez inne narzędzia, z tymi samymi danymi co polecenie /codemap.
  • 96codemap
    Tworzy siedmiodokumentową mapę architektury istniejącej bazy kodu, gdy trzeba ją opisać.
  • 100codemap
    Dokumentuje bazę kodu na podstawie dowodów: przechodzi repozytorium, buduje mapę komponentów, odpowiedzialności i powiązań, a wynikiem jest ręcznie dopracowany markdown z diagramami.
  • 90codemap
    Śledzi jeden przepływ w kodzie i zapisuje go jako mapę markdown z diagramem Mermaid oraz odnośnikami do plików.
  • 100codemap-refresh
    Odświeża mapy kodu nieaktualne po zmianach, regenerując tylko przestarzałe pliki i zachowując ręczne poprawki.
  • 100codemap
    Analizuje strukturę projektu, zależności i zmiany, przekazuje pracę między agentami i wskazuje ryzyka przed zadaniem.

Uwagi i zgłoszenia

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