# Architecture Mapper

> 1. Skill Name

- Skill: `anup4khandelwal/architecture-mapper` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add anup4khandelwal/architecture-mapper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anup4khandelwal/architecture-mapper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: anup4khandelwal (https://skillmd.com/u/anup4khandelwal)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/anup4khandelwal/architecture-mapper

---

## 1. Skill Name
architecture-mapper

## 2. Description
Architecture Mapper: Maps and improves repository architecture, dependencies, and maintainability.

## 3. When the AI agent should use this skill
Use this skill when a request aligns with Architecture Mapper in the codebase domain.

## 4. Required Inputs
- Repository path and target scope
- Objective and acceptance criteria
- Stack details (Node.js, TypeScript, Python, infra, or data)
- Constraints (time, risk, compliance, cost)

## 5. Expected Outputs
- Implementation plan
- Generated or updated artifacts
- Validation steps and results
- Risks and follow-up actions

## 6. Step-by-Step Workflow
1. Clarify scope, assumptions, and success criteria.
2. Inspect repository context and existing patterns.
3. Propose minimal safe change set.
4. Implement artifacts and configuration updates.
5. Run checks/tests and capture evidence.
6. Summarize outcomes, limitations, and next steps.

## 7. Commands or tools used
- rg, ast-grep, depcruise, madge, git
- rg --files
- rg "pattern"
- git status
- git diff

## 8. Example prompts
- /skill architecture-mapper Audit current implementation and propose prioritized improvements.
- /skill architecture-mapper Implement a production-ready baseline with validation steps.
- /skill architecture-mapper Generate artifacts and summarize tradeoffs.

## 9. Guardrails
- Do not run destructive actions without explicit approval.
- Preserve existing conventions unless migration is requested.
- Prefer deterministic and reproducible commands.
- Clearly state assumptions and uncertainty.

## 10. Limitations
- Output quality depends on project context and available tests.
- External systems may require environment-specific verification.
- Human review may still be needed for policy/compliance decisions.