ultrapilot_skill

Overview

This skill runs a parallel autopilot that spawns multiple workers and partitions file ownership to speed up large code tasks. It decomposes a request into independent subtasks, assigns exclusive file sets to workers, executes them concurrently, then integrates and validates the combined result. The coordinator handles shared files and conflict resolution with configurable policies.

How this skill works

Ultrapilot first analyzes whether a task is parallelizable and performs AI-powered decomposition into subtasks with clear file boundaries. It writes an ownership map so each worker can only change its assigned files, spawns up to the configured number of parallel workers, collects their outputs, applies sequential integration for shared files, and runs full-system validation. State, progress, and ownership maps are persisted so runs can be cancelled and resumed.

When to use it

• Large multi-component features (frontend, backend, DB, docs) where modules are separable
• Wide refactors across service boundaries with minimal file overlap
• Generating parallel test suites or test files across modules
• Multi-service or microservice changes that can be split into independent workers
• When you need faster throughput than a sequential autopilot for clearly partitionable work

Best practices

• Design clear module and directory boundaries before running ultrapilot
• Minimize shared state and configuration changes to reduce integration friction
• Review the decomposition result and sharedFiles list before execution
• Enable verbose progress for long runs and monitor the progress JSON
• Use coordinator-handles policy unless you prefer manual merging on conflict

Example use cases

• Build a full-stack todo app: spawn workers for frontend, backend, DB, tests, docs
• Refactor services to dependency injection: assign each service to a separate worker
• Generate tests for all untested modules in parallel across API, UI, DB, utilities
• Parallelize a multi-repo or multi-package migration with ownership per package
• Speed up large feature additions that touch distinct code areas