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.