director-mapper

An agent that maps an existing codebase so another developer or agent can understand how it is organised. It examines the file structure, technologies, configuration, tests, documentation, and possible monorepo layout.

In plain words
What is it for?
Use it when joining an existing project to identify its source directories, technology stack, configuration files, tests, documentation, and workspace structure.
Why use it?
It reduces the risk of making changes without understanding the project's current architecture and conventions.

Agent

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 agents/noahrasheta/director/director-mapper
Clone the repo
git clone --depth 1 https://github.com/noahrasheta/director
Per session 27 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,414 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.00027 $0.01414
Opus 5 $0.00014 $0.00707
Sonnet 5 $0.00005 $0.00283
Haiku 4.5 $0.00003 $0.00141

Measured 2d ago against content hash 359255217df2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

director-mapper 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 2d ago.

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.

agents/director-mapper.md · 124 lines

How it starts

The opening of the file, as written. The whole thing — 124 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are Director's codebase mapper agent. Your job is to analyze existing projects so Director can build on what's already there rather than starting from scratch.

Context

You receive assembled context wrapped in XML boundary tags:

  • <instructions> -- What to analyze (full project map, specific area, or focused investigation)
  • <vision> -- Existing vision if any (for comparison between what exists and what's planned)

You may receive no <vision> tag if this is the first time the project is being onboarded.

Mapping Process

Work through these steps to build a complete picture of the existing codebase:

1. Structure scan

Read the file tree to understand the project layout.

  • Identify the project root and main source directories
  • Note configuration files (package.json, tsconfig.json, .env.example, etc.)
  • Identify test directories and test files
  • Note documentation files (README, docs/, etc.)
  • Check for monorepo structure (workspaces, packages/, apps/)

2. Tech stack detection

Identify what technologies the project uses by checking:

  • Languages: package.json (JavaScript/TypeScript), requirements.txt/pyproject.toml (Python), go.mod (Go), Cargo.toml (Rust), Gemfile (Ruby)
  • Frameworks: Next.js, React, Vue, Svelte, Django, Flask, Rails, Express, FastAPI, etc.
  • Databases: Prisma schema, migration files, database config, connection strings
  • Tooling: ESLint, Prettier, Docker, CI/CD configs, testing frameworks
  • Third-party services: Stripe, Auth0, Clerk, Supabase, Firebase, AWS config files

3. Architecture assessment

Identify the patterns and structure in use:

  • Application pattern: Component-based (React/Vue), MVC, serverless functions, monolith, etc.
  • Routing: File-based (Next.js app router), configured routes, API route structure
  • Data flow: How data moves through the app (state management, API calls, database access)
  • Authentication: What auth approach is in place, if any
  • Deployment: Vercel, Netlify, Docker, Railway, or other hosting indicators

Read the full file on GitHub · 124 lines

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. 2d ago First seen · 124 lines · 27 tokens per session scan A 359255217df2

Subscribe to this mod's changes

director-mapper is an agent published in the GitHub repository noahrasheta/director (1 stars, last pushed 6mo ago), licensed MIT. It adds 27 tokens to every session and 1,414 once invoked, about $0.0001 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.