# dependency-mapper

The dependency-mapper command connects code dependencies, Linear tasks, and Git history into project maps. Use it to spot cycles, blockers, and task order.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/team/dependency-mapper.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/qdhenry-dependency-mapper

## What it does

dependency-mapper examines JavaScript, TypeScript, and Python imports, file relationships, Git history, and Linear task links. It can render the result as a tree, Mermaid diagram, or dependency matrix. The command also detects cycles and derives a task sequence with a topological sort.

For Linear work, it reads blocking links, parent and child tasks, referenced task IDs, and related tasks from the same project. File analysis separates internal modules, external npm packages, and connected Linear tasks. If Linear MCP is unavailable, the command falls back to code analysis.

Install it as `.claude/commands/dependency-mapper.md` with no leading space in the path. After that, ask Claude Code to inspect a module, a task, or the project dependency graph.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/dependency-mapper.md` — Call it with /dependency-mapper. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/dependency-mapper.md` — Call it with /prompts:dependency-mapper. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/dependency-mapper.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/dependency-mapper.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/team/dependency-mapper.md

## When to use it
- find circular dependencies in a codebase
- connect project files to Linear tasks
- identify blockers between tasks
- calculate a task execution order
- render relationships as a tree or Mermaid diagram

## Example prompts
- Show the dependency map for task `LIN-123`.
- Map dependencies for the `src/auth` module.
- Check the codebase for circular dependencies and suggest a task order.

## Similar
- [team-knowledge-mapper](https://affpapa.org/en/nevibecode/commands/team-knowledge-mapper.md) — command · 235 installs
- [openai-symphony-autonomous-agents](https://affpapa.org/en/nevibecode/skills/openai-symphony-autonomous-agents.md) — skill · 1400 installs
- [cyrus-setup-repository](https://affpapa.org/en/nevibecode/skills/cyrus-setup-repository.md) — skill · 1100 installs
- [implement-task-linear](https://affpapa.org/en/nevibecode/skills/implement-task-linear.md) — skill · 346 installs
- [complete-work](https://affpapa.org/en/nevibecode/skills/complete-work.md) — skill · 317 installs
- [ticket](https://affpapa.org/en/nevibecode/commands/ticket.md) — command · ★ 6091 repo stars

## Other versions with the same name
- [dependency-mapper · davila7](https://affpapa.org/en/nevibecode/commands/dependency-mapper.md) — 274 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
