repo-architecture-review

Identify architectural boundaries, drift, and governance in CodeBuddy repositories.

4|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/danielbaustin/agent-design-language --skill repo-architecture-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-architecture-review
Source: https://github.com/danielbaustin/agent-design-language/tree/main/adl/tools/skills/repo-architecture-review
Command: npx skills add https://github.com/danielbaustin/agent-design-language --skill repo-architecture-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides a findings-first, source-grounded architectural review of CodeBuddy-style repositories or packet slices, helping teams identify boundaries, layering, drift, and governance without editing code or making merge decisions.

Core Features & Use Cases

  • Source-grounded architectural review focused on boundaries, layering, coupling, state ownership, and drift.
  • Deterministic scaffolding of review artifacts with handoffs to diagram-author, adr-curator, and architecture-fitness-function-author roles.
  • Works with CodeBuddy review packets and bounded repository slices, producing structured findings and an architecture map.

Quick Start

Provide a CodeBuddy packet or repository slice and run the architecture review scaffold to generate a findings-first artifact.

Frequently Asked Questions about repo-architecture-review

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

FAQPage Schema
How do I review architectural boundaries and drift in a repository?

Architectural drift analysis identifies structural degradation by surfacing modules, runtime boundaries, and state ownership. This skill performs a source-grounded review of bounded repository slices, producing a structured findings artifact that documents layering, coupling, and governance without editing code.

How do I document architectural governance without modifying source code?

Document architectural governance by running a findings-first review scaffold on a repository packet. This generates a structured architecture map and review artifact detailing boundaries and drift surfaces, ensuring no code is edited or merge decisions are made during the analysis.

Can I use this to analyze a bounded repository slice instead of the full codebase?

Yes, you can analyze a bounded repository slice instead of the full codebase. The skill is designed to work with CodeBuddy review packets and bounded slices, allowing you to surface architectural boundaries and drift surfaces for specific sections of your project.

What is the best way to map runtime boundaries and state ownership in a codebase?

The best way to map runtime boundaries and state ownership is by applying a deterministic architectural review scaffold. This produces an architecture map that explicitly details module coupling, state ownership, and drift surfaces within your repository slice.

Does the architectural review output handoff candidates for downstream documentation?

Yes, the architectural review output includes handoff candidates for downstream documentation. The structured artifact identifies diagram-author, adr-curator, and architecture-fitness-function-author roles to facilitate subsequent documentation and governance tasks.