Bootstrap Polyglot Monorepo

This skill redirects to the canonical reference in mise-tasks.

→ See: mise-tasks/references/bootstrap-monorepo.md

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

When to Use This Skill

Use this skill when:

• Starting a new polyglot monorepo from scratch
• Setting up Python + Rust + Bun/TypeScript project structure
• Need autonomous 9-phase bootstrap workflow (includes release setup)
• Want Pants + mise integration for affected detection

Stack

Tool	Responsibility
mise	Runtime versions (Python, Node, Rust) + environment variables
Pants	Build orchestration + native affected detection + dependency inference

Quick Commands

# After bootstrap, use these Pants commands:
pants --changed-since=origin/main test    # Test affected
pants --changed-since=origin/main lint    # Lint affected
pants tailor                               # Generate BUILD files
pants list ::                              # List all targets

Related Skills

• itp:mise-tasks - Task orchestration and affected detection (Level 11)
• itp:mise-configuration - Environment and tool version management
• itp:semantic-release - Release automation (Phase 8 reference)

---

Troubleshooting

Issue	Cause	Solution
Pants not found	Not installed	Install via brew install pantsbuild/tap/pants
mise not loading	Shell hook not configured	Configure mise shell hook in ~/.zshrc
BUILD files not generated	Missing pants tailor	Run pants tailor to generate BUILD files
Affected detection empty	No base branch set	Ensure origin/main exists and is up to date
Python version mismatch	mise vs Pants conflict	Align Python version in mise.toml and pants.toml
Rust targets not found	Pants Rust backend missing	Enable Rust backend in pants.toml
Node/Bun not detected	Not in mise tools	Add to mise.toml: node = "latest" or bun
Dependency inference fails	Missing imports in source	Ensure explicit imports, run pants tailor again

Post-Execution Reflection

After this skill completes, check before closing:

1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.