rc-codemap

Solid

Generates and incrementally refreshes a per-directory codemap (a codemap.md in each significant folder) so agents get a cheap, always-fresh structure map before exploring. Only regenerates maps for directories that changed since the last run, tracked via .rc/codemap state. Use to build or refresh the repo's codemaps; read the maps first in any exploration-heavy task to cut token cost. Do not use to analyze a specific bug or trace one flow (use rc-analyze).

AI & Automation 19 stars 1 forks Updated 2 weeks ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
43
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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 ...

Details

Author
rodolfochicone
Repository
rodolfochicone/rc-project
Created
1 months ago
Last Updated
2 weeks ago
Language
JavaScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

codemap

Generate or update a feature-organized CODEMAP.md for any codebase. Scans repos, detects frameworks, identifies features, traces full-stack flows (frontend routes → hooks → state → backend views → models → integrations), and produces a navigable reference with a directory table for selective loading. Supports modes: create (full generation), inventory (quick index only), update (incremental refresh), section (rebuild one section). Trigger: '/codemap', '/codemap create', '/codemap inventory', '/codemap update', '/codemap section <name>'.

16 Updated yesterday
mikeprasad
AI & Automation Listed

map

Codebase orientation for an unfamiliar or large repo — "map this before I work in it." Fans out read-only Explore sub-agents that navigate the code (keyless — grep/glob/read, no embeddings to go stale) along the order that matters: entry points, build/test/lint commands, architecture and key abstractions, conventions and gotchas, test layout. Distills the findings into a lean AGENTS.md at the repo root — the cross-tool standard file many agents auto-load — where every claim points to a real file and nothing survives that isn't load-bearing. Human-in-the-loop: it drafts, you approve, and it never writes or commits into your repo without an explicit yes. Stamps the map with date + commit so /map refresh regenerates only what went stale. Use before working in a repo you or the agent don't know — e.g. "/map", "/map the auth subsystem", "generate an AGENTS.md", "/map refresh". Run it upstream of feature or bugfix; for the end-of-session shipping gate use done.

9 Updated 3 days ago
duthaho
AI & Automation Listed

repo-map

Generate or refresh a durable, directory-level map of the codebase — what each directory is for and its key entry-point files — stored as memory/architecture/repo-map.md and stamped with the git commit it was verified against. Use to create the map, refresh it after the tree drifts, or check whether it is stale. Trigger this when someone says: map the repo, build a repo map, what does each directory do, refresh the repo map, is the repo map stale, generate the file manifest, update the codebase map. Do NOT use to produce a full onboarding orientation — use /onboard instead (it reads this map). Do NOT use to search memory — use /memory-query instead.

6 Updated 2 weeks ago
chuckplayer