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.
- Autor
- rodolfochicone ↗
- Repozytorium
- rc-project ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 06.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 06.08.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
- Store & staleness
- Workflow
- Rules
- When to read (not generate)
- Error handling
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.