map-project-monorepo

Generate and update per-package CLAUDE.md files in a monorepo.

5|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/namanchopra/branchwater --skill map-project-monorepo-namanchopra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-project-monorepo
Source: https://github.com/namanchopra/branchwater/tree/main/.claude/skills/map-project-monorepo
Command: npx skills add https://github.com/namanchopra/branchwater --skill map-project-monorepo-namanchopra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps manage and maintain the Claude Code context map in a monorepo by generating and updating per-package CLAUDE.md files, ensuring that Claude has comprehensive, up-to-date documentation for each package.

Core Features & Use Cases

  • Per-Package CLAUDE.md Generation: Automatically generates detailed CLAUDE.md files for each package in the monorepo, including exports, key files, dependencies, and conventions.
  • Root CLAUDE.md Simplification: Simplifies the root CLAUDE.md file by pushing per-package details down, keeping the root file lean.
  • Discovery Process: Mandates a thorough discovery process before generating per-package documentation to ensure completeness and accuracy.

Quick Start

Run the skill after a refactor or package addition to update the monorepo's Claude Code context map.

Frequently Asked Questions about map-project-monorepo

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

FAQPage Schema
How do I generate per-package CLAUDE.md files for a monorepo?

To generate per-package CLAUDE.md files for a monorepo, run this skill after a refactor or package addition. It uses Bash scripting to inventory packages, analyze exports, dependencies, and conventions, and output detailed context documentation for Claude Code.

What is a Claude Code context map and when do I need to update it?

A Claude Code context map provides structural understanding of a monorepo via per-package CLAUDE.md files. You need to update it after adding packages or refactoring to ensure Claude has accurate, up-to-date documentation for each package's exports and dependencies.

Does this monorepo documentation skill simplify the root CLAUDE.md file?

Yes, this monorepo documentation skill simplifies the root CLAUDE.md file by pushing detailed per-package information down into individual package files, keeping the root file lean while maintaining comprehensive context mapping for Claude Code.

What is the best way to document monorepo package dependencies for AI coding assistants?

The best way to document monorepo package dependencies for AI coding assistants is using a discovery process that analyzes exports, key files, and conventions, generating detailed per-package CLAUDE.md files that provide accurate context mapping for Claude Code.

Can I use Bash scripting to discover monorepo conventions and exports automatically?

Yes, you can use Bash scripting to discover monorepo conventions and exports automatically. This skill mandates a thorough discovery process using Bash scripts for inventory and analysis before generating accurate per-package CLAUDE.md documentation.

Why does Claude Code lose context when working across multiple monorepo packages?

Claude Code loses context across multiple monorepo packages when detailed information is only in the root file. Generating per-package CLAUDE.md files solves this by providing localized context for exports, dependencies, and conventions directly within each package.