architecture-discovery

Analyze project architecture and generate a technical spec and CLAUDE.md contract.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/lyraarteltda/MEGA-BRAIN-JARVIS-v2 --skill architecture-discovery-lyraarteltda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-discovery
Source: https://github.com/lyraarteltda/MEGA-BRAIN-JARVIS-v2/tree/main/.fnd/skills/architecture-discovery
Command: npx skills add https://github.com/lyraarteltda/MEGA-BRAIN-JARVIS-v2 --skill architecture-discovery-lyraarteltda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the analysis and documentation of your project's architecture, generating a token-efficient technical specification and architecture contract.

Core Features & Use Cases

  • Automated Discovery: Scans your codebase to identify stack, patterns, layers, and dependencies.
  • Token-Efficient Documentation: Generates concise summaries for AI consumption in CLAUDE.md.
  • Architecture Contract: Defines clear dependency rules and component placement.
  • Use Case: After a new developer joins, run this Skill to quickly generate an up-to-date overview of the project's architecture, helping them understand the codebase structure and dependencies.

Quick Start

Run the architecture discovery script to analyze the current project structure and update CLAUDE.md.

Frequently Asked Questions about architecture-discovery

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

FAQPage Schema
How do I automatically document project architecture and dependencies for an AI context?

To document project architecture automatically, this Skill scans your codebase to identify stack, patterns, layers, and dependencies, generating a token-efficient technical spec and architecture contract in CLAUDE.md.

Can I generate a technical spec for a monorepo with multiple inter-package dependencies?

Yes, you can generate a technical spec for a monorepo because the architecture discovery supports both monorepos and single-app projects by identifying layers, packages, and inter-package dependencies.

How do I create an architecture contract that defines dependency rules for my codebase?

You create an architecture contract by running the discovery script, which analyzes your codebase structure and outputs clear dependency rules and component placement directly into CLAUDE.md.

Does the architecture discovery script require specific environments to analyze code?

The architecture discovery script requires a bash environment to execute its analysis, scanning your project structure to identify the stack and generate the technical specification.

What is the best way to onboard new developers to understand an existing codebase structure?

The best way to onboard new developers is to run this Skill, which generates an up-to-date overview of the project's architecture, helping them quickly understand the codebase structure and dependencies.

Why should I use automated dependency analysis instead of manually writing technical documentation?

Automated dependency analysis eliminates manual effort by discovering your stack and patterns directly from the codebase, ensuring your technical spec remains token-efficient, accurate, and up-to-date.