architecture-mapper

Map codebases into cross-linked Markdown architecture knowledge bases with file-level citations.

1|Updated May 18, 2026
One-click install
npx skills add https://github.com/linenoize/topia --skill architecture-mapper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-mapper
Source: https://github.com/linenoize/topia/tree/main/skills/architecture-mapper
Command: npx skills add https://github.com/linenoize/topia --skill architecture-mapper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill turns an unfamiliar or legacy repository into a trustworthy architecture knowledge base so engineers can understand how the system boots, moves data, and connects to external services without guessing.

Core Features & Use Cases

  • Repository mapping: reverse-engineer modules, entry points, requests, entities, jobs, and integrations from source evidence.
  • Cross-linked documentation: generate Markdown artifacts with stable anchors, backlinks, and clickable diagrams for easy navigation.
  • Evidence-first analysis: label findings as confirmed, likely, or speculative and keep claims grounded in file-level citations.
  • Use cases: onboarding to a large codebase, refreshing stale architecture docs after changes, and tracing an end-to-end flow for debugging or planning.

Quick Start

Ask the skill to map the repository architecture into linked documentation with evidence, confidence labels, and a drillable system flowchart.

Frequently Asked Questions about architecture-mapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document legacy codebase architecture and data flow from source evidence?

To document legacy codebase architecture, you map unfamiliar repositories into a cross-linked knowledge base by reverse engineering module boundaries, boot paths, and data flows. This process generates Markdown artifacts with file-level citations, confidence labels, and clickable diagrams.

What is the best way to reverse engineer module boundaries in a polyrepo system?

Reverse engineering module boundaries in a polyrepo system involves read-only analysis of application code to extract entry points, entities, jobs, and external integrations. It yields cross-linked documentation with stable anchors and backlinks for easy navigation.

How to generate cross-linked architecture documentation with confidence labels?

Generating cross-linked architecture documentation with confidence labels requires applying evidence-first analysis to source code. Findings are categorized as confirmed, likely, or speculative, ensuring all architectural claims remain grounded in file-level citations.

Can I trace end-to-end data flow for debugging without modifying the codebase?

Yes, you can trace end-to-end data flow for debugging without modifying the codebase through disciplined read-only analysis. This mapping process identifies how the system boots and moves data, outputting drillable system flowcharts for planning or debugging.

How do I refresh stale architecture docs after recent codebase changes?

Refreshing stale architecture docs after codebase changes involves remapping the updated source code to produce new Markdown artifacts. This post-change analysis captures current module boundaries and external integrations, replacing outdated documentation with evidence-backed maps.