codemap-hub-safety

---
name: codemap-hub-safety
description: Strict safety protocol for modifying hub files. Trigger this skill immediately when you discover a file is imported by 3 or more other files, when the codemap hook surfaces 'hub-safety', or when making structural changes to core architecture files.
---

# Hub Safety Protocol

Hub files are imported by 3+ other files. Changes ripple across the codebase.

## Before editing

1. `codemap --importers <file>` — see all dependents and blast radius
2. Understand the public API surface: which functions/types are used externally
3. Confirm tests exist for dependents, not just the hub itself

## While editing

- Prefer additive changes over breaking changes
- If renaming or removing a public symbol, update all importers in the same commit
- If changing a function signature, check every call site

## After editing

- Run the full test suite, not just the hub's own tests
- `codemap --deps .` — verify the dependency graph is intact
- If 8+ importers, consider staged rollout: change hub → test → update callers separately

## Risk escalation

| Importers | Risk | Action |
|---|---|---|
| 3–5 | Medium | Package tests + direct importer tests |
| 6–10 | High | Full test suite, review all importers |
| 10+ | Critical | Consider splitting the hub or introducing an interface |

More agent context in shalomb/agent-skills

86 other files this repository gives its agents, the first 60 shown.