claude-md-architect

Generate CLAUDE.md guidance by analyzing a codebase and applying Anthropic best practices.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/brixtonpham/claude-config --skill claude-md-architect-brixtonpham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-md-architect
Source: https://github.com/brixtonpham/claude-config/tree/main/skills/claude-md-architect
Command: npx skills add https://github.com/brixtonpham/claude-config --skill claude-md-architect-brixtonpham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md files for software projects are often verbose and misaligned with actual codebase patterns. This skill analyzes a project and generates concise, actionable CLAUDE.md guidance that improves clarity, consistency, and token efficiency.

Core Features & Use Cases

  • Initialize new CLAUDE.md tailored to the project's context and stack.
  • Optimize existing CLAUDE.md by removing redundancy and enabling on-demand context loading.
  • Integrate with global CLAUDE tooling and MCP patterns to ensure consistency across projects.
  • Use cases include monorepos, multi-language stacks, and evolving codebases.

Quick Start

Create a minimal CLAUDE.md for this codebase to establish project-specific guidance.

Frequently Asked Questions about claude-md-architect

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

FAQPage Schema
How do I create a CLAUDE.md file for my codebase?

To create a CLAUDE.md file, analyze your project's context and stack to generate concise, actionable guidance aligned with actual codebase patterns. This initializes project-specific instructions enforcing token efficiency and on-demand context loading.

What is on-demand context loading in CLAUDE.md?

On-demand context loading in CLAUDE.md is a mechanism that optimizes files by removing redundancy and loading project instructions only when needed. This maintains clarity while significantly improving token efficiency across evolving codebases.

Can I use CLAUDE.md optimization for monorepos and multi-language stacks?

Yes, CLAUDE.md optimization supports monorepos and multi-language stacks. It analyzes these complex, evolving codebases to generate concise structure and clear sectioning, ensuring consistent deployment and context alignment across diverse project components.

Does CLAUDE.md guidance work with MCP tooling?

Yes, CLAUDE.md guidance works with MCP tooling by ensuring compatibility during project-specific instruction generation. This integration enforces consistent deployment and token efficiency across global CLAUDE tooling and MCP patterns within the codebase.

Why are my project instructions consuming too many tokens?

Project instructions consume too many tokens when CLAUDE.md files are verbose and misaligned with actual codebase patterns. Applying concise structure, clear sectioning, and on-demand context loading removes redundancy and enforces token efficiency to resolve this.

What is the best way to structure project instructions for evolving codebases?

The best way to structure project instructions for evolving codebases is to generate concise CLAUDE.md files with clear sectioning and on-demand context loading. This ensures instructions remain aligned with codebase patterns and compatible with global tooling as the project scales.