gh-technicalpickles-pickled-claude-plugins-plugins-working-in-monorepos/skills/working-in-monorepos

Working in Monorepos Skill

Purpose

Helps Claude work effectively in monorepo environments by ensuring commands execute from correct locations using absolute paths.

Problem Solved

Claude often loses track of directory context in monorepos, leading to:

• Redundant cd commands (cd ruby && cd ruby)
• Assuming current directory
• Commands executing from wrong locations

Solution

Core rule: Always use absolute paths with explicit cd prefix for every command.

Testing

Skill was developed using TDD methodology:

• RED: Baseline tests document failures without skill
• GREEN: Minimal skill addresses baseline failures
• REFACTOR: Iteratively close loopholes until bulletproof

See tests/ directory for:

• baseline-scenarios.md: Test scenarios
• baseline-results.md: Failures without skill
• green-results.md: Results with skill, iteration notes

Files

• SKILL.md: Main skill document
• examples/: Example .monorepo.json configs
• tests/: TDD test scenarios and results
• scripts/monorepo-init: Init script for config generation

Usage

The skill activates automatically when working in monorepos. It will:

1. Check for .monorepo.json
2. Offer to run ~/.claude/skills/working-in-monorepos/scripts/monorepo-init if missing
3. Enforce absolute path usage for all commands

Related Tools

• scripts/monorepo-init: Auto-detect subprojects and generate config