Subtask enables Claude Code to create tasks, spawn subagents, and track progress in parallel Git worktrees. Ideal for operations teams managing complex workflows, it allows for safe, concurrent task execution and real-time collaboration between agents. Connects to Git and CLI tools for streamlined automation.
git clone https://github.com/zippoxer/subtask.gitSubtask enables Claude Code to create tasks, spawn subagents, and track progress in parallel Git worktrees. Ideal for operations teams managing complex workflows, it allows for safe, concurrent task execution and real-time collaboration between agents. Connects to Git and CLI tools for streamlined automation.
["Prepare your environment: Ensure Git is installed and you have write permissions to the repository. Install required CLI tools (e.g., `gh` for GitHub CLI if using remote tracking).","Define the parent task: Clearly outline the main objective in [TASK]. Use specific, measurable outcomes (e.g., 'Refactor authentication system to support OAuth2').","Configure parallelism: Set [NUMBER] based on your team's capacity and task complexity. For CPU-bound tasks, use 2-4; for I/O-bound tasks, use 4-8.","Set up tracking: Create a [PROGRESS_FILE_PATH] (e.g., `worktrees/progress-tracker.md`) to log agent assignments, progress, and blockers. Use [WORKTREE_PREFIX] to group related worktrees (e.g., `feature-x`).","Monitor and iterate: Use `git worktree list` to check status. Review the progress file after each agent completes its sub-task. Adjust agent focus areas as needed.","Clean up: After all sub-tasks are complete, run `git worktree prune` to remove stale references. Verify all changes are merged to the main branch before cleanup."]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/zippoxer/subtaskCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Use the `subtask` skill to break down [TASK] into [NUMBER] parallel sub-tasks. For each sub-task, create a dedicated Git worktree named [WORKTREE_PREFIX]-[SUBTASK_NAME]. Track progress in a shared markdown file at [PROGRESS_FILE_PATH]. Assign each sub-task to a separate agent with a specific focus: [AGENT_FOCUS_AREAS]. Ensure all worktrees are cleaned up after completion.
### Subtask Execution Report **Parent Task:** Refactor legacy authentication system for Acme Corp **Worktrees Created:** 1. `auth-refactor-database` - Focus: Migrate user data schema from MongoDB to PostgreSQL - **Agent:** db-migrator-01 - **Progress:** 65% (Schema migration complete, indexes pending) - **Output:** `worktrees/auth-refactor-database/logs/migration.log` 2. `auth-refactor-api` - Focus: Update REST endpoints to use new auth service - **Agent:** api-updater-02 - **Progress:** 40% (Endpoints updated, integration tests failing) - **Output:** `worktrees/auth-refactor-api/logs/endpoint_errors.json` 3. `auth-refactor-ui` - Focus: Rebuild login flow with new auth service - **Agent:** ui-rebuilder-03 - **Progress:** 80% (UI components updated, awaiting API stabilization) - **Output:** `worktrees/auth-refactor-ui/logs/ui_changes.md` **Shared Progress File:** `worktrees/auth-refactor-progress.md` - Last updated: 2023-11-15 14:30 UTC - Blockers: API endpoints need schema validation fixes - Dependencies: UI work paused until API stabilizes **Cleanup Status:** All worktrees remain active. Scheduled for deletion on 2023-11-18 after final review.
AI assistant built for thoughtful, nuanced conversation
Metagenomic analysis for microbiome research
Cloud ETL platform for non-technical data integration
Get more done every day with Microsoft Teams – powered by AI
Customer feedback management made simple
Enterprise workflow automation and service management platform
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan