architecture-review

Generate architecture review documents for codebase structure and data flows.

41|4|Updated May 6, 2026
One-click install
npx skills add https://github.com/markerikson/opencode-config-example --skill architecture-review-markerikson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/markerikson/opencode-config-example/tree/main/config/skill/architecture-review
Command: npx skills add https://github.com/markerikson/opencode-config-example --skill architecture-review-markerikson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture reviews help you quickly understand an unfamiliar codebase by producing clear, durable documentation of its structure, major subsystems, and how data flows through it.

Core Features & Use Cases

  • Architecture audit documentation: Capture the codebase’s purpose, key systems, and responsibilities in a consistent format that stakeholders can read and reuse.
  • Onboarding and knowledge transfer: Turn hard-to-navigate projects into an explorable reference for engineers who need to ramp up quickly.
  • Refactor preparation: Establish a baseline understanding of patterns, integration points, and build/deploy mechanics before undertaking larger changes.

Quick Start

Ask the AI to generate an architecture review document for your target repository area, following the required template and recommended sections.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I document an existing codebase's architecture for onboarding?

An architecture audit documents a codebase's purpose, key systems, and responsibilities in a consistent format. It serves as a durable reference for stakeholders to understand major subsystems and data flows during technical reviews and knowledge transfer.

How do I prepare for refactoring an unfamiliar codebase?

To prepare for refactoring an unfamiliar codebase, generate an architecture review to establish a baseline understanding of patterns, integration points, and build mechanics. This documents build and deploy mechanics before you undertake larger structural changes.

What is the best way to map dependencies and data flow for a technical audit?

The best way to map dependencies and data flow for a technical audit is generating an architecture review document. It captures how major systems work and traces data and config flows across core subsystems for consistent team reference.

Can I use architecture reviews to navigate hard-to-navigate projects?

Yes, you can use architecture reviews to navigate hard-to-navigate projects by turning them into explorable references. The generated documentation clarifies the directory structure and major systems, enabling engineers to quickly understand the codebase.

Does the generated architecture documentation follow a specific naming convention?

Yes, the generated architecture documentation follows a specific naming convention and prescribed template sections. It produces documents directly in the dev-plans repository under the architecture folder to ensure structural consistency across reviews.