context-map
github/awesome-copilot
Generate a map of all files relevant to a task before making changes
What is context-map?
Context Map analyzes your codebase to identify all files, dependencies, tests, and patterns related to a task before implementation begins. Use this to understand scope and dependencies before writing code.
- Search the codebase for files related to the task
- Identify direct dependencies (imports/exports) between files
- Find and list related test files
- Locate similar patterns in existing code to follow
- Generate a structured map with files to modify, dependencies, tests, and reference patterns
- Assess risks including breaking changes, migrations, and configuration updates
How to install context-map
npx skills add https://github.com/github/awesome-copilot --skill context-mapHow to use context-map
- 1.Provide a task description or feature requirement
- 2.Run the skill to analyze the codebase
- 3.Review the generated context map showing files to modify, dependencies, tests, and reference patterns
- 4.Check the risk assessment checklist for breaking changes and migrations
- 5.Use the map to plan your implementation before making changes
Use cases
- Planning a feature implementation by mapping all affected files and dependencies
- Understanding the scope of a refactoring task across a large codebase
- Identifying test coverage gaps before making changes
- Finding existing patterns to follow for consistency
- Assessing breaking changes and migration needs before implementation
- Backend developers planning code changes
- Frontend developers refactoring components
- DevOps engineers modifying infrastructure code
- Team leads reviewing change scope before implementation
context-map FAQ
Review the map to understand scope and dependencies, then use it to plan your implementation. Do not proceed with code changes until the map is reviewed.
No, it only analyzes and maps the codebase. You review the map and then implement changes based on it.
The context map will show all related files, dependencies, and tests. This helps you understand the full scope before starting implementation.
It searches the codebase for test files that cover the functionality in files you need to modify.
It highlights potential breaking changes, database migrations, and configuration changes you should consider before implementing.
Full instructions (SKILL.md)
Source of truth, from github/awesome-copilot.
name: context-map description: 'Generate a map of all files relevant to a task before making changes'
Context Map
Before implementing any changes, analyze the codebase and create a context map.
Task
{{task_description}}
Instructions
- Search the codebase for files related to this task
- Identify direct dependencies (imports/exports)
- Find related tests
- Look for similar patterns in existing code
Output Format
## Context Map
### Files to Modify
| File | Purpose | Changes Needed |
|------|---------|----------------|
| path/to/file | description | what changes |
### Dependencies (may need updates)
| File | Relationship |
|------|--------------|
| path/to/dep | imports X from modified file |
### Test Files
| Test | Coverage |
|------|----------|
| path/to/test | tests affected functionality |
### Reference Patterns
| File | Pattern |
|------|---------|
| path/to/similar | example to follow |
### Risk Assessment
- [ ] Breaking changes to public API
- [ ] Database migrations needed
- [ ] Configuration changes required
Do not proceed with implementation until this map is reviewed.
Related skills
More from github/awesome-copilot and the wider catalog.
conventional-commit
Generate standardized Conventional Commits messages with structured prompts and automated git workflows.
convert-plaintext-to-md
Converts plaintext documentation into well-structured, platform-appropriate markdown.
copilot-cli-quickstart
A friendly, interactive step-by-step tutor that teaches GitHub Copilot CLI to developers and non-developers alike.
copilot-instructions-blueprint-generator
Generates a codebase-aware copilot-instructions.md so Copilot follows your project's real conventions, not generic assumptions.
copilot-sdk
Embed AI agents in any app with GitHub Copilot SDK
copilot-spaces
Load project-specific context from Copilot Spaces to ground conversations in team code, docs, and instructions.