Initial commit

skills/working-in-monorepos/README.md

@@ -0,0 +1,50 @@
+# 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