# Harness Map

> Agent skill that generates an interactive dependency map of your AI harness (skills, agents, commands, MCP servers)

- **Type:** MCP server
- **Install:** `agentstack add mcp-dreamiurg-harness-map`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dreamiurg](https://agentstack.voostack.com/s/dreamiurg)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dreamiurg](https://github.com/dreamiurg)
- **Source:** https://github.com/dreamiurg/harness-map

## Install

```sh
agentstack add mcp-dreamiurg-harness-map
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# harness-map
[](https://github.com/dreamiurg/harness-map/actions/workflows/ci.yml)
[](https://codecov.io/gh/dreamiurg/harness-map)
[](package.json)
[](LICENSE)
[](https://skills.sh/dreamiurg/harness-map)

An [Agent Skill](https://agentskills.io) that generates a **self-contained, interactive HTML
dependency map** of a repository's AI harness: skills, commands, agents, and MCP servers —
which skills hand off to which, which agents they delegate to, which MCP servers everything uses.

*(Generated from the public [obra/superpowers](https://github.com/obra/superpowers) repo —
14 skills, 22 evidence-backed edges, auto-clustered.
Interactive version: [examples/superpowers.html](examples/superpowers.html).)*

Deterministic scripts scan the repo and build the HTML; the invoking agent does the one thing
scripts can't — reading each skill/agent body and inferring typed, evidence-backed dependency edges.

## Install

    npx skills add dreamiurg/harness-map

This installs the skill to `.agents/skills/harness-map/` in your project — the shared
location read by Claude Code, Codex, Cursor, and other Agent-Skills-compatible tools.

Or as a Claude Code plugin:

    /plugin marketplace add dreamiurg/harness-map
    /plugin install harness-map@harness-map-marketplace

## Use

Ask your agent: "map my AI harness" or invoke `/harness-map`. Output: `harness-map.html`
(single file, fully offline, open in any browser).

## Quickstart for agents

If you are a coding agent (Claude Code, Codex, Cursor, ...) whose human asked you to set
this up, do this — verified to work on a clean machine with only Node ≥ 20 and git:

1. From the root of the repository you want to map:

       npx -y skills add dreamiurg/harness-map -y

   The CLI detects agent environments and runs non-interactively. The skill lands in
   `.agents/skills/harness-map/`.

2. Generate the map now — do not wait for a new session to pick the skill up. Read
   `.agents/skills/harness-map/SKILL.md` and execute its four phases directly:
   **scan** (run the script) → **infer edges** (your judgment; every edge needs a quotable
   line of evidence) → **validate** (run the script, fix `graph.json` until it prints `OK`)
   → **build** (run the script).

3. Report to your human: the path to `harness-map.html`, node/edge counts, and 2–3
   notable findings (orphan skills, the most-depended-on agent, unused MCP servers).
   Delete `harness-map-work/` or gitignore it — only the HTML is the deliverable.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dreamiurg](https://github.com/dreamiurg)
- **Source:** [dreamiurg/harness-map](https://github.com/dreamiurg/harness-map)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-dreamiurg-harness-map
- Seller: https://agentstack.voostack.com/s/dreamiurg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
