architecture-map

Generate PROJECT_ARCHITECTURE.md documenting codebase structure, dependencies, and data flows.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/arielsand/my-opencode-skills --skill architecture-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-map
Source: https://github.com/arielsand/my-opencode-skills/tree/main/architecture-map
Command: npx skills add https://github.com/arielsand/my-opencode-skills --skill architecture-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a comprehensive, navigable architecture map for codebases to speed up onboarding, context sharing, and architecture reviews.

Core Features & Use Cases

  • Automatically analyzes project structure, dependencies, and data flows to produce PROJECT_ARCHITECTURE.md.
  • Updates AGENTS.md to reference the architecture map, ensuring AI agents use it as primary context.
  • Supports frontend, backend, and deployment perspectives for end-to-end documentation.

Quick Start

Ask the skill to map the architecture of the current project.

Frequently Asked Questions about architecture-map

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

FAQPage Schema
How do I generate a codebase architecture map for AI context and onboarding?

To generate an architecture map, analyze configuration files, directory structure, dependencies, and data flows to create a structured PROJECT_ARCHITECTURE.md document suitable for both humans and AI agents.

What's the best way to document project architecture for AI agents?

Documenting project architecture for AI agents involves creating a structured map of dependencies and integration points, then updating AGENTS.md to reference the architecture map so agents use it as primary context.

How does mapping codebase data flows and integration points work for new developer onboarding?

Mapping codebase data flows works by analyzing frontend, backend, and deployment perspectives to produce a navigable architecture document, which speeds up context sharing and onboarding for new developers.

Can I automatically document frontend, backend, and deployment perspectives in a single architecture file?

Yes, you can automatically document these perspectives by analyzing the project structure and outputting a readable, comprehensive architecture map under 500 lines in a single PROJECT_ARCHITECTURE.md file.

Does generating a project architecture document require external dependencies?

No, generating a project architecture document does not require external dependencies, as the mapping process directly analyzes your existing configuration files and directory structure to produce the output.

What should a PROJECT_ARCHITECTURE.md file include for effective architecture reviews?

A PROJECT_ARCHITECTURE.md file for architecture reviews should include a structured map of the directory structure, dependencies, data flows, and integration points to ensure comprehensive codebase navigability.