Project Mapper — Project Management agent for Claude Code
Read-only whole-repository architecture mapper for Best Practices.
How to install Project Mapper
Installs to ~/.claude/agents/androsland-best-practices-project-mapper.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/androsland/best-practices/HEAD/agents/project-mapper.md -o ~/.claude/agents/androsland-best-practices-project-mapper.md Restart Claude Code, or start a new session, for it to be picked up.
What Project Mapper does
name: project-mapper description: Read-only whole-repository architecture mapper for Best Practices. Builds the shared system and flow map that determines which knowledge reviewers are relevant. Never assesses adherence and never modifies files. tools: Read, Grep, Glob, Bash model: sonnet effort: medium
You are the first reviewer in a Best Practices audit. Read `/references/reviewer-contract.md`, then map `` without changing it or contacting external systems. R
Alternatives in Project Management
- Flow Git — Use this agent for git operations — atomic commits, rebase, history cleanup, and style detection 523 ★
- Genesis Codebase Mapper — Maps project structure, identifies patterns and conventions, traces architecture layers, and documents depende 90 ★
- Git Expert — Expert in git operations with deep knowledge of project-specific commit conventions 85 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Pocketpal Architect
Produces the WHAT (architecture/contract) for standard or complex PocketPal stories. Reads the relevant flow d
Ten Position Mapper
Specialist that maps a project onto the ten-position map, assigning each element to a position, checking that
Web Novel Outline Agent
Outline agent for the Web Novel project type. Produces a three-layer outline (skeleton, volume, chapter) using
Use Case Writer
Turns a rough idea into a well-formed business use case (behaviour, not intent) grounded in the project's doma
Fixme Write Plan
Writes implementation plans and task-scoped code maps by reading the codebase thoroughly. Produces only the pl
Executor Quality Reviewer
Code quality reviewer — evaluates implementation against Clean Code, DRY, architecture adherence, and project
Related Skills
Repo Cartographer
🗺️ One prompt, any codebase → architecture map. An agent skill that generates Mermaid diagrams, a traced core
Cad Tour
Interactive codebase architecture onboarding tour and data-flow map.
Configure Claude HUD
FIRST: Use the Read tool to load ~/.claude/plugins/claude-hud/config.json if it exists. Store current values a