skills.rest
brabos-ai
brabos-aiOFFICIAL
Explore all skills by this author →
GitHub

add-architecture-discovery

Analyze project codebases to generate technical specs and architecture contracts in CLAUDE.md.

8|2|Updated Mar 2, 2026
Search Tags:#architecture#code analysis#documentation#dependency analysis#monorepo#technical spec
One-click install
npx skills add https://github.com/brabos-ai/code-addiction --skill add-architecture-discovery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-architecture-discovery
Source: https://github.com/brabos-ai/code-addiction/tree/main/framwork/.codeadd/skills/add-architecture-discovery
Command: npx skills add https://github.com/brabos-ai/code-addiction --skill add-architecture-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (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 directly within your CLAUDE.md file.

Core Features & Use Cases

  • Automated Discovery: Scans your codebase to identify stack, patterns, dependencies, and structure.
  • Architecture Contract Generation: Defines layers, packages, and import rules.
  • Technical Spec Generation: Creates a concise, AI-consumable overview of your project's architecture.
  • Use Case: When onboarding a new developer or preparing for a major refactor, use this Skill to quickly generate an up-to-date architectural overview, ensuring everyone understands the project's structure and dependencies.

Quick Start

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

Frequently Asked Questions about add-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?▼

To automatically document project architecture, this Skill analyzes your codebase to identify the stack, patterns, and dependencies, then generates a token-efficient Technical Spec and Architecture Contract directly in CLAUDE.md.

What is an architecture contract and how does it define import rules?▼

An architecture contract defines your project's layer hierarchy, packages, and import rules. This Skill generates it by scanning the codebase to document existing structures rather than imposing new architectural patterns.

Can I generate a technical spec for a monorepo codebase?▼

Yes, you can generate a technical spec for a monorepo. The Skill scans the codebase structure to identify dependencies and architectural patterns, creating a concise, AI-consumable overview suitable for monorepos.

How do I prepare for a major codebase refactor using architecture analysis?▼

To prepare for a major refactor, run the architecture discovery analysis to generate an up-to-date architectural overview. This ensures you understand existing structures, layer hierarchies, and dependencies before making changes.

Does the architecture discovery tool work with existing CLAUDE.md files?▼

Yes, it works with existing CLAUDE.md files by adding a token-efficient Technical Spec and Architecture Contract section. It prioritizes documenting your current structures over imposing new ones.

Related Skills

Explore More Software Engineering Skills→
kok1eeekok1eee
6

install

Initialize o-m-cc project files and agents after official setup.

Community
Intermediate
Kgan01Kgan01
6

code-intelligence

Analyze codebases to reveal architecture, dependencies, and structural patterns.

Community
Advanced
Siamese001Siamese001

layer-boundary-guard

Analyzes AST dependency graphs to enforce import gravity rules across agentic_core and application layers.

Community
Advanced
drhazemibclcdrhazemibclc

create-tech-stack

Analyze a codebase to generate a tech-stack document with dependencies and configurations.

Community
Advanced