Skill: Context Map

Generate a file impact map before code changes to identify affected files, relationships, and cascades — improving agent file partitions for parallel work.

When to Use

Steps

1 — Entry Points

Identify files that MUST change from the task description.

2 — Trace Outward (dependents)

Find consumers of entry-point exports:

grep_search("import.*from.*places", isRegexp=true)   # find importers
vscode_listCodeUsages("PlaceCard")                     # find component consumers
grep_search("places.*route|/places", isRegexp=true)    # find route references

3 — Trace Inward (sources)

Find what entry points depend on:

grep_search("from.*libs/", includePattern="src/places/**")  # shared lib deps
grep_search("from.*config", includePattern="src/places/**")  # config deps

4 — Build the Map

Produce a compact Context Map for the Team Lead and downstream agents. Example minimal map (inline):

Context Map — Feature: Add priceRange

- Entry points:
	- src/lib/place/schema.ts
	- src/components/PriceRangeFilter/PriceRangeFilter.tsx

- Dependents (trace outward):
	- src/pages/places/page.tsx
	- src/components/PlacesList/PlaceCard.tsx

- Sources (trace inward):
	- src/lib/filters.ts
	- src/shared/types/place.ts

- Unaffected (optional):
	- src/components/Account/**

Validation checkpoint: run grep_search and vscode_listCodeUsages results into the map and confirm all listed files open without errors (CI: pnpm typecheck). For full template and Team Lead integration snippets see REFERENCE.md in this directory.

Anti-Patterns

• Skipping for "obvious" tasks — shared libs cascade unexpectedly
• Guessing dependencies instead of using grep_search / list_code_usages
• Over-mapping a 2-file fix
• Using a stale map after plan changes