context-map

name	context-map
description	Maps file dependencies, flags shared imports, groups files for safe parallel editing before code changes. Use when planning a refactoring, analyzing change impact, or understanding which files a modification will affect.

Skill: Context Map

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

When to Use

Use	Skip
Feature implementation (Phase 1)	Isolated bug fixes ≤2 files
Refactoring (Phase 1 Scope)
Schema changes cascading through queries/components
Any task touching libs/

Steps

1 — Entry Points

Identify files that MUST change from 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 compact Context Map for Team Lead, 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, vscode_listCodeUsages results into map; confirm all listed files open without errors (CI: pnpm typecheck). For full template, 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