org-map

A command that creates an SVG diagram of a repository's organisation structure. SVG is an image format that stays sharp when resized; the diagram shows roles, projects, lessons, and related activity data.

In plain words
What is it for?
Use it to generate an organisation map, inspect project and role coverage, and optionally create a PNG image for sharing.
Why use it?
It turns scattered organisation memory into a shareable visual overview without changing the underlying memory files.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/hdk10/orgkit/org-map
Clone the repo
git clone --depth 1 https://github.com/hdk10/orgkit
Per session 34 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 343 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00034 $0.00343
Opus 5 $0.00017 $0.00171
Sonnet 5 $0.00007 $0.00069
Haiku 4.5 $0.00003 $0.00034

Measured yesterday against content hash 65a588a62080, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

org-map scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/org-map.md · 20 lines

What it actually says

Steps

  1. Generate the map by running, from the repo root: python3 .org/orgmap.py (or, from a fresh orgkit clone, python3 setup.py --map --target .)
  2. This writes ORG_MAP.svg at the repo root. It reads real state: each role's ROLE.md size (brain richness), project folder count, captured-insight count (Best practices + Patterns + Gotchas bullets), and reconcile freshness from each .last_promote marker, plus an estimated per-session token saving.
  3. Tell the user where it is (ORG_MAP.svg) and that it's designed to be shared — open it, screenshot it, post it. It carries a small made with orgkit watermark, so every share spreads the tool.
  4. If a renderer is available (rsvg-convert, cairosvg, or a headless Chrome), optionally also produce a PNG for easy posting: rsvg-convert -w 1200 ORG_MAP.svg -o ORG_MAP.png

Constraints

  • Read-only with respect to memory — it only writes ORG_MAP.svg (and optionally ORG_MAP.png). It never edits ROLE.md, CLAUDE.md, or any project memory.
  • Pure stdlib; no dependencies needed to generate the SVG.
  • If .org/roles.json is missing, tell the user to run setup first (python3 setup.py).
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 20 lines · 34 tokens per session scan A 65a588a62080

Subscribe to this mod's changes

org-map is a command published in the GitHub repository hdk10/orgkit (2 stars, last pushed 2mo ago), licensed MIT. It adds 34 tokens to every session and 343 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.