{"id":48495434,"url":"https://github.com/ordinary9843/claude-architecture-mapper","last_synced_at":"2026-04-07T12:02:15.618Z","repository":{"id":343706825,"uuid":"1178809459","full_name":"ordinary9843/claude-architecture-mapper","owner":"ordinary9843","description":"Scans agents, skills, commands, rules, and memories across your Claude Code environment, then writes a structured ARCHITECTURE.md with Mermaid dependency graphs, collision reports, and ecosystem health scores.","archived":false,"fork":false,"pushed_at":"2026-03-21T02:37:03.000Z","size":21,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-21T18:10:50.197Z","etag":null,"topics":["architecture-diagram","claude-code","claude-code-plugin","dependency-graph","developer-tools","documentation-generator","mermaid","productivity","static-analysis","visualization"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ordinary9843.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-11T11:46:24.000Z","updated_at":"2026-03-21T02:35:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ordinary9843/claude-architecture-mapper","commit_stats":null,"previous_names":["ordinary9843/claude-architecture-mapper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ordinary9843/claude-architecture-mapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ordinary9843%2Fclaude-architecture-mapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ordinary9843%2Fclaude-architecture-mapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ordinary9843%2Fclaude-architecture-mapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ordinary9843%2Fclaude-architecture-mapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ordinary9843","download_url":"https://codeload.github.com/ordinary9843/claude-architecture-mapper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ordinary9843%2Fclaude-architecture-mapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31511785,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture-diagram","claude-code","claude-code-plugin","dependency-graph","developer-tools","documentation-generator","mermaid","productivity","static-analysis","visualization"],"created_at":"2026-04-07T12:02:08.609Z","updated_at":"2026-04-07T12:02:15.544Z","avatar_url":"https://github.com/ordinary9843.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Architecture Mapper\n\n[![Claude Code Auditor](https://img.shields.io/badge/Claude_Code_Auditor-Grade_A-success?style=flat-square\u0026logo=anthropic\u0026logoColor=white)](https://github.com/ordinary9843/claude-code-auditor)\n\nTells you what's actually installed in your Claude Code environment — and draws it. Scans every plugin, skill, agent, and command across `~/.claude/` and your current project, detects trigger collisions and semantic overlaps, and writes a structured `ARCHITECTURE.md` with a live Mermaid dependency graph.\n\nMost Claude Code setups grow organically until nobody knows what's installed or what conflicts with what. This plugin makes your full environment visible in a single command.\n\n## Installation\n\nYou can install this plugin either directly within Claude Code or via your standard terminal.\n\n### 1. Inside Claude Code (Recommended)\n\n```shell\n/plugin marketplace add https://github.com/ordinary9843/claude-architecture-mapper.git\n/plugin install architecture-mapper@claude-architecture-mapper\n```\n\n### 2. Via Standard Terminal\n\n```shell\nclaude plugin marketplace add https://github.com/ordinary9843/claude-architecture-mapper.git\nclaude plugin install architecture-mapper@claude-architecture-mapper\n```\n\n*Note: Restart Claude Code after installation to ensure the plugin loads correctly.*\n\n## How It Works\n\nRun from any directory — no arguments needed:\n\n```text\n/architecture-mapper:map   →  scan environment and write ARCHITECTURE.md\n```\n\nThe skill scans both scopes simultaneously:\n\n- **Global scope** (`~/.claude/`): all installed plugins, cached skills, agents, and commands\n- **Project scope** (current directory): project-local agents, skills, commands, rules, memory, and CLAUDE.md\n\nIt reads only frontmatter and metadata — never executes or acts on the content of scanned files.\n\n### What Gets Scanned\n\n| Artifact | Glob Patterns |\n|----------|--------------|\n| Skills | `~/.claude/skills/**/SKILL.md`, `~/.claude/plugins/cache/**/skills/**/SKILL.md`, `skills/**/SKILL.md` |\n| Agents | `~/.claude/agents/*.md`, `~/.claude/plugins/cache/**/agents/*.md`, `agents/*.md`, `.claude/agents/*.md` |\n| Commands | `~/.claude/commands/*.md`, `~/.claude/plugins/cache/**/.claude/commands/*.md`, `.claude/commands/*.md` |\n| Rules | `.claude/rules/*.md` |\n| Memory | `MEMORY.md` |\n| Config | `CLAUDE.md` |\n\n### Output — `ARCHITECTURE.md`\n\nThe skill creates or updates `ARCHITECTURE.md` in the current directory with five sections:\n\n1. **Ecosystem Inventory** — every component with type, source plugin, trigger, model, and size\n2. **Collision Report** — overlapping components ranked by severity (🔴 Critical / 🟡 Warning / 🔵 Info)\n3. **Ecosystem Health** — component count, collision count, bloat alerts\n4. **Recommendations** — top 3 actionable improvements\n5. **Visual Map** — Mermaid graph between `\u003c!-- START_METAMAP --\u003e` markers (safe to re-run; only that section is replaced)\n\n## Usage Examples\n\n### 1. Map Your Full Environment\n\n```shell\n/architecture-mapper:map\n```\n\n**Example output (`ARCHITECTURE.md` excerpt):**\n\n```text\n## Ecosystem Inventory\n\n| Name          | Type    | Source Plugin              | Trigger  | Model | Size | Governance   |\n|---------------|---------|----------------------------|----------|-------|------|--------------|\n| map           | Skill   | claude-architecture-mapper | —        | —     | 6 KB | 🔒 no-invoke |\n| review        | Skill   | claude-code-auditor        | —        | —     | 4 KB | 🔒 no-invoke |\n| commit        | Command | global                     | /commit  | —     | 2 KB | —            |\n\n## Collision Report\n\nNone detected.\n\n## Ecosystem Health\n\n| Metric              | Value | Status |\n|---------------------|-------|--------|\n| Total Components    | 3     | —      |\n| Installed Plugins   | 2     | —      |\n| Collision Count     | 0     | 🟢     |\n| Bloat Alerts (\u003e8KB) | 0     | 🟢     |\n```\n\n### 2. Detect Trigger Conflicts\n\nWhen two installed components claim the same slash command, the Collision Report flags it:\n\n```text\n## Collision Report\n\n| Component A                    | Component B             | Reason              | Severity    |\n|--------------------------------|-------------------------|---------------------|-------------|\n| review (claude-code-auditor)   | review (superpowers)    | Same trigger /review | 🔴 Critical |\n```\n\n**Recommendation generated:** Rename one trigger to eliminate the conflict.\n\n## Understanding the Graph\n\nThe Mermaid graph is auto-scaled based on node count:\n\n| Total nodes | Direction | Context nodes | Grouping    |\n|-------------|-----------|---------------|-------------|\n| ≤ 15        | `graph TD` | Included      | By type     |\n| 16–25       | `graph LR` | Omitted       | By type     |\n| \u003e 25        | `graph LR` | Omitted       | By plugin   |\n\nNode types use distinct colors: skills (green), agents (blue), commands (orange), context (purple), memory (red).\n\n## Plugin Architecture\n\n```text\nclaude-architecture-mapper/\n├── .claude-plugin/\n│   ├── plugin.json              # Plugin manifest (name: architecture-mapper)\n│   └── marketplace.json         # Marketplace definition\n├── skills/\n│   └── map/\n│       ├── SKILL.md             # Core map skill\n│       ├── references/\n│       │   ├── mermaid-rules.md # Mermaid syntax constraints\n│       │   └── doctor-rules.md  # Diagnostic thresholds and health rules\n│       └── examples/\n│           ├── 01-small-environment.md   # Happy path: 2 skills + 1 command\n│           ├── 02-collision-detected.md  # Trigger collision scenario\n│           └── 03-no-artifacts.md        # Edge case: empty environment\n├── CLAUDE.md                    # Plugin context loaded at session start\n├── LICENSE                      # MIT License\n└── README.md\n```\n\n## Requirements \u0026 Troubleshooting\n\n### Prerequisites\n\n- [Claude Code CLI](https://code.claude.com) must be installed.\n\n### Common Issues\n\n**1. The plugin is not loading**\n\nRun the built-in validate command to check for errors:\n\n```shell\nclaude plugin validate .\nclaude plugin list\n```\n\n**2. The skill is not available**\n\nIf you don't see `/architecture-mapper:map` when typing `/help`:\n- Make sure you have restarted Claude Code after installation.\n- Confirm the plugin installed successfully: `claude plugin list`\n\n**3. `~/.claude/` not found**\n\nThe skill handles this gracefully — it skips the global scope scan and notes \"Global scope unavailable\" in the Ecosystem Health table. Only the project scope is scanned.\n\n## Contributing\n\nWe welcome community improvements!\n\n1. Clone this repository to your local machine.\n2. Add the marketplace locally: `claude plugin marketplace add .`\n3. Install the local plugin: `claude plugin install architecture-mapper@claude-architecture-mapper`\n4. Run the skill to establish a baseline: `/architecture-mapper:map`\n5. Submit a PR with a description of your changes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fordinary9843%2Fclaude-architecture-mapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fordinary9843%2Fclaude-architecture-mapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fordinary9843%2Fclaude-architecture-mapper/lists"}