3-identifying-architecture

Detect architectural domains from file structure and naming conventions.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/bitovi/context-generation-mvp --skill 3-identifying-architecture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 3-identifying-architecture
Source: https://github.com/bitovi/context-generation-mvp/tree/main/.claude/skills/3-identifying-architecture
Command: npx skills add https://github.com/bitovi/context-generation-mvp --skill 3-identifying-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly identify and map the architectural domains present in a codebase, enabling targeted refactors and better onboarding.

Core Features & Use Cases

  • Domain discovery: Detects layers such as ui, routing, data, services, and infrastructure from file structure, naming, and config patterns.
  • Evidence-based mapping: Produces a JSON file like 3-architectural-domains.json that enumerates detected domains and notable patterns.
  • Use Case: Given a monorepo with multiple packages, generate a domain map that guides architecture reviews and documentation.

Quick Start

Run the skill on a repository and review the generated 3-architectural-domains.json to understand the system's architecture.

Frequently Asked Questions about 3-identifying-architecture

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

FAQPage Schema
How do I identify architectural domains in a codebase?▼

You identify architectural domains by examining structural patterns, file structures, naming conventions, and configurations to produce a JSON map detailing detected domains and their guiding patterns.

What are architectural domains and why do I need to map them?▼

Architectural domains are structural layers in a codebase such as UI, routing, data, services, and infrastructure. Mapping them enables targeted refactors and improves onboarding for engineering teams.

Can I detect architecture patterns in a monorepo with multiple packages?▼

Yes, you can detect architecture patterns in a monorepo with multiple packages. The analysis examines multi-layered structures to generate a domain map that guides architecture reviews and documentation.

What's the best way to document codebase architecture for new developers?▼

The best way to document codebase architecture is to generate an evidence-based JSON file enumerating detected domains and notable patterns, providing new developers a clear map for onboarding and architecture reviews.

What does an architectural domain analysis output look like?▼

An architectural domain analysis outputs a JSON file, such as 3-architectural-domains.json, that enumerates detected domains alongside their notable structural patterns and conventions found in the repository.