context-map

Maps affected files, dependencies, tests, and risks before code changes begin.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill context-map-serpro-workshop-fortaleza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-map
Source: https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula/tree/main/.github/skills/context-map
Command: npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill context-map-serpro-workshop-fortaleza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting implementation without understanding impact leads to missed files, broken dependencies, and untested changes. This Skill produces a written context map that delimits exactly which files a task creates or modifies, which dependencies break, which tests exist or are missing, and which risks apply, before any code is written. ## Core Features & Use Cases - Impact Delimitation: Lists every file to create or modify with the concrete change described, plus direct dependencies traced through imports and exports. - Test and Risk Coverage: Identifies existing tests covering affected code, flags missing tests as "to write", and signals public API, database migration, and configuration risks. - Reference Patterns: Points to an existing file that solves a similar problem so new code follows established structure. - Use Case: Before adding a status field to a payments API, ask for a context map to get a reviewable plan listing the controller change, the new enum, affected frontend pages, tests to extend, and migration risks. ## Quick Start Ask the assistant to map the impact of your planned change, for example: "Map which files, dependencies, tests, and risks are affected by adding a status field to the payments API before I start coding."

Frequently Asked Questions about context-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan which files a code change will affect?

Create a context map before coding: restate the task as an observable outcome, locate entry points like controllers and services, trace direct dependencies through imports, and list each file as create or modify with the concrete change described.

How to assess impact of changing a public API contract?

Changing a public /api/v1 contract extends the impact radius to all callers. List every caller in the map and plan an API compatibility note before implementation, so downstream consumers are not broken silently.

When should a context map include a database migration?

Include a migration row whenever the change modifies a JPA entity or schema. The map flags this as a risk and adds a db/migration line so the migration is planned alongside the code change, not discovered afterward.

What if no tests cover the code I am changing?

Missing test coverage is a regression risk. The context map marks uncovered areas with a "test to write" line before programming starts, ensuring new behavior gets test coverage as part of the plan.

Can a context map reference legacy system behavior?

Yes, but legacy directories are treated as read-only evidence. The map must cite the exploration checklist criteria and never assert the contents of legacy programs or fields without verified evidence.