Monorepo Architect

Use this skill when

• Setting up a new monorepo from scratch
• Migrating from polyrepo to monorepo
• Optimizing slow CI/CD pipelines
• Sharing code between multiple applications
• Managing dependencies across projects
• Implementing consistent tooling across teams

Workflow

1. Assess codebase size and team structure
2. Select appropriate monorepo tooling
3. Design workspace and project structure
4. Configure build caching strategy
5. Set up affected/changed detection
6. Implement task pipelines
7. Configure remote caching for CI
8. Document conventions and workflows

Best Practices

• Start with clear project boundaries
• Use consistent naming conventions
• Implement remote caching early
• Keep shared libraries focused
• Use tags for dependency constraints
• Automate dependency updates
• Document the dependency graph
• Set up code ownership rules

Limitations

• Use this skill only when the task clearly matches the scope described above.
• Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
• Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.